8 Migrating or Upgrading Converged Application Server

This chapter provides instructions for upgrading your Oracle Communications Converged Application Server system.

About Migrating or Upgrading Converged Application Server

Because of architectural changes in the underlying WebLogic Server platform, there is no automated upgrade path. Instead, you must manually upgrade or migrate your Converged Application Server 5.1 or 7.0.0.1.0 system to version 7.1.0.0.0.

High Availability

During your upgrade and migration, you can introduce high availability (HA).

For information about HA environments, see "Failure Prevention and Automatic Recovery Features" in the Converged Application Server Administrator's Guide.

About the Upgrade or Migration Example

The instructions in this chapter assume that you have a replicated Converged Application Server 5.1 system with fives machines, or a 7.0.0.1.0 system with three machines. For example:

One Administration Server (5.1_Admin)
Two engine servers (5.1_engine_1 and 5.1_engine_2)
Two replica servers (5.1_replica_1 and 5.1_replica_2)

Figure 8-1 shows the Converged Application Server 5.1 replicated topology used for the instructions in this chapter.

Figure 8-1 Converged Application Server 5.1 Replicated Topology

The instructions assume that your Converged Application Server 7.1.0.0.0 system contains three machines:

One Administration Server (7.1.0.0.0_Admin)
Two engine servers (7.1.0.0.0_engine_1 and 7.1.0.0.0_engine_2)

Note:

Converged Application Server no longer uses replicas. If you are upgrading from version 5.1 with replicas, you can either repurpose your 5.1_replica_1 and 5.1_replica_2 machines as additional engine servers or decommission them completely.

Figure 8-2 shows the Converged Application Server 7.1.0.0.0 replicated topology used for the instructions in this chapter.

Figure 8-2 Converged Application Server 7.1.0.0.0 Replicated Topology

Description of ''Figure 8-2 Converged Application Server 7.1.0.0.0 Replicated Topology''

Migrating or Upgrading to Converged Application Server 7.1.0.0.0

In this section, the system you are upgrading from is called old (for example, your old system), and the system you are upgrading to is called new (for example, your new system).

To manually upgrade or migrate your Converged Application Server system:

Back up all of your old Converged Application Server domains.
Install Converged Application Server 7.1.0.0.0 on your 7.1.0.0.0_Admin, 7.1.0.0.0_engine_1, and 7.1.0.0.0_engine_2 machines. For information, see "Installing Converged Application Server".
Create your new Converged Application Server domains. See "Creating and Configuring Converged Application Server Domains" for more information.
Copy the WAR or EAR files from your old domains into your new domains.
Verify the domain administration settings on your new Converged Application Server system. See "Verifying Your 7.1.0.0.0 Domain Administration Settings".
Install and deploy your old applications to your new system.
Verify your database connections.
Verify that the applications deployed on your new Converged Application Server system work as expected.

Verifying Your 7.1.0.0.0 Domain Administration Settings

In this section, the system you are upgrading from is called old (for example, your old system), and the system you are upgrading to is called new (for example, your new system).

Start your new Converged Application Server Administration Server.
Log in to your new Converged Application Server Administration Console:
```
http://address:port/console
```
where address is the Administration Server's listen address and port is the listen port.
Verify that your new domain configuration is correct. In particular, pay attention to the following settings:
- SSL is enabled/disabled consistently on every node machine
- All security authentication providers are listed and configured correctly
- Coherence security has been configured
- Work managers are configured correctly
- The application router is configured correctly
- The call state storage and data tier has been configured
For more information about using the Administration Console and configuring settings, see Converged Application Server Administrator's Guide.