Page History

...

1. Because of the application name changed in v.1.3, in the JBOSS home directory, locate the war file containing the previous release of caIntegrator2 and delete it. For example, find this file: JBOSS_HOME/server/default/deploy/caintegrator2.war and delete the file named caintegrator2.war.
   NOTE: In this same directory, there is may be a different file named caintegrator.war (without the number 2 in the name) which you should not delete.
2. Open a command prompt in the directory where you downloaded the caIntegrator_gui_distribution_1_3.jar and invoke the GUI installer using this: java –jar caIntegrator_gui_distribution_1_3.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.
6. Select the Upgrade installation type.
7. Configure the JBoss Server-related upgrade settings.
   If the path pointing to the caIntegrator installation to be upgraded is incorrect, an error message appears.
8. 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.
9. Review the summary of gathered information.
10. Click Next to proceed through the next two pages. Review the selected upgrade installation type and the upgrade destination. # After you click Next from reviewing the installation destination, the installer runs. The installation wizard displays the installation progress and completion.
    
11. When you are informed that the process is finished, click Done in the lower right corner to close the installation wizard.
12. To verify caIntegrator installation, open your web browser to 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.

Upgrade Using Command-Line Installer

...

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

1. Because of the application name changed in v.1.3, in the JBOSS home directory, locate the war file containing the previous release of caIntegrator2 and delete it. For example, find this file: JBOSS_HOME/server/default/deploy/caintegrator2.war and delete the file named caintegrator2.war.
   NOTE: In this same directory, there is may be a different file named caintegrator.war (without the number 2 in the name) which you should not delete.|
2. From the directory where you downloaded the upgrade zip file, extract the files, using one of these two methods:
   
3. Open a command prompt and use it to extract this file to a temporary location. For example, you may enter a command such as unzip -q caIntegrator_upgrade_1_3.zip. (You must have a ZIP tool installed).
   
   Note: It is recommended that you use a new directory for the unzipped files, rather than the one you used to unzip the installer for the previous version(s) of caIntegrator. This location will be referred to as the <upgrade_installer_directory> henceforth.
   
4. Use WinZip or a similar utility to unzip the files to a temporary location. This location will be referred to as the <upgrade_installer directory> henceforth
   Example: <upgrade_installer directory> = C:\caintegrator2_1_2_upgrade_installer
5. Edit the default properties in the <upgrade_installer_directory>/upgrade.properties file. Before doing so, review the #Working with Properties Files.
   To do so, open both properties files, the one you configured originally when you installed the previous version of caIntegrator. (<install. properties file>)and the <upgrade_installer_directory>/upgrade.properties file.
   For the latest details about configuring the properties for your updated environment, refer to this wiki page: https://wiki.nci.nih.gov/x/MBKy
   Note: The upgrade.properties file does not have as many attributes, so you will not need to transfer all values you set in the previous installation file.
6. Record these property values.
   Note: 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 thethis file are not being used by other applications.
7. From the command line, navigate to <upgrade_installer_directory>/ (Example:cd C:\caIntegrator_upgrade_installer), and type ant. This initiates the upgrade process. The anticipated duration is anywhere 1-15 minutes depending on your system's speed, power and memory.
   The installer upgrades your existing caIntegrator database on your MySQL server, and starts your existing JBoss server.
   Notes regarding upgrade:
   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 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.

...