...

Page info
title title

Directions are given on this page for installing v.1.4 or 1.4.x application and services. This page includes the following topics:

...

The various installation files for caIntegrator v.1.4 are between 150-200MB in size. All of the files can be downloaded from the caIntegrator distribution folderGForge files archive.

• For a new command-line installer or command-line upgrade installer, download the caintegrator2-install-1.4.zip file (around 165MB).
• For a GUI installer that you can use to do a fresh caIntegrator installation, download the caintegrator2_gui_distribution_1.4.jar-201207171753.jar file (about 190 MB).

...

...

1. Open a command prompt in the directory where you downloaded the .jar file. caintegrator2caintegrator_gui_distribution_1.4.2.jar. Enter this command to invoke the GUI installer: java --jar caintegrator2caintegrator_gui_distribution_1.4.2.jar . 
2. 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.
3. Review the release notes.
4. You must accept the license agreement.
5. Select the Install installation type. For a new installation, select Install.
6. 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.
7. Select the type of installation you would like to perform. You can install everything, or just specific components (JBoss or Database only). The remaining sections in this guide assumes you chose to install everything.
8. 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.
   
9. JBoss Installation Options
   
10. JBoss SSL requires that you have requested and retrieved certificates already. If this does not apply to your installation, leave the values as false and continue.
    
11. If your JBoss is externally accessible then fill out the JBoss External Hostname Configuration page. Otherwise, leave it blank and continue.
12. For a standard installation of caIntegrator, do not use SSO.
13. Specify the authentication type that caIntegrator should use. Database is the most likely choice if you aren't sure what to select here.
14. If you selected LDAP in the previous step (authentication type), enter the appropriate configuration information for LDAP: the LDAP URL and the LDAP Search Back DN.
15. If the authentication type is database, specify the following data base configuration information:
    
    • The Database Host Name
    • The Database Port Example: 3306
    • Database name of the pre-existing database where the caIntegrator schema will be installed
    • The pre-existing Database Application User to 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.
16. Specify SMTP mail server connection information so that caIntegrator can send emails from users with new account requests. You must provide the following
    
    • Mail Server Host Example: localhost
    • Mail Server Port Number Example: 25
    • Mail Server Authentication: default is false.
    • Mail Server starttls: default is false.
17. If jar signing is necessary for the installation, then enable it on the Jar Signing Configuration page. This step is optional and can be skipped.
18. Review the summary of the information you entered.
19. 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.
20. When you are informed that the process is finished, click Done in the lower right corner of the wizard to close the installer.
21. To verify caIntegrator installation:
    
    1. Open your web browser to installed instance. The URL follows this format: http://<jboss.server.hostname>:<jboss.server.port>/caintegrator/workspace.action.
    2. 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.
22. 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.

...

See also   Working with Properties Files .

...

1. From the directory where you downloaded the caintegrator2caintegrator-install-1.4.2.zip files described in Downloading caIntegrator v.1.4 Files, unzip the files, using one of these two methods:
   
   1. 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 caintegrator2caintegrator-install-1.4.2.zip. You must have a ZIP tool installed. This location will be referred to as the <installer_directory> henceforth.

   2. 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 .

2. 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.

3. 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.

4. From the command line, navigate to <installer_directory>/(Example:cd C:\caIntegrator_1_4_1_installercaintegrator-install-1.4.2), 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.
5. 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.
6. After successfully installing caIntegrator, make a backup of the <installer_directory>/install.properties file in a different directory for future reference.

...