Rational Connector for SAP Solution Manager 4.0.0.1


Upgrading to Rational Connector for SAP Solution Manager 4.0.0.1
You can upgrade the Rational Connector for SAP Solution Manager on a Tomcat Application Server or a WebSphere Application Server.
Upgrading from version 4.0.0.0 on a Tomcat Application Server
Installing the upgrade software- Extract the contents of the 4.0.0.1 download package to a temporary directory and run the launchpad.exe file.
- On the start page of Installation Manager, select IBM Rational Connector for SAP Solution Manager 4.0.0.1 and click Next.
- Accept the License Agreement and click Next.
- Accept the default location to install the package and click Next.
- Accept the default language and click Next.
- No need to change selected features. Click Next.
- Keep the Tomcat Application Server check box selected and click Next.
- On the installation summary page, click Install.
- When the installation is completed, click Finish.
- If you are using Derby, move the Derby database from 4.0.0.0 to 4.0.0.1
cp -R 4.0.0.0_install_dir/server/conf/sapc/Derby/SAPConnectorDB 4.0.0.1_install_dir/server/conf/sapc/Derby
- If you are using DB2, Oracle, or the SQL Server, backup the database.
- Preserve your 4.0.0.0 user registry files.
- If you are using the Tomcat user registry, preserve your 4.0.0.0 tomcat-users.xml and server.xml files
cp 4.0.0.0_install_dir/server/tomcat/conf/tomcat-users.xml 4.0.0.1_install_dir/server/tomcat/conf/tomcat-users.xml
cp 4.0.0.0_install_dir/server/tomcat/conf/server.xml 4.0.0.1_install_dir/server/tomcat/conf/server.xml
- If you are using an LDAP user registry or disabled HTTPS or FORM authentication, preserve your 4.0.0.0 server.xml and web.xml files on the appropriate application servers
cp 4.0.0.0_install_dir/server/tomcat/conf/server.xml 4.0.0.1_install_dir/server/tomcat/conf/server.xml
cp 4.0.0.0_install_dir/server/tomcat/webapps/SAPConnector/WEB-INF/web.xml 4.0.0.1_install_dir/server/tomcat/webapps/SAPConnector/WEB-INF/web.xml
- If you are using the Tomcat user registry, preserve your 4.0.0.0 tomcat-users.xml and server.xml files
cp 4.0.0.0_install_dir/server/conf/sapc/sapconnector.properties 4.0.0.1_install_dir/server/conf/sapc
Upgrading from version 4.0.0.0 on a WebSphere Application Server
Installing the upgrade software- Extract the contents of the 4.0.0.1 download package to a temporary directory and run the launchpad.exe file.
- On the start page of Installation Manager, select IBM Rational Connector for SAP Solution Manager 4.0.0.1 and click Next.
- Accept the License Agreement and click Next.
- Accept the default location to install the package and click Next.
- Accept the default language and click Next.
- No need to change selected features. Click Next.
- Clear the Tomcat Application Server check box selected and click Next.
- On the installation summary page, click Install.
- When the installation is completed, click Finish.
- Back up the WebSphere Application Server profile.
- Open a command prompt and change to the WAS_Install/bin directory.
For example, /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin
- Run the following command:
./backupConfig path to a new compressed file to create back up of profile
For example, ./backupConfig /root/was_backups/clm_301_profile.zip
Note: The backed up profile can be restored if needed by running the ./restoreConfig command.
For example, ./restoreConfig /root/was_backups/clm_301_profile.zip
- Open a command prompt and change to the WAS_Install/bin directory.
- Log on to the WebSphere Application Server Integrated Solutions Console at https://hostname:9043/ibm/console/logon.jsp
- Click Applications > Applications Types > WebSphere enterprise applications.
- Write down the security role mapping for the SAPConnectorAdmin role for the SAPConnector 4.0.0.0 application. You will use this information when you deploy the 4.0.0.1 application.
- Stop and uninstall the following 4.0.0.0 application: SAPConnector.
- Save the changes to the master configuration when prompted.
- From the console, click Servers > Server Types > WebSphere application servers.
- Click the server name to open it. The default server name is server1.
- Under the Server Infrastructure section click Java and Process Management > Process definition.
- Under Additional Properties click Java Virtual Machine.
- Under Additional Properties click Custom properties.
- Click SAPC_HOME and update its value to 4.0.0.1_install_dir/server/conf
For example, /opt/IBM/JazzTeamServer_4.0.0.1/server/conf
- If you are connecting to an Oracle or SQL Server database, ensure that ORACLE_JDBC_DRIVER_FILE or SQLSERVER_JDBC_DRIVER_FILE is pointing to the correct JDBC driver.
- Save the changes to the master configuration when prompted.
Note: For detailed information, see Setting up a WebSphere Application Server.
profile directory/wstemp
For example, /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/wstemp
profile directory/temp
For example, /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp
profile directory/logs
For example, /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs
- If you are using Derby, move the Derby database from 4.0.0.0 to 4.0.0.1
Note: The commands below assume that you are using the Derby database provided with the packaged product. If you have changed your Derby database location, then the commands should be updated to use the new database location.
cp -R 4.0.0.0_install_dir/server/conf/sapc/Derby/SAPConnectorDB 4.0.0.1_install_dir/server/conf/sapc/Derby
- If you are using DB2, Oracle, or the SQL Server, backup the database.
cp 4.0.0.0_install_dir/server/conf/sapc/sapconnector.properties 4.0.0.1_install_dir/server/conf/sapc
- From the console, click Applications > Applications Types > WebSphere enterprise applications.
- Install the SAPConnector.ear file.
- Map the security role SAPConnectorAdmin for the application SAPConnector.