Page History

...

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.

   Info
   title 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

    Multiexcerpt include
    nopanel true MultiExcerptName ExitDisclaimer PageWithExcerpt wikicontent:Exit Disclaimer to Include

    .
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

...

to

...

1.4.1

This section describes how to upgrade your product from caIntegrator 1. to caIntegrator 1.4.1. The directions in this section presume that you have a valid and functioning caIntegrator 1.4. 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.0 to 1.4.x, simply use the caintegrator updater, described in the following sections.

...