Performing post-upgrade steps

About this task

This section explains in detail some things you might need to do after your upgrade is complete.

Perform these post-upgrade steps:

Procedure

  1. If applicable, Installing Rational Change 5.2
  2. If applicable, read Synergy Distributed transfers after upgrade
  3. Users might have to Updating work areas
  4. Read about Modifying purposes and processes rules
  5. When no longer needed, Disabling 6.4, 6.5, or 7.0 services
  6. When no longer needed, Removing the previous installation
  7. If applicable, Installing Windows clients
  8. s_t_upw_tshoot_post_upgrd_issues_exst_srv.html#wp724858__wp1135056
  9. Making databases available for use
  10. Troubleshooting post-upgrade issues

Installing Rational Change 5.2

About this task

If you use Rational Change with this database, install Rational Change 5.2. Earlier releases of Rational Change are not compatible with Rational Synergy 7.1. For detailed instructions, see the Rational Change Installation Guide for Windows.

You must create or upgrade at least one database before you install Rational Change 5.2, because Rational Change requires access to a Rational Synergy database.

If you use Rational Change, and if you saved a modified copy of the previous ptcli configuration file as described in s_t_upw_upgrade_os_new_srv.html#wp1055510__wp1059670, merge it at this time. The ptcli file is:

Program Files\IBM\Rational\Synergy\7.1\etc\ptcli.cfg

Synergy Distributed transfers after upgrade

About this task

Rational Synergy 7.1 supports DCM transfers to and from releases 6.4 SP1, 6.5 SP2, 6.5a, 6.6a, and 7.0. Patches to these releases are required for DCM compatibility. For additional information, see the Rational Synergy Readme for Release 7.1 and the product README files for patches to the earlier releases.

For complete information about upgrading a DCM database, see "Upgrading Synergy Distributed clusters" on page 85.

Updating work areas

About this task

If you moved the database to a new path (perhaps on a new machine) as part of the upgrade, update existing work areas so that they refer to the new path. This information is true for both copy-based and link-based work areas. Each user of a moved database must run the command to update their working projects:

> ccm wa /dbpath old_database_path

Build managers must also update their prep projects. Also, update shared or static projects, using the appropriate /scope options to the ccm wa /dbpath command.

Modifying purposes and processes rules

About this task

In Release 6.5, process rules replaced the objects previously known as update templates and reconfigure templates. Release 6.5 also introduced the concept of a process, which is a collection of process rules, and renamed some existing purposes. For more information, read the "Updating scripts to work with Synergy 7.1" on page 69, the Rational Synergy Help, and the Build Manager’s Guide.

Upgrading to 7.1 creates or renames the standard purposes. If you have modified any of the standard purposes, your modified copy is renamed, starting with a prefix "Saved".

To modify purposes and processes rules:

Procedure

  1. After the database upgrade has completed, examine any modified purposes and process rules
  2. Adjust them as required by creating one or more processes with your preferred set of process rules.

    Rational Synergy does not replicate processes or process rules from 6.5 to earlier releases, nor does it replicate reconfigure templates or update templates from earlier releases to 7.1. If you used DCM to centrally administer update templates in earlier releases, you must upgrade all databases in the cluster to achieve the same effect with process rules in Release 7.1.

Disabling 6.4, 6.5, or 7.0 services

About this task

The upgrade process stopped and rendered unusable the previous release on the upgraded server.

To disable 6.4, 6.5, or 7.0 services:

Procedure

  1. On the taskbar, click Start > Control Panel > Administrative Tools > Services to display the Services window.
  2. Repeat the following steps for each 6.4, 6.5. 7.0 Rational Synergy service:
    1. Right-click the service entry, and select Properties from the pop-up menu.
    2. In the General tab, change the Startup type to Disabled.

Removing the previous installation

About this task

When you no longer need your old release, use uninstall it if you used the procedure "Upgrade to a New Server" for all databases.

Note: Do not delete the previous Rational Synergy installation directory if you used the procedure "Upgrade an Existing Server" on this machine. If you remove it incorrectly, your upgraded server might be compromised. For more information, contact IBM Rational Software Support. To learn about additional reasons for saving your previous installation, see "Considerations for upgrading to Synergy 7.1" on page 9.

Installing Windows clients

About this task

If needed, install Windows clients for Rational Synergy Release 7.1. You do not need to uninstall clients for previous releases. However, you can do so if there is no need to access any databases still using the previous release.

For detailed instructions, see the Rational Synergy Installation Guide for Windows.

Testing Web mode Previous examples in this Information Center have started Rational Synergy sessions in Traditional mode. If your site starts Rational Synergy sessions in Web mode, test that with your upgraded database.

To test Web mode:

Procedure

  1. Run the ccm monitor command and check that the appropriate CCM server is running. If it is not, start it using the ccm_server command. Note the server URL shown in the output after running the ccm monitor command.
  2. In your browser, type protocol://server:port/admin, where the protocol (http or https), server and port are in the server URL.
  3. When prompted, type the administrator password.
  4. On the Database tab, check that the database you want to test is listed as connected to this server. If it is shown as connected to a different server, either use the other server, or use the Web page to change the server for the database.
  5. Start a Synergy session using the server URL you have verified:

    cmsynergy /d database_path /s server_url

    Determine whether a Synergy session was started in Web mode or Traditional mode by looking at the lower right corner of the Synergy Work pane.

    You see a message like the following message if the session was started in Traditional mode:

    User sue on database /vol/ccm_docs/ccm_docs using server pacifica

    You see a message like the following message if the session was started in Web mode:

    User sue on database /vol/ccm_docs/ccm_docs using server http://cmserver:8400

Making databases available for use

About this task

After you have completed the upgrade, tested the results, and performed any required post-upgrade actions, your upgrade is complete.

To make the databases available for use:

Procedure

  1. If you protected the databases during the upgrade, test, or post-upgrade process, unprotect them now.
  2. Tell the users that the databases are ready for use.
  3. Upgrade the client software of the users.

Troubleshooting post-upgrade issues

About this task

If you have difficulties with a command or process, or if you receive an error message that you do not understand:

  • See the troubleshooting information, which is located on the IBM Rational Support site.

    These and other documents are available on the Rational Synergy Info Center (http://publib.boulder.ibm.com/infocenter/rsdp/v1r0m0/index.jsp).

  • If you still have questions, contact IBM Rational Software Support.

Feedback