NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

If you are performing a new installation, go directly to #Installing caIntegrator v. 1.4 Application and ServicesLocal Installation Guide.

caIntegrator 1.3 Users Upgrading to caIntegrator 1.4

...

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 caIntegrator 1.4 Local Installation Guide for more information.

Upgrading caIntegrator Using the GUI Installer

...

  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 caIntegrator 1.4 Local Installation Guide.
    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.

    Info
    titleModifying 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 .
  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.

...