Page History
...
Required Software Name and Version | Description |
---|---|
Java 2 Platform Standard Edition 6.0 Update 31 (J2SE 6.0). Be sure to download the correct Java SDK for your operating environment. For example, for Linux AMD 64, you would download jdk for Linux, | The J2SE Development Kit (JDK) supports creating J2SE applications. |
Apache Ant is a Java-based build tool. | |
MySQL is an open-source database software application. |
...
- As the root user, enter the following in the
/etc/profile
file. A PATH variable should already be created in this file, so be sure to define the JAVA_HOME and ANT_HOME export before the PATH export. Replace<some_path>
with the correct path fragment for Java and Ant installations.
export JAVA_HOME=<some_path>/jdk1.6.0_31
export ANT_HOME=<some_path>/apache-ant-1.78.02
Â
export PATH=$JAVA_HOME/bin:$ANT_HOME/bin:$PATH
- Log out and log back in so that the system recognizes your changes.
...
- From the command line, enter:
*echo $JAVA_HOME
echo $ANT_HOME
Both of these commands should return the location where you installed these tools. - To verify your Ja*va SDK installation, enter
java --version
from a command prompt. You should seejava version "1.6.0_31"
. - To verify your Ant installation, enter:
ant --version
from a command prompt. You should see:Apache Ant version 1.7.0 compiled on December 13 2006.8.2
Windows
To set the environmental variables in Windows, follow these steps:
...
- From the command line, enter:
echo %JAVA_HOME%
*
echo %ANT_HOME%
*
Both of these commands should return the location where you installed these tools. - To verify your Java SDK installation, enter
java --version
from a command prompt. You should seejava version "1.6.0_31"
. - To verify your Ant installation, enter
ant --version
Info title Other environment variables Environment variables for caIntegrator and, optionally, UPT are modified and set in those sections of this document: #Installing a New caIntegrator v.1.4||||||\ and #Downloading and Installing UPT (Optional)||||||\.
MySQL Installation and Configuration
...
- #Downloading caIntegrator v.1.4 Files||||||\
- #Installing a New caIntegrator v.1.4||||||\
- #Configuring JBoss||||||\
- #Post-Installation Tasks||||||\
Note | ||
---|---|---|
| ||
There must already be a pre-existing MySQL DB and connection username/password for caIntegrator to install into; caIntegrator does not create its own DB. |
...
- A GUI Installation wizard. Instructions for this method start in the following section.
- A command-line installation. For instructions, see #Command-Line Method of Installation||||||\.
GUI Installer Method of Installation
...
- From the directory where you downloaded the
caIntegrator_distribution_1_4.zip
described in Downloading caIntegrator v.1.4 files, unzip the Files, using one of these two methods:- 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_distribution_1_4.zip
. You must have a ZIP tool installed. This location will be referred to as the<installer_directory>
henceforth. - Use WinZip or a similar utility to unzip the files to a temporary location. This location will be referred to as the
<installer_directory>
henceforth.
Example:<installer directory>
=C:\caIntegrator_installer
Info title About setting property values Setting the property values is an important step in the installation process. Before you complete steps 2 & 3, review #Working with Properties Files||||||\.
- Open a command prompt and use it to extract this file to a temporary location. For example, you may enter a command such as
- Open the
<installer_directory>
/
install.properties
file, modify the values for your environment and save the file. For the latest details about configuring the properties for your environment, refer to the BDA Properties wiki page. - Record the property values you have set.
Info title Other default values You should not 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 verify that the ports in this file are not being used by other applications.
- From the command line, navigate to
<installer_directory>/
(Example:cd C:\caIntegrator_2_0_installer
), and typeant
. This initiates the installation process. The anticipated duration is anywhere from 1-15 minutes, depending on your system's speed, power and memory.
The installer installs the caIntegrator schema in the specified pre-existing database on your MySQL server, and installs, configures, and starts the JBoss server for the caIntegrator application. - 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.
Refer to the<installer_directory>/install.properties
file for the correct values. Enter manager as the user and manager as the password. - After successfully installing caIntegrator, make a backup of the
<installer_directory>/install.properties
file in a different directory for future reference.
...
- A GUI Installation wizard. Instructions for this method are found in #Upgrade Using the GUI Installer||||||\.
- A command-line installation. Instructions for this method are found in #Upgrade Using Command-Line Installer||||||\.
Note | ||
---|---|---|
| ||
|
If you are performing a new installation, go directly to #Installing caIntegrator v.1.4 Application and Services||||||\.
caIntegrator 1.3 Users Upgrading 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||||||\.
Overview of Properties Files
...
See steps 3 & 4 in #Upgrade Using Command Line Installer||||||\ for more information.
...
- Because of the application name change in v.1.4, 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 namedcaintegrator2.war
.Warning title Watch .war file name In this same directory, there may be a different file named
caintegrator.war
(without the number 2 in the name) which you should not delete. - From the directory where you downloaded the upgrade zip file, extract the files, using one of these two methods:
- 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_4.zip
. You must have a ZIP tool installed.Info title Directory for unzipped files 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. - 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
- Open a command prompt and use it to extract this file to a temporary location. For example, you may enter a command such as
- Edit the default properties in the
<upgrade_installer_directory>
/
upgrade.properties
file. Before doing so, review #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 the BDA Properties page.Info title 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. - Record these property values.
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. - 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. - 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.
- 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
andjboss.server.port
values.
...