After creating the upgrade environment, move the colonies that you want to upgrade from the production environment to the upgrade environment.
To move colonies to the upgrade environment, follow these steps:
For example, if you are running a sharded deployment on Release 9.3, and upgrading some colonies to Release 9.4, perform a complete sharded installation of Release 9.4 in upgrade mode.
On Oracle:
On DB2®:
${ANT_HOME}/bin/ant -Druntime=<INSTALL_DIR> -Druntime.old=<INSTALL_DIR_OLD>
-f buildmigration.xml -logfile <logfile> -Dtarget=initcolonypool migrate
This command creates the <INSTALL_DIR>/Migration/9.3/database/scripts/multischema.xml file in Upgrade_V2. The XML file contains a list of colonies on Production_V1.
The *.done file that is created in the 9.3 status folder for the initcolonypool task is ant_initcolonypool.xml.done.
For example, if you are upgrading Colony-01, but not Colony-02, set the status for Colony-01 as "UPGRADE" in the XML file, and remove Colony-02 and its corresponding table type from the XML file.
${ANT_HOME}/bin/ant -Druntime=<INSTALL_DIR> -Druntime.old=<INSTALL_DIR_OLD>
-f buildmigration.xml -logfile <logfile> -Dtarget=updatecolonypool migrate
For the colonies that you are moving from Production_V1 to Upgrade_V2, this command sets the colonies to "UPGRADE" status, which disables the colonies in Production_V1 and updates the colony parameters.
The *.done file that is created in the 9.3 status folder of Upgrade_V2's Migration/9.3 directory for the updatecolonypool task is ant_updatecolonypool.xml.done.
For example, if you are moving Colony-01 from Production_V1 to Upgrade_V2, set the status of Colony-01 to "" in the XML file, and change the references for the METADATA, CONFIGURATION, and STATISTICS shards to point to the Upgrade_V1 shards. Additionally, the DEFAULT_TRANSACTION shard should point to Upgrade_V1.
${ANT_HOME}/bin/ant -Druntime=<INSTALL_DIR> -Druntime.old=<INSTALL_DIR_OLD>
-f buildmigration.xml -logfile <logfile> -Dtarget=updatecolonypool migrate
This command updates the colony parameters in Upgrade_V2 to refer to the TRANSACTION and MASTER shards for the colonies you are upgrading.
The *.done file created in the 9.3 status folder of Upgrade_V2's Migration/9.3 directory for the updatecolonypool task is ant_updatecolonypool.xml.done.