NIH | National Cancer Institute | NCI Wiki  

Directions are given on this page for upgrading caIntegrator from 1.3 to 1.4 or from 1.4 to 1.4.2 . This page includes the following topics:

Upgrading caIntegrator 1.3 to 1.4

This section describes how to upgrade your product from caIntegrator 1.3 to caIntegrator 1.4. The directions in this section presume that you have a valid and functioning caIntegrator 1.3. It also assumes that Java SDK, Apache Ant and MySQL have all been successfully uploaded and installed, as described on pages Required Software Not Included in caIntegrator .

You can perform an upgrade installation of caIntegrator v.1.3 using either of these two methods:

BEFORE YOU BEGIN

  • Important: Backup the 1.3 database. You need to create a reliable copy of your entire caIntegrator database.
  • Important: Backup the current installation of caIntegrator and artifacts from the original installation, such as properties files.

If you are performing a new installation, go directly to Installing caIntegrator v.1.4 Application and Services.

Overview of Properties Files

When you installed the previous version of caIntegrator 1.3, you configured the install.properties file. To complete the upgrade to caIntegrator 1.4, you must use some of the values from the original install.properties to configure values in the installer wizard GUI.

See steps 3 & 4 in Upgrading caIntegrator Using the Command-Line Installer for more information.

Upgrading caIntegrator to v.1.4 Using the GUI Installer

For detailed information on all of the GUI installer fields, refer to the BDA Properties page.

To perform an upgrade to caIntegrator 1.4 using the GUI Installation Wizard, follow these steps:

  1. Because of the upgrade from JBOSS4 to JBOSS5 in the caIntegrator 1.4 release, two GUI installer invocations are required. The first will install the new JBOSS5 in the same directory as the existing JBOSS4 and the second will update the database.
  2. Open the install.properties file for the existing 1.3 installation located at <user home>/.installer-caintegrator/caintegrator_installer/install.properties and save it as install.properties_v1.3 to your desktop for reference during the upgrade.
  3. Open a command prompt in the directory where you downloaded the caintegrator2_gui_distribution_1.4.jar-201207171753.jar and invoke the GUI installer using this: java --jar caintegrator2_gui_distribution_1.4.jar-201207171753.jar.
  4. The Installation Wizard opens to facilitate the installation process. Click Next to proceed through the pages of the wizard, beginning with progressing past the Welcome page.
  5. Review the release notes.
  6. You must accept the license agreement to continue.
  7. Select the Install installation type in step #4.
  8. Select JBoss in step #6.
  9. Configure the JBoss Server-related settings.
  10. Specify the authentication type that caIntegrator is using. If you choose LDAP, configure the LDAP information: the LDAP Host Name, the LDAP Search Base, and the LDAP Search Prefix. An example of the Host Name is ldaps://myldaphost.mydomain.com:636 .
  11. Review the summary of gathered information.
  12. Click Next to proceed through the next two pages.
  13. After you click Next from reviewing the installation destination, the installer runs. The installation wizard displays the installation progress and completion.
  14. When you are informed that the process is finished, click Done in the lower right corner to close the installation wizard.
  15. At this point if you open your web browser to the installed instance you will see a MYSQLGrammerException error displayed.
  16. Before invoking the GUI installer again, stop the server.
  17. Open a command prompt in the directory where you downloaded the caintegrator2_gui_distribution_1.4.jar-201207171753.jar and invoke the GUI installer using this: java --jar caintegrator2_gui_distribution_1.4.jar-201207171753.jar.
  18. The Installation Wizard opens to facilitate the installation process. Click Next to proceed through the pages of the wizard, beginning with progressing past the Welcome page.
  19. You must accept the license agreement to continue.
  20. Select the Upgrade installation type in step #4.
  21. Select Everything in step #6.
  22. Configure the JBoss Server-related settings.
  23. Specify the authentication type that caIntegrator is using. If you choose LDAP, configure the LDAP information: the LDAP Host Name, the LDAP Search Base, and the LDAP Search Prefix. An example of the Host Name is ldaps://myldaphost.mydomain.com:636 .
  24. Review the summary of gathered information.Review the selected upgrade installation type and the upgrade destination.
  25. Click Next to proceed through the next two pages.
  26. After you click Next from reviewing the installation destination, the installer runs. The installation wizard displays the installation progress and completion.
  27. To verify the caIntegrator installation, open your web browser to the installed instance. The URL follows this format: http://<jboss.server.hostname>:<jboss.server.port>/caintegrator. Example: http://hostname:47210/caintegrator and enter ncimanager as the user and changeme as the password. Refer to the original install.properties for the correct jboss.server.hostname and jboss.server.port values.
  28. Once the update is verified you can delete the JBOSS4 directory.

