Cloning a Portal and Wireless Install

Enterprise Manager Cloning allows you to deploy one or more Application Server instances similar in configuration to a source instance.

You can clone a Portal and Wireless Install Application Server Home to the following:

Another Portal and Wireless setup connected to the same farm as the source.
Another Portal and Wireless setup connected to the same farm as the source and to the same cluster the original instance is a part of.

Prerequisites for Cloning

Ensure that the following prerequisites are met before cloning:

You have setup the Grid Control properly to manage the source and target hosts.
You have a valid source Oracle home with read / write privileges. Ensure that OH/config/ias.properties file has read privileges.
If the cloned instance is required to connect to a cluster, ensure that such a cluster already exists in the farm in which that instance is expected to join.
You have a Central Agent (10.2 or above) monitoring all the destination hosts.

Cloning to Another Portal and Wireless setup connected to the same farm as the source

To clone a Portal and Wireless Install to another Portal and Wireless setup connected to the same farm as the source:

Select a Portal and Wireless 10.1.2 home from the list of clonable homes and click Next.
At the Source Settings page, enter the host credentials and the files to be excluded from the Oracle home archive and click Next.
The credentials provided are verified and the ias.properties file is read to check the configuration. The Product Settings page is rendered accordingly, asking for the new instance name, the old and new ias_admin passwords, and the OID admin password. You may also need to specify the cluster to which the new instance should join and click Next.
Provide the destination Oracle home information along with the destination host credentials. Ensure that these credentials are correct as these are not verified here and the job may fail later if these are wrong. Click Next.
Specify the pre/post/root scripts or commands to be executed before/after the cloning operation. The same script will be executed parallely on each destination. You may choose to execute pre/post scripts with sudo privileges, but the host credentials previously specified should have sudo privileges on the destination host for this to succeed. Failure of this step will not affect the overall status of the job. Click Next.

Note: If root.sh is not run through the job, you must run it manually for the cloning operation to complete.

Schedule the job immediately or at an appropriate time. You can also change the name of the job, from the default one that uses the time stamp. Click Next.
Review your selection and and click Finish.

Note: You can also clone a Portal and Wireless Install frontended by a Load-balancer. In this case, it takes an additional parameter -lbr {true|false} which cannot be passed through Enterprise Manager. By default, it takes the value as true.
In case you want to pass -lbr=false, the source instance will stop working after the clone is complete. To pass this, you will need to edit the $ORACLE_HOME\clone\ias\config\cs.properties file at the source to the following:

portal_cmd= -mode MIDTIER -i typical -s portal -host $host_name -port $http_port -ldap_d $oid_admin -ldap_w_enc $oid_pwd -verbose -oh $ORACLE_HOME -chost $host_name -cport_i $wc_invalid -cport_a $wc_admin -mi true -mc FALSE -pwd_enc $ias_admin_pwd -ultrasearch -syndication -emport $em_port -silent

For more information refer to Cloning Application Server Middle-Tier Instances chapter in the Oracle Application Server Administrator's Guide 10g Release 2 (10.1.2) .

Cloning to Another Portal and Wireless setup connected to the same farm as the source and to the same cluster the original instance is a part of

To clone a Portal and Wireless Install to another Portal and Wireless setup connected to the same farm as the source and to the same cluster the original instance is a part of:

Remove the source instance from the OracleAS cluster, by creating a pre script file with the following content and executing it:
- On UNIX:
  
  cd $ORACLE_HOME/dcm/bin ./dcmctl leaveCluster
- On Windows:
  
  cd ORACLE_HOME \dcm\bin dcmctl leaveCluster
Select a Portal and Wireless 10.1.2 home from the list of clonable homes and click Next.
At the Source Settings page, enter the host credentials and the files to be excluded from the Oracle home archive and click Next.
The credentials provided are verified and the ias.properties file is read to check the configuration. The Product Settings page is rendered accordingly, asking for the new instance name, the old and new ias_admin passwords, and the OID admin password. You may also need to specify the cluster to which the new instance should join and click Next.
Provide the destination Oracle home information along with the destination host credentials. Ensure that these credentials are correct as these are not verified here and the job may fail later if these are wrong. Click Next.
Specify the pre/post/root scripts or commands to be executed before/after the cloning operation. The same script will be executed parallely on each destination. You may choose to execute pre/post scripts with sudo privileges, but the host credentials previously specified should have sudo privileges on the destination host for this to succeed. Failure of this step will not affect the overall status of the job. Click Next.

Note: If root.sh is not run through the job, you must run it manually for the cloning operation to complete.

Schedule the job immediately or at an appropriate time. You can also change the name of the job, from the default one that uses the time stamp. Click Next.
Review your selection and and click Finish.

Note: You can also clone a Portal and Wireless Install frontended by a Load-balancer. In this case, it takes an additional parameter -lbr {true|false} which cannot be passed through Enterprise Manager. By default, it takes the value as true.
In case you want to pass -lbr=false, the source instance will stop working after the clone is complete. To pass this, you will need to edit the $ORACLE_HOME\clone\ias\config\cs.properties file at the source to the following:

portal_cmd= -mode MIDTIER -i typical -s portal -host $host_name -port $http_port -ldap_d $oid_admin -ldap_w_enc $oid_pwd -verbose -oh $ORACLE_HOME -chost $host_name -cport_i $wc_invalid -cport_a $wc_admin -mi true -mc FALSE -pwd_enc $ias_admin_pwd -ultrasearch -syndication -emport $em_port -silent

For more information refer to Cloning Application Server Middle-Tier Instances chapter in the Oracle Application Server Administrator's Guide 10g Release 2 (10.1.2) .

Related Topics

Enterprise Manager Information Roadmap