Skip Headers

Oracle® Communication and Mobility Server Installation Guide Release 10.1.3 for Solaris Operating System (SPARC 64-Bit) Part Number E10397-03 |
Home | Contents | Index | Contact Us

Previous | Next
| View PDF

# 5 Performing OCMS Upgrades

This chapter describes procedures to upgrade OCMS Release 10.1.3.2 to OCMS Release 10.1.3.3, including OCMS TimesTen and configuration data migration. It contains the following sections:

- Upgrading OCMS Release 10.1.3.2 to OCMS Release 10.1.3.3

- Backing Up OCMS Release 10.1.3.2 Data

- Restoring OCMS Data

- OCMS Upgrade Tool Usage Notes

## Upgrading OCMS Release 10.1.3.2 to OCMS Release 10.1.3.3

Upgrading a Release 10.1.3.2 deployment of OCMS to Release 10.1.3.3 involves migrating all OCMS user and configuration data.

Prior to uninstalling the 10.1.3.2 deployment of OCMS, all OCMS TimesTen data and configuration data should be backed up by following the steps in Backing Up OCMS Release 10.1.3.2 Data.

Restore OCMS TimesTen data and configuration data by following the steps in Restoring OCMS Data.

## Backing Up OCMS Release 10.1.3.2 Data

This section describes the script to back up the OCMS Release 10.1.3.2 TimesTen data and configuration data. Before running the script make sure that OCMS and the TimesTen daemon are running. Otherwise, necessary data will not be backed up.

Enter the following command to back up the OCMS Release 10.1.3.2 TimesTen data and configuration data:

    perl ocms_upgrade_10132_10133.pl -backup ${BACKUP_DIRECTORY}
    ${ORACLE_HOME_10.1.3.2} [${TT_HOME}]

Note:

The `$TT_HOME` argument is optional. If not specified, no TimesTen data will be backed up.

After backing up the OCMS data, the 10.1.3.2 deployment of OCMS should be uninstalled using the standard OCMS uninstaller. Before running the uninstall script, (uninstaller.bin from $ORACLE_HOME/_uninst) OCMS and TimesTen must be shutdown. Once you have completed uninstalling OCMS, install OCMS Release 10.1.3.3 through the standard InstallShield Wizard.

## Restoring OCMS Data

Ensure that OCMS and TimesTen are running and enter the following command to restore the OCMS TimesTen and configuration data backed up from the prior 10.1.3.2 OCMS deployment to the 10.1.3.3 OCMS deployment:

    perl ocms_upgrade_10132_10133.pl -restore ${BACKUP_DIRECTORY}
    ${ORACLE_HOME_10.1.3.3} [${TT_HOME}]

Once run, the script controls the starting and stopping of OCMS during the restore process.

Note:

The `$TT_HOME` argument is optional. If not specified, no TimesTen data will be restored. To be able to restore TimesTen data, the OCMS 10.1.3.2 deployment must first have been backed up to include TimesTen data as explained in the subsection "Backing Up OCMS Release 10.1.3.2 Data".

## OCMS Upgrade Tool Usage Notes

The OCMS upgrade tool can back up and restores all common OCMS configurations persisted in the `${ORACLE_HOME}/sdp/conf` folder and exposed via JMX. Examples of such configuration data include SIP ports, SIP realms/domains, route loader configurations, etc. It can also backup and restore the edge proxy configuration (if applicable), persisted in `${ORACLE_HOME}/sdp/edgeproxy/conf`.

Note:

The tool does not support backup or restoration of OCMS application-specific configurations. In particular, it does not support custom modifications to deployment descriptions (for example, orion-application.xml, web.xml, or sip.xml). If required, application-specific configuration changes can be made manually on a case-by-case basis once the restoration process has been completed.

The upgrade tool is also not intended to backup or restore configuration specific to an OC4J or Oracle Application Server deployment, including HTTP ports or administrator passwords. In addition, the upgrade tool does not support upgrades of OCMS where the IP address of the SIP container differs between the 10.1.3.2 and 10.1.3.3 deployments. If required, such configuration changes can be made manually once the restoration process has been completed.

Finally, the upgrade tool does not support the explicit backup and restoration of presence XCAP data. Typically, such data is persisted by the XCAP service to a folder residing outside of ORACLE_HOME. In such scenarios, uninstalling 10.1.3.2 does not remove any such data. The XCAPConfigManager configuration (containing the location of the XCAP persistence root) is also backed up. This data is restored after upgrading to 10.1.3.3. As a result, it is not necessary to explicitly back up presence XCAP data in the typical case.

If the persistence root is set to a location contained within ORACLE_HOME it will be removed by the OCMS installer. In that case, the upgrade tool will not allow the backup operation to proceed, but instead will ask that the XCAP data be moved elsewhere and the XCAP root set to a location not contained within ORACLE_HOME.

### Backup Mode Script Operation

When used in backup mode, the upgrade script performs the following tasks:

- Backs up all configuration files stored under `ORACLE_HOME/sdp/conf`, or `ORACLE_HOME/sdp/edgeproxy/conf/edgeproxy.xml` if the edge proxy component was deployed

- If TimesTen home is provided, backs up the OCMSDB data store by invoking TimesTen's `ttBackup` command.

### Restore Mode Script Operation

When used in restore mode, the upgrade script performs the following tasks, as applicable to the OCMS deployment:

- SIP container-based deployments:

  - Stops OCMS OPMN process

  - Restores backed up Release 10.1.3.2 configuration files to `ORACLE_HOME/sdp/conf` folder to `ORACLE_HOME/sdp/conf`

  - Patches SipServletContainer.xml with Release 10.1.3.3 SIP application names/aliases

  - Patches PresenceConfig.xml with Release 10.1.3.3 transformer factory implementation class (`oracle.xml.jaxp.JXSAXTransformerFactory`)

  - Patches `XCAPConfigManager.xml` with Release 10.1.3.3 OC4J/AS HTTP ports

  - Renames `ORACLE_HOME/sdp/conf/`registrar folder to `ORACLE_HOME/sdp/conf/proxyregistrar`

  - If TimesTen home is provided:

    - Restarts TimesTen daemon process

    - Destroys 10.1.3.3 OCMSDB data store

    - Restores backed up 10.1.3.2 OCMSDB data store

    - Updates the schema_version in the properties table to 10.1.3.3

  - Starts OCMS process

- Edge proxy-based deployments:

  - Stops edge proxy OPMN process

  - Restores backed up 10.1.3.2 edge proxy configuration to `ORACLE_HOME/sdp/edgeproxy/conf/edgeproxy.xml`

  - Starts edge proxy OPMN process