1 Back up the existing BIRT iServer Release 11 system to safeguard against failure, including all metadata, data, and necessary configuration files.

2 Shut down the BIRT iHub system by performing the following tasks:

1 Navigate to the BIRT iHub AC_SERVER_HOME/bin folder. When installed in a typical side-by-side configuration, the BIRT iHub AC_SERVER_HOME refers to /home/actuate/iHub/AcServer.

2 Execute the shutdown_srvr script:

3 Shut down the Actuate PostgreSQL for BIRT iHub service by executing the stopPostgreSQL.sh script:

4 Copy the BIRT iServer Release 11 acserverconfig.xml and, if migrating from BIRT iServer  11 Service Pack 4, the encryption keys file from the BIRT iServer configuration folder to the BIRT iHub configuration folder by performing the following tasks:

1 Navigate to the BIRT iHub AC_DATA_HOME/config/iHub2 folder. When installed in a typical side-by-side configuration, the BIRT iHub AC_DATA_HOME refers to /home/actuate/iHub/AcServer/data.

2 For example, copy acserverconfig.xml from the iServer AC_DATA_HOME/config/11SP4 folder to the BIRT iHub AC_DATA_HOME/config/iHub2 folder by executing the following command:

3 If migrating from a BIRT iServer Release 11 Service Pack 4 installation, copy the keys file from the iServer AC_DATA_HOME/config/11SP4 folder to the BIRT iHub AC_DATA_HOME/config/iHub2 folder by executing the following command:

5 If the BIRT iServer Release 11 system uses the out-of-the-box (OOTB) PostgreSQL RDBMS, give the BIRT iHub system access to the PostgreSQL data in the BIRT iServer Release 11 system by performing the following tasks:

1 Copy the postgresql folder from the iServer AC_DATA_HOME/encyc folder to the iHub AC_DATA_HOME/encyc folder by performing the following tasks:

1 Navigate to the BIRT iHub AC_DATA_HOME/encyc folder.

2 Execute the following command:

2 From the iHub AC_DATA_HOME/encyc folder, navigate to the following location:

3 In a text editor, open the postgresql.conf file and find the second occurrence of log_directory. In a default BIRT iServer Release 11 installation, the log_directory setting points to the following location:

4 Scroll down until you see the entry for data_dictionary. In a default BIRT iServer Release 11 installation, the data_directory setting points to the following location:

5 Exit the editor, saving the file to disk.

6 Update the AC_DATA_HOME entry in the BIRT iHub acpmdconfig.xml file to use the value in the BIRT iServer acpmdconfig.xml file by performing the following tasks:

1 In a BIRT iServer Release 11 Service Pack 4 installation, navigate to the following location:

2 In a text editor, open the acpmdconfig.xml file and copy the following setting:

3 In the iHub installation, navigate to the following location:

4 In a text editor, open the acpmdconfig.xml file and replace the default AC_DATA_HOME setting with the value from the BIRT iServer Release 11 acpmdconfig.xml file, as shown in Listing 4‑1. Exit the editor, saving the file to disk.

7 If the BIRT iServer Release 11 system uses the out-of-the-box (OOTB) PostgreSQL RDBMS, start the Actuate PostgreSQL for BIRT iHub service by performing the following tasks:

1 Navigate to the location of the script that starts the iHub PostgreSQL service. For example, in a default installation, navigate to the following location:

2 Execute the following command:

8 If migrating from an installation earlier than Release 11 Service Pack 4, such as Release 11 Service Pack 1, 2, or 3, upgrade the Encyclopedia volume schema by performing the tasks described in “How to upgrade the Encyclopedia volume schema when migrating from an installation earlier than Release 11 Service Pack 4,” later in this chapter.

9 Restart BIRT iHub System by performing the following tasks:

1 Navigate to the location of the script that starts the BIRT iHub System. For example, in a default installation, navigate to the following location:

2 Execute the following command:

3 Log on to the BIRT iHub Configuration and Management Consoles to verify that the system is functioning properly, the Encyclopedia volume is online, and all migrated partitions and data are accessible.

1 Add the paths to the Ant and Java executable programs to the PATH environment variable by performing the following tasks:

1 Create an environment variable named ANT_HOME by executing the following command:

2 Create an environment variable named JAVA_HOME by executing the following command:

3 Add the folders containing the Ant and Java executable programs to the PATH variable by executing the following command:

2 Verify that the following JAR files are in the BIRT iHub AC_SERVER_HOME/jar folder:

3 In the BIRT iHub installation, replace the existing a11Upgrade.xml script with the latest version from the BIRT iHub download page by performing the following tasks:

1 Download the latest version of the a11Upgrade.xml script from the BIRT iHub download page.

2 In the BIRT iHub installation, navigate to the location of the upgrade files:

3 Delete the existing a11Upgrade.xml script. Copy the latest version from the BIRT iHub download page to this location.

4 In this location, upgrade the Encyclopedia volume schema by performing the following tasks:

1 In a text editor, open the a11Upgrade.properties file and edit these settings to point to the following locations:

2 Execute the following command to run the a11Upgrade.xml Ant script: