Overwriting key directories to upgrade Design Management Server

You must overwrite several key directories and files during the Design Management Server upgrade process to update the server properly. You must also run several batch files to update the database.

Before you begin

Before you overwrite key directories and files, and update the database, you must download and extract the upgrade installation media. Then, you use IBM Installation Manager to install the upgrade.

About this task

In the following steps, the prev_DM_dir refers to the root directory of the previously installed Design Management Server installation directory, and cur_DM_dir refers to the root directory of the newly upgraded Design Management Server installation directory. Update all of the following directories and files by copying the previously installed version of Design Management Server artifacts and replacing the artifacts that were installed with newer version of Design Management Server.

Procedure

  1. To update the database files, complete one of the following depending on the database in use:
    • If you are using the default Derby database, copy the repositoryDB directory from prev_DM_dir/server/conf/jts/derby/repositoryDB directory and place it in cur_DM_dir/server/conf/jts/derby/.
    • If you are using Oracle or Microsoft SQL server database, copy the prev_DM_dir/server/oracle or prev_DM_dir/server/sqlserver directory and place it in cur_DM_dir/server.
  2. To update the queries and search indexes (indices directory) and the Jazz Team server configuration file for the database connections (teamserver.properties) complete the following steps:
    1. To update the indices directory, copy the prev_DM_dir/server/conf/jts/indices directory and place it in cur_DM_dir/server/conf/jts/.
    2. To update the teamserver.properties file, copy the prev_DM_dir/server/conf/jts/teamserver.properties file file and place it in cur_DM_dir/server/conf/jts/.
  3. To update the Design Management Server configuration dm.properties file, copy the prev_DM_dir/server/conf/dm/dm.properties file and place it in cur_DM_dir/server/conf/dm/.
  4. To update the Tomcat server users and groups file (tomcat-users.xml) and the server configuration file (server.xml) complete the following steps. If you are not using Tomcat sever you can proceed to step 6.
    1. To update the server.xml file, copy the prev_DM_dir/server/tomcat/conf/server.xml file and place it in cur_DM_dir/server/tomcat/conf/.
    2. To update the tomcat-users.xml file, copy the prev_DM_dir/server/tomcat/conf/tomcat-users.xml file and place it in cur_DM_dir/server/tomcat/conf/.
  5. After you update the files, you must run several batch files to update the database:
    1. Using a command prompt, run the repotools-jts.bat -addTables command from the cur_DM_dir\server directory. On Linux, run ./repotools-jts.sh -addTables.
    2. When you are warned that you are about to update the database, enter Y for yes.
    3. After the -addTables command is complete, run the repotools-jts.bat -createWarehouse from the same directory. On Linux, run ./repotools-jts.sh -createWarehouse.
    Note: Each batch file can take several minutes to complete.

What to do next

If you are using WebSphere® Application Server, proceed to Setting up WebSphere Application Server for the upgrade. Otherwise, proceed to Configuring the upgraded Design Management Server.

Feedback