SSL Perl API error: "Protocol scheme 'https' is not supported (Crypt::SSLeay not installed)" in IBM Rational Change

Technote (troubleshooting)


Problem(Abstract)

After setting up IBM Rational Change 5.2 or 5.3 to use SSL/https, trying to use the Perl API results in failures, with the error message "Protocol scheme 'https' is not supported (Crypt::SSLeay not installed)".

Symptom

Error message "Protocol scheme 'https' is not supported (Crypt::SSLeay not installed)" when trying to connect to Rational Change using the Perl API, for example with the following Perl command:

$csapi->Login($userId, $passWord, 'Admin', $database)


Cause

Change's ssl relies on openssl, which has to be properly installed, and which location must be known to Change.

Resolving the problem

Ensure you have set up IBM Rational Change 5.2 or 5.3 to use SSL/https following the official instructions found in Technote 1397602.

There is no universal solution to this issue, as it depends how to administrate your Linux/UNIX server. However, pay a particular attention to the following points :

  • Missing OpenSSL:
    SSLeay requires it. Please make sure that you have it.
    You might want to use the following commands :


    perl -MCPAN -e shell

    CPAN> install Crypt::SSLeay

    ... and feed it the parent directory where your openssl files are located.

    Make sure that the permissions on the library file are not restricted.


  • Incomplete/missing environment variables:
    Please check if PERL5LIB and LD_LIBRARY_PATH contain all the required locations (unfortunately, we cannot be more accurate than that, as it depends on your environment).


Rate this page:

(0 users)Average rating

Document information


More support for:

Rational Change
Installation

Software version:

5.2, 5.2.0.1, 5.2.0.2, 5.2.0.3, 5.2.0.4, 5.2.0.5, 5.2.0.6, 5.2.0.7, 5.3, 5.3.0.1, 5.3.0.2, 5.3.0.3

Operating system(s):

AIX, Linux, Solaris

Reference #:

1606015

Modified date:

2012-07-24

Translate my page

Machine Translation

Content navigation