If you are using WebSphere® Application Server for
your server, you must manually uninstall the web applications from
the server and install the new versions.
About this task
When
you installed the Design Management Server,
you deployed the web applications using the WebSphere Application Server administrative
console. This process is described in Deploying the Design Management Server on WebSphere Application Server. To upgrade the Design Management Server,
you must uninstall these applications and install the upgraded versions.
Procedure
- Optional: Back up the server profile by running
the backupConfig command, which is in the folder serverInstallDir/profiles/profileName/bin. For example, you might run the following command on Linux:
./backupConfig /root/was_backups/dm_30_profile.zip
The
following code is the equivalent command on Windows:backupConfig.bat C:\was_backups\dm_30_profile.zip
- Back up your database.
- Log in to the administrative console.
- Uninstall the applications jts.war, dm.war,
and rdmhelp.war by clicking ,
selecting the applications, and clicking Uninstall.
- Save the changes to the master configuration.
- In the custom properties for the Java Virtual Machine (), update the JAZZ_HOME property
so that it points to the conf folder for the
new version of the Design Management Server.
- Update the log4j.configuration property
so that it points to the location of the startup_log4j.properties file.
- If you are using a database other than Derby or DB2, verify
that the property for the database (such as SQLSERVER_JDBC_DRIVER_FILE or ORACLE_JDBC_DRIVER_FILE)
points to the correct JDBC driver file.
- Save the changes to the master configuration.
- Stop WebSphere Application Server.
- Optional: Back up the log files named dm.log and jts.log,
which are at serverInstallDir/profiles/profileName/logs/. You can then delete the existing log files so the new version
of Design Management Server will
start new log files. If you do not back up and remove the files, the
new version of the server appends log messages to the existing log
files.
- Delete the following folders of temporary files:
- serverInstallDir/profiles/profileName/temp/nodeName/serverName/dm_war/
- serverInstallDir/profiles/profileName/temp/nodeName/serverName/jts_war/
- serverInstallDir/profiles/profileName/temp/nodeName/serverName/rdmhelp_war/
- serverInstallDir/profiles/profileName/temp/wscache/dm_war/
- serverInstallDir/profiles/profileName/temp/wscache/jts_war/
- serverInstallDir/profiles/profileName/temp/wscache/rdmhelp_war/
Use the location of the server, the profile name, the node name,
and the server name for serverInstallDir, profileName, nodeName,
and serverName.
- Start the server.
- From the administrative console, install the new versions
of the files jts.war, dm.war,
and rdmhelp.war as you did when you installed
the original version. Use the context roots /dm, /jts,
and /rdmhelp as you did in the original installation.
Also, make sure to save the master configuration after installing
each file. For more information, see Deploying the Design Management Server on WebSphere Application Server.
- Map the security roles for the Jazz™ Team Server application to users and groups in your security realm. Setting up security is beyond the scope of this task, but in
most cases in which your global security realm uses an LDAP registry,
you map groups in the LDAP registry to the following security roles
for the application:
- JazzAdmins
- JazzDWAdmins
- JazzProjectAdmins
- JazzGuests
- JazzUsers
- Click .
- Under Detail Properties, click Security role to user/group mapping. This
page shows the user groups for the Design Management Server that you must map to users or groups in your security
realm.
- Select a role and then click Map Groups to map that role to a group in your security realm.
Note: Do not enable the All authenticated? option.
- Verify that the applications installed
successfully and then save the changes to the master configuration
for WebSphere Application Server.
- In the WebSphere Application Server administrative console, click to confirm all applications are running.
What to do next
Configure the server as described in
Configuring the upgraded Design Management Server.