Upgrading caIntegrator to v. 1.4 Using the Command-Line Installer

To perform an upgrade to caIntegrator 1.4 using the command-line, follow these steps:

  1. Because of the upgrade from JBOSS4 to JBOSS5 in the caIntegrator 1.4 release, two ant commands are required. The first will install the new JBOSS5 in the same directory as the existing JBOSS4 and the second will update the database.
  2. Open the install.properties file found in the application.base.path directory and save it to your desktop as install.properties.v1.3.1 for reference during the upgrade.
  3. Delete the caintegrator2-install-1.3.1.zip file from its directory such as the application.base.path directory.
  4. Download caintegrator2-install-1.4.zip to the directory where the previous install zip file was such as the application.base.path directory. From the directory where you downloaded the install zip file, extract the files, using one of these two methods:
    1. Open a command prompt and use it to extract this file. For example, you may enter a command such as unzip -q caintegrator2-install-1.4.zip . You must have a ZIP tool installed.
    2. Use WinZip or a similar utility to unzip the files.
  5. When asked if you would like to replace the existing files, respond All.
  6. Open the install.properties file and replace all REPLACE_VALUE properties with the values in the install.properties.v1.3.1 file. Before doing so, review Working with Properties Files  .
    For the latest details about configuring the properties for your updated environment, refer to the BDA Properties page.
  7. In the DATABASE SETTINGS section of the install.properties file replace database.re-create=true with database.re-create=false. In the DATABASE SETTINGS section of the install.properties file add the property and value exclude.database=true.
  8. Save this file to your desktop as install.properties.v1.4step1. Save this file to your desktop a second time, this time as install.properties. Upload the install.properties file to the application.base.path directory.

    Modifying property values

    You shouldn't need to modify the other default values as we have chosen unique ports to reduce the risk of other applications using the same values. However, be sure to check the *.properties file to verify that the ports in this file are not being used by other applications.

  9. From the command line, navigate to the directory where you unzipped the installer file and type ant . This is the first of two ant commands. The anticipated duration is anywhere 1-15 minutes depending on your system's speed, power and memory.
  10. When the installer detects that a database exists, it warns you to back it up, which you were instructed to do earlier in this process. Press Y to proceed.
  11. If you open the application now in a browser window you will see a MYSQLGrammerException error.
  12. Stop the server.
  13. Open the install.properties file and revert database.re-create=false back to database.re-create=true. Delete the property and value exclude.database=true.
  14. Save this file to your desktop as install.properties.v1.4step2. Save this file to your desktop a second time, this time as install.properties. Upload the install.properties file to the application.base.path directory.
  15. From the command line, navigate to the directory where you unzipped the installer file and type ant upgrade:database Exit Disclaimer logo .
  16. Restart the server.
  17. To verify caIntegrator installation, open your web browser to the installed instance. The URL follows this format: http://<jboss.server.hostname>:<jboss.server.port>/caintegrator /workspace.action. Example: http://hostname:47210/caintegrator/workspace.action and enter ncimanager as the user and changeme as the password. Refer to the original install.properties for the correct jboss.server.hostname and jboss.server.port values.
  18. Once the update is verified you can delete the JBOSS4 directory.

Upgrading to caIntegrator 1.4.2

This section describes how to upgrade your product from caIntegrator 1.4 or 1.4.1 to caIntegrator 1.4.2. The directions in this section presume that you have a valid and functioning caIntegrator 1.4 or caIntegrator 1.4.1. It also assumes that Java SDK, Apache Ant and MySQL have all been successfully uploaded and installed, as described on pages Required Software Not Included in caIntegrator . For upgrading from version 1.4 to 1.4.2, simply use the caintegrator updater, described in the following sections.

You can perform an upgrade installation of caIntegrator to v.1.4.2 using either of these two methods:

BEFORE YOU BEGIN

  • Important: Backup the database. You need to create a reliable copy of your entire caIntegrator database.
  • Important: Backup the current installation of caIntegrator and artifacts from the original installation, such as properties files.

If you are performing a new installation, go directly to Installing caIntegrator v.1.4 or 1.4.2 Application and Services.

Overview of Properties Files

When you installed the previous version of caIntegrator 1.4 or 1.4.1, you configured the install.properties file. To complete the upgrade to caIntegrator 1.4.2, you must use some of the values from the original install.properties to configure values in the installer wizard GUI.

See steps 3 & 4 in Upgrading caIntegrator to v.1.4.2 Using the Command-Line Installerr for more information.

Upgrading caIntegrator to v.1.4.2 Using the GUI Installer

For detailed information on all of the GUI installer fields, refer to the BDA Properties page.

To perform an upgrade to caIntegrator 1.4.2 using the GUI Installation Wizard, follow these steps:

  1. Open the install.properties file for the existing 1.4 installation located at <user home>/.installer-caintegrator/caintegrator_installer/install.properties and save it as install.properties_v1.4.2 to your desktop for reference during the upgrade.
  2. Open a command prompt in the directory where you downloaded the caintegrator_gui_distribution_1.4.2.jar and invoke the GUI installer using this: java --jar caintegrator_gui_distribution_1.4.2.jar.
  3. The Installation Wizard opens to facilitate the installation process. Click Next to proceed through the pages of the wizard, beginning with progressing past the Welcome page.
  4. Review the release notes.
  5. You must accept the license agreement to continue.
    1. Select the Upgrade installation type in step #4.
    2. Select Everything in step #6.
  6. Configure the JBoss Server-related settings.
  7. Specify the authentication type that caIntegrator is using. If you choose LDAP, configure the LDAP information: the LDAP Host Name, the LDAP Search Base, and the LDAP Search Prefix. An example of the Host Name is ldaps://myldaphost.mydomain.com:636 .
  8. Review the summary of gathered information.Review the selected upgrade installation type and the upgrade destination.
  9. Click Next to proceed through the next two pages.
  10. After you click Next from reviewing the installation destination, the installer runs. The installation wizard displays the installation progress and completion.
  11. To verify the caIntegrator installation, open your web browser to the installed instance. The URL follows this format: http://<jboss.server.hostname>:<jboss.server.port>/caintegrator. Example: http://hostname:47210/caintegrator and enter ncimanager as the user and changeme as the password. Refer to the original install.properties for the correct jboss.server.hostname and jboss.server.port values.

Upgrading caIntegrator to v.1.4.2 Using the Command-Line Installer

To perform an upgrade to caIntegrator 1.4.2 using the command-line, follow these steps:

  1. Open the install.properties file found in the application.base.path directory and save it to your desktop as install.properties.v1.4.2 for reference during the upgrade.
  2. Download caintegrator-upgrade-1.4.2.zip to the directory where the previous install zip file was such as the application.base.path directory. From the directory where you downloaded the install zip file, extract the files, using one of these two methods: 
    1. Open a command prompt and use it to extract this file. For example, you may enter a command such as unzip -q caintegrator-upgrade-1.4.2.zip. You must have a ZIP tool installed.
    2. Use WinZip or a similar utility to unzip the files.
  3. When asked if you would like to replace the existing files, respond All.
  4. Open the upgrade.properties file and replace all REPLACE_VALUE properties with the values in the install.properties.v1.4.2 file. Before doing so, review Working with Properties Files  .
    For the latest details about configuring the properties for your updated environment, refer to the BDA Properties page.
  5. Save this file to your desktop as upgrade.properties. Upload the upgrade.properties file to the application.base.path directory.

    Modifying property values

    You shouldn't need to modify the other default values as we have chosen unique ports to reduce the risk of other applications using the same values. However, be sure to check the *.properties file to verify that the ports in this file are not being used by other applications.

  6. From the command line, navigate to the directory where you unzipped the installer file and type ant. The anticipated duration is anywhere 1-15 minutes depending on your system's speed, power and memory.
  7. When the installer detects that a database exists, it warns you to back it up, which you were instructed to do earlier in this process. Press Y to proceed.
  8. To verify caIntegrator installation, open your web browser to the installed instance. The URL follows this format: http://<jboss.server.hostname>:<jboss.server.port>/caintegrator /workspace.action. Example: http://hostname:47210/caintegrator/workspace.action and enter ncimanager as the user and changeme as the password. Refer to the original install.properties for the correct jboss.server.hostname and jboss.server.port values.
  • No labels