Home

How do I

Soft - is your software and documentation
Asset - is something that must be protected
Management - is what we do
Enterprise - is the capability
Computing - is the power
Services - are what we provide


ClearCase RWP “How do I” covers: (Last updated  28-Oct-08)

Ø  Configuration – nonstandard ports, etc...

Ø  SSL – certificates and, etc

Ø  Socket addresses – usage of

Ø  Problems & Issues – trouble creating view win 2003, Red Hat installs, etc...

 

Table of Contents

ClearCase RWP “How do I” covers: (Last updated  28-Oct-08) 1

Table of Contents. 1

Configuration.. 1

1.       How do I – configure RWP to use nonstandard ports. 1

SSL. 3

2.       How do I - upgrade SSL certificates to IBM SSL format for RWP. 3

Socket  Address. 3

3.       How do I – why only one usage of each socket address (protocol/network address/port) is normally permitted  3

Problems & Issues. 4

4.       How do I – understand the trouble creating views on RWP server hosted on Windows 2003 Server 4

5.       How do I – understand why the Rational Web Platform install fails on Red Hat Linux. 5

Configuration

1.        How do I – configure RWP to use nonstandard ports

In order to change the ports for the Rational 7.0 Web Platform, updates need to be made to the following 2 components:

IBM HTTP SERVER

WAS EXPRESS EMBEDDED


IBM HTTP SERVER

The port information in the following configuration files needs to be changed, where:

Port 80 is the default http protocol
Port 443 is the default secure https protocol:


admin.conf


C:\Program Files\Rational\Common\rwp\IHS
\conf\admin.conf

Listen 0.0.0.0:80

httpd.conf


C:\Program Files\Rational\Common\rwp\IHS
\conf\httpd.conf

Listen 0.0.0.0:80

ssl.conf


C:\Program Files\Rational\Common\rwp\IHS
\conf\ssl.conf

Listen 0.0.0.0:443


WAS EXPRESS EMBEDDED

The port information in the following configuration files needs to be changed, where:

Port 80 is the default http protocol
Port 443 is the default secure https protocol


plugin-cfg.xml

C:\Program Files\Rational\Common\rwp\EmbeddedExpress\profiles\plugin-cfg.xml

<VirtualHostGroup Name=”default_host”>

<VirtualHost Name=”*:80” />
<VirtualHost Name=”*:10080” />
<VirtualHost Name=”*:11080” />
<VirtualHost Name=”*:443” />

</VirtualHostGroup>

virtualhosts.xml (Profile1)

C:\Program Files\Rational\Common\rwp\EmbeddedExpress
\profiles\profile1\config\cells\DefaultNode\virtualhosts.xml

<host:VirtualHost xmi:id=”VirtualHost_1” name=default_host”>

<aliases xmi:id=”HostAlias_1” hostname=”*” port=”10080”/>
<aliases xmi:id=”HostAlias_2” hostname=”*” port=”80”/>
<aliases xmi:id=”HostAlias_3” hostname=”*” port=”10443”/>
<aliases xmi:id=”HostAlias_6” hostname=”*” port=”443”/>

</host:VirtualHost>

<host:VirtualHost xmi:id=”VirtualHost_2” name=admin_host”>

<aliases xmi:id=”HostAlias_4” hostname=”*” port=”10060”/>
<aliases xmi:id=”HostAlias_5” hostname=”*” port=”10043”/>

</host:VirtualHost>


virtualhosts.xml (Profile2)

C:\Program Files\Rational\Common\rwp\EmbeddedExpress
\profiles\profile2\config\cells\DefaultNode\virtualhosts.xml

 

<host:VirtualHost xmi:id=”VirtualHost_1” name=default_host”>

<aliases xmi:id=”HostAlias_1” hostname=”*” port=”11080”/>
<aliases xmi:id=”HostAlias_2” hostname=”*” port=”80”/>
<aliases xmi:id=”HostAlias_3” hostname=”*” port=”11443”/>
<aliases xmi:id=”HostAlias_6” hostname=”*” port=”443”/>

</host:VirtualHost>

<host:VirtualHost xmi:id=”VirtualHost_2” name=admin_host”>

<aliases xmi:id=”HostAlias_4” hostname=”*” port=”11061”/>
<aliases xmi:id=”HostAlias_5” hostname=”*” port=”11044”/>

</host:VirtualHost>

SSL

2.        How do I - upgrade SSL certificates to IBM SSL format for RWP

The IBM® Rational® Web Platform no longer supports Open SSL certificates as of version 7.0. If you are upgrading a product that uses RWP and wish to use previously created Open SSL certificates, you must first convert them to IBM SSL certificates. This technote provides the location of the instructions for each product that uses RWP.

 

Cause

Rational does not ship the openssl executable file. The certificate can be converted using an earlier version of the Open SSL application that shipped with Rational prior to upgrading to 7.0 or a copy of the Open SSL source file can be downloaded from the http://www.openssl.org web site

 

Resolving the problem

The sections below explains where the instructions to convert your Open SSL certificates can be found for the products that use RWP.

Rational ClearQuest:

To convert Open SSL certificates to IBM SSL, follow the instructions documented in the Rational ClearQuest 7.0 Installation and Upgrade Guide in Appendix C (Configuring the Rational Web Platform). The last section is on Converting Open SSL certificates to IBM SSL.


Rational ClearCase:

To convert Open SSL certificates to IBM SSL, follow the instructions documented in the Rational ClearCase 7.0 Administrator's Guide in Appendix E (Configuring the IBM Rational Web Platform). The last section is on Converting Open SSL certificates to IBM SSL.


Rational RequisitePro:

To convert Open SSL certificates to IBM SSL, follow the instructions documented in the Rational RequisitePro 7.0 Installation and Upgrade Guide in Appendix A (Configuring the IBM Rational Web Platform). The last section is on Converting Open SSL certificates to IBM SSL.

Rational ProjectConsole:

To convert Open SSL certificates to IBM SSL, follow the instructions documented in the Rational ProjectConsole 7.0 Installation and Upgrade Guide in Appendix A (Configuring the IBM Rational Web Platform). The last section is on Converting Open SSL certificates to IBM SSL.

Note: Configuring ProjectConsole to use SSL may result in error 1230. Review technote 1253008 for additional information regarding this error.

 

Related information

Unable to import a PKCS12 file
OpenSSL Home Page
Rational ClearCase Information Center
Rational ClearQuest Information Centers

Socket  Address

3.        How do I – why only one usage of each socket address (protocol/network address/port) is normally permitted

Why do attempts to restart the IBM® Rational Web Platform (RWP) server running on Microsoft® Windows® results in the error no listening sockets available, shutting down. and provides instructions to resolve the issue.

 

Cause

Attempts to restart RWP using the utility rwp_restart from the command prompt on a Windows RWP server results in the following error:

(32548) Only one usage of each socket address (protocol/network address/port) is normally permitted. : make_sock: could not bind to address 0.0.0.0:PORT
no listening sockets available, shutting down.


There is another program listening on the port designated for RWP which is causing the service to fail to start.

 

Solution

Determine which program is running on the port listed in the error message by running the following command from the command prompt:

netstat -a

This command will list all active connections on the system.

netstat -b

This command will list which program is using the specific port.

If the program that is currently using the port that is designated for RWP cannot be stopped, you will need to change the rwp.conf file to use a different port number that is free.

Problems & Issues

4.        How do I – understand the trouble creating views on RWP server hosted on Windows 2003 Server

Attempts to create a web view (CCWeb or CCRC) from a client where the server is running the Rational Web Platform hosted on Windows Server 2003 results in the following error:

!   Unable to determine the config spec for view, "administrator_rwp_vu": No such file or directory
ccweb: Error: Unable to create temporary file: Permission denied.
                           [  OK  ]



Windows Server 2003 does not assign ANY permissions to the Everyone group, compared to Windows NT 4.0 and Windows 2000 Servers where the Everyone group was assign Full Control.

 

Solution

The Everyone group may need to be assigned at least write permission to the root of the RWP disk partition (for example if RWP is installed at C:\Program Files\Rational... the root disk partition would be C:\)

The following procedure should be followed to assign at least the write permission to the Everyone group or any group that may want to create a view using an existing view’s config_spec to avoid the error.

1.     Right click on the drive where RWP is installed (by default the C drive)

2.     Click Security

3.     Assign the ‘Everyone’ group at least ‘Write’ permission to the root of the partition

Click OK

5.        How do I – understand why the Rational Web Platform install fails on Red Hat Linux

During the install of the ClearCase on RHEL with the ClearCase Web Server components included (RWP), the install fails with the following errors:

Caused by: java.lang.NullPointerException
at java.lang.ClassLoader.loadLibrary0(ClassLoader.java:2171)
at java.lang.ClassLoader.loadLibrary(ClassLoader.java:2006)
at java.lang.Runtime.loadLibrary0(Runtime.java:824)
at java.lang.System.loadLibrary(System.java:908)
at sun.security.action.LoadLibraryAction.run(LoadLibraryAction.java:76)
at java.security.AccessController.doPrivileged1(Native Method)
at java.security.AccessController.doPrivileged(AccessController.java:287)
at sun.awt.NativeLibLoader.loadLibraries(NativeLibLoader.java:81)
at java.awt.Color.<clinit>(Color.java:280)

The installation log contains the following entry:

IHS installation in progress....; This may take a while.      
ERROR:   /opt/rational/common/rwp/IHS_tmp/IHS/install failed

 

Cause

There are operating system libraries missing or unlinked on the RHEL host that RWP (specifically the IBM HTTP Server (IHS) install) requires to complete the installation.

 

Resolving the problem

For RHEL 4, ensure the library file libXp.so resides in the following directory: /usr/X11R6/lib.

You should see the following:
lrwxrwxrwx   1 root root      12 Feb 28 15:31 libXp.so.6 -> libXp.so.6.2
-rwxr-xr-x   1 root root   27256 Sep 19  2005 libXp.so.6.2

Note: ClearCase looks for libXp.so and not libXp.so.6.

If the file does not exist, then install the library from the optional package xorg-x11-depriciated-libs from the RHEL install media and try the ClearCase installation again.


For RHEL 5, install
libXp library from the install medium.

Example:
rpm -i libXp-1.0.0-8.i386.rpm

 

 

 

This website is published "as is". There is no warranty of any kind (express or implied) as to the operation of our site, the accuracy of the information or the services or products referred to on it. All warranties are excluded as far as permitted at law. Neither we nor any third party will be liable for any losses or damage that may result from use of the website or as a consequence of any inaccuracies in, or any omissions from, the information which it contains.