Page History
...
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. Info | |
Downloading_and_Installing_the UPT }
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Downloading caIntegrator v.1.3* Files
To download the caIntegrator v.1.3 files, follow this step:
The various installation files for caIntegrator v.1.3 are between 150-250MB in size. All of the files can be downloaded from the caIntegrator distribution folder here: https://gforge.nci.nih.gov/frs/?group_id=507.
- For a new command-line installer, download the
caIntegrator_install_1_3.zip
file (around 175MB). - For a command-line upgrade installer, download the
caIntegrator_upgrade_1_3.zip
file (about 175 MB). - For a GUI installer that you can use to do a fresh caIntegrator installation, download the
caIntegrator_gui_distribution_1_3.jar
file (about 207 MB).
Remember the download location, as you will be using this file to run the installation in the steps that follow.
Tip | ||
---|---|---|
| ||
Server Components in caIntegrator v.1.3*|These server components are installed and configured as part of the caIntegrator v.1.3 installation. You do not need to do anything further to download or install these components.
|
Installing a New caIntegrator v.1.3
You can perform a new installation of caIntegrator v.1.3 using either of these two methods:
- A GUI Installation wizard. Instructions for this method start in the following section.
- A command-line installation. For instructions, see page .
GUI Installer Method of Installation
For detailed information on all of the GUI installer fields, refer to the documentation at this location: https://wiki.nci.nih.gov/x/NAUuAQ.
For performing an installation using the GUI Installer, follow these steps:
- Open a command prompt in the directory where you downloaded the caIntegrator_gui_distribution_1_3.jar. Enter this command to Invoke the GUI installer : java –jar caIntegrator_gui_distribution_1_3.jar.
- 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.
- Review the release notes.
- You must accept the license agreement.
- Select Install installation type. For a new installation, select Install.
- Select Browse to navigate to the directory where you would like to install caIntegrator. The directory then displays in the text box.
If the folder does not yet exist, click OK in the dialog box to indicate that you want the folder to be created.| - Select the type of installation you would like to do, you can install everything, or just specific components (JBoss or Database only). The remaining sections in this guide will assume you chose to install everything.
- Continue walking through the pages of the installer. Configure the caIntegrator JBoss server on the next two pages of the installation wizard. The screen shots show example values. The port values which are specified are the defaults and can be used unless you want to reconfigure the values because of values already in use.
!worddavc3a50a54ca511a8427779d3966e69818.png|height=267,width=481# Installation Options
!worddav9e58c8b0b5a90818389faacda8b8d322.png|height=357,width=436# JBoss SSL requires that you have requested and retrieved certificates already. If this doesn't apply to your installation, leave the values as false and continue.
!worddav8099be9eceac8e966f7d6673df612e58.png|height=357,width=477# If your JBoss is externally accessible then fill out this section, otherwise leave it blank and continue.
!worddavcd60ea78b16e71cc87ad3c7a229d86fd.png|height=271,width=478# Specify the authentication type that caIntegrator should use. Database is the most likely choice if you aren't sure what to select here. - If you selected LDAP in the previous step, enter the appropriate configuration information for LDAP: the LDAP URL and the LDAP Search Back DN.
- If the authentication type is database:
Specify the database connection information, including the name of the pre-existing database where the caIntegrator schema will be installed, and the pre-existing user which will be used by caIntegrator to connect to its database.
Error messages inform you if the following occurs:
- If the specified database host cannot be reached, or the field is blank.
- If the specified database does not already exist, or the caIntegrator DB user's credentials are wrong.
# Specify SMTP mail server connection information so that caIntegrator can send emails from users with new account requests.
- If jar signing is necessary for the installation, then enable it on this page, however this step is optional and can be skipped.
- Review the summary of the information you entered.
- Review the selected installation type and the installation destination.
After you click Next from reviewing the installation destination, the installer runs. The installation wizard displays the installation progress and completion. - When you are informed that the process is finished, click Done in the lower right corner of the wizard to close the installer.
- To verify caIntegrator installation:
- Open your web browser to //<jboss.server.hostname>:<jboss.server.port>/caintegrator/workspace.action.
- Enter ncimanager as the user and changeme as the password. Refer to the
<user home>/.installer-caintegrator/caintegrator_installer/install.properties
file for the correct values.
- After successfully installing caIntegrator, make a backup of the
<user home>/.installer-caintegrator/caintegrator_installer/install.properties
file in a different directory for future reference.|
Command-Line Method of Installation
Overview of caIntegrator Command-Line Installer Properties Files
When you do a command-line installation of caIntegrator for the first time, you will work with the properties file included in the caIntegrator_distribution_1_3.zip
. The file is: install.properties
.
If you are command-line upgrading from a previous version of caIntegrator, you will work with the upgrade.properties
file included in the caIntegrator_upgrade_1_3.zip
.|
caIntegrator Port Usage
Info | ||
---|---|---|
| ||
Verify that default port values defined in install.properties files are not in use on your system by running netstat –a from the command line. If the ports are in use prior to installation, you will likely experience problems with your installation. |
JBoss Errors During Installation
Info | ||
---|---|---|
| ||
You may receive an error such as Exception in thread "main" java.lang.NoClassDefFoundError: org/jboss/Shutdown. This should not be a problem, as the installer attempts to stop previously installed servers to prevent problems during the installation. If this is your first time installing caIntegrator, you may receive and disregard this error message. |
Command-line Installation Steps
To install a new instance of caIntegrator using the command-line, follow these steps:
- From the directory where you downloaded the caIntegrator_distribution_1_3.zip from Downloading caIntegrator v.1.3 files on page , 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_3.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|
- 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_3.zip (you must have a ZIP tool installed). This location will be referred to as the <installer_directory> henceforth.
- Note: Setting the property values is an important step in the installation process. Before you complete steps 2 & 3, review Working with Properties Files on page .
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 this wiki page: https://wiki.nci.nih.gov/x/NAUuAQ.| - Record the property values you have set.
Note: 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 type ant. 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 //<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.
Upgrading caIntegrator 1.2 x to 1.3
This section describes how to upgrade your product from caIntegrator 1.2 to caIntegrator 1.3. The instructions in this section apply only if you have already installed a caIntegrator version 1.2.
You can perform an upgrade installation of caIntegrator v.1.3 using either of these two methods:
- A GUI Installation wizard. Instructions for this method begin on page .
- A command-line installation. For instructions, see page .
Note | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
|
...