Configuring and Managing WebLogic SIP Server

Upgrading a WebLogic SIP Server 2.0.x Configuration to Version 2.1

The following sections provide instructions for upgrading WebLogic SIP Server from a previous release:

About the Upgrade Program

The WebLogic SIP Server upgrade program, wlss.UpgradeConfig, takes a sipserver.xml configuration file from a version 2.0.x WebLogic SIP Server release and recreates the configuration in WebLogic SIP Server 2.1 using the latest schemas. For example, connector entries from an earlier sipserver.xml file are converted into network channels in the WebLogic SIP Server 2.1 config.xml file.

In order to use the upgrade program, you must install WebLogic SIP Server 2.1 and create a new WebLogic SIP Server 2.1 domain. The newly domain configuration is then updated to match the earlier configuration using the wlss.UpgradeConfig program.

Steps for Upgrading an Existing Configuration

To upgrade a previous WebLogic SIP Server configuration to a new WebLogic SIP Server 2.1 configuration:

Install the WebLogic SIP Server software 2.1. See Installing WebLogic SIP Server Using Graphical-Mode Installation in Installing WebLogic SIP Server.

Use the Configuration Wizard to create a new Basic WebLogic SIP Server Domain on the Administration Server machine. See Using the Configuration Wizard in Installing WebLogic SIP Server.

Start the Administration Server for the WebLogic SIP Server 2.1 domain.

Set the environment required for using the UpgradeConfig utility. See Required Environment for the UpgradeConfig Utility.

Use the wlss.UpgradeConfig utility to recreate your earlier WebLogic SIP Server configuration on the new WebLogic SIP Server 2.1 domain. See wlss.UpgradeConfig Reference.

Required Environment for the UpgradeConfig Utility

To set up your environment for the UpgradeConfig utility:

Install the WebLogic SIP Server software 2.1. See Installing WebLogic SIP Server Using Graphical-Mode Installation in Installing WebLogic SIP Server.

Move to the top level of the WebLogic SIP Server 2.1 domain directory that you created:

cd BEA_HOME\user_projects\domains\mydomain

In the above command, BEA_HOME refers to the top-level BEA installation directory (for example, c:\bea).

Set the client environment using the command:

setAdminClientEnv.cmd

wlss.UpgradeConfig Reference

The wlss.UpgradeConfig program uses the syntax:

java wlss.UpgradeConfig -username adminuser -password adminpassword -adminurl url -sipserverconfigfile sipserver_old.xml

where:

adminuser is the username of the WebLogic SIP Server 2.1 administrator
adminpassword is the password of the WebLogic SIP Server 2.1 administrator
url is the URL of the WebLogic SIP Server 2.1 Administration Server
sipserver_old.xml is the full path to the sipserver.xml file from the earlier WebLogic SIP Server installation

For example:

java wlss.UpgradeConfig -username weblogic -password weblogic -adminurl t3://localhost:7001 -sipserverconfigfile c:\bea\user_projects\domains\wlss202_domain\sipserver.xml

The upgrade utility modifies the sipserver.xml and config.xml files in the WebLogic SIP Server 2.1 domain as necessary to match the earlier configuration.

Notes: The version 2.1 Administration Server must be running in order to upgrade the configuration.

wlss.UpgradeConfig can only update a WebLogic SIP Server 2.1 configuration from a single version 2.0.x sipserver.xml file. You cannot perform multiple upgrades against the same version 2.1 Administration Server using different sipserver.xml files.