2 Installing DIVA Enterprise Connect

Note:

You must execute the steps in each section in this chapter sequentially as listed.

Initial Installation

You can use the DIVA Enterprise Connect installation package to install WebLogic 12c, Oracle Java 8 JDK, and the DIVA Enterprise Connect services. Starting with 1.0.1, there are two editions of Oracle DIVA Enterprise Connect -- a Windows version, as well as a Linux version that runs on Oracle Linux 7. There are two distinct installation packages for each operating system.

The installation requires that you create two main directories as follows:

  • Staging Directory (%STAGING_DIR% for Windows, $STAGING_DIR for Linux) — A temporary directory the install process uses.

  • Home Directory (%DIVAS_HOME% for Windows, $DIVAS_HOME for Linux) — The top-level directory where the WebLogic and Web Services are installed.

Note:

The STAGING_DIR and DIVAS_HOME variables are not actual environment variables. They only appear in this document to represent the values chosen by the user.

Running the installer package installs Oracle Weblogic, configures the DivaServices domain/servers, and deploys the DivaServices ear file. You must then create an API key, configure the connection to DIVArchive, and then start the WebLogic server. The following sections describe this process.

To install multiple instances of Enterprise Connect on the same machine (for instance, if two DIVArchive systems must be provisioned separately), insure that each instance is configured in its own WebLogic Domain, with unique, non-conflicting admin and web service ports.

Oracle Linux Installation

Task 1   Unzip the Release Tarball
  1. Open a command terminal.

  2. Create a temporary staging directory (referenced as $STAGING_DIR in this procedure).

  3. Copy the DIVArchive Web Services installation package in the staging directory.

  4. Change to the staging directory and execute the following command:

    tar -xvzf diva-ec-platform.1.0.0-dws.{release}.bin.tar.gz
    

    Where:{release} is the specific DIVArchive Web Services release number.

Task 2   Change Installation Properties (optional)

By default, the WebLogic and Java 8 packages are installed to /home/diva/divas. The default administrator user name is weblogic. If you do not need to customize these, or other install variables, skip ahead to run the main installation script.

  1. To customize the $DIVAS_HOME directory, and other install-time parameters, open a command terminal and edit the $STAGING_DIR/install.properties file.

  2. The home directory must be distinct from the staging directory you previously created. You can optionally change the ports used for the WebLogic administration tool, and the DIVArchive Web Services. The following is a sample install.properties file:

    # Installation Directory
    DIVAS_HOME=/home/diva/divas
    
    # WebLogic Administrator username. Not case sensitive
    # The user will prompted for the password when running the installation.
    WL_USER= weblogic
    # DIVAS Application Ports
    WL_HTTP=7001
    WL_HTTPS=7002
    DIVAS_HTTP=9443
    DIVAS_HTTPS=9444
    
Task 3   Run the Main Installation Script

Caution:

The following script removes all contents of the current WebLogic installation, and reinstalls all modules. Do not run this script if you have already installed WebLogic and Java unless you want to remove all WebLogic configuration parameters.
  1. You must select a (non-administrative) Linux user to use for this procedure. Do not use the root account for installation or to run the services!

  2. Execute the $STAGING_DIR/installDIVAS.sh script in the staging directory.

  3. Enter in a new WebLogic Admin User password. The password must be at least 8 characters, and contain at least one upper case letter and one number.

  4. Decide whether to configure SSL. If you choose yes, enter in the Keystore passwords.

  5. When prompted to execute the root.sh script as a root user, open another shell window to run the root.sh script located in $DIVAS_HOME/bin directory. Make sure you run this script with root permissions on the system.

Task 4   Generate the API User
  1. Change to the $DIVAS_HOME/bin directory.

  2. Enter the WebLogic user name and password you previously created as arguments to the key generator as follows:

    ./runAPIKeyGenerator.sh --wluser {WL_admin_user_name} --wlpass {WL_admin_password}

  3. Write down the clientId and API key appearing in the script output. API clients must supply these values when making web service requests.

Task 5   Configure the Connection to DIVArchive and DIVAnet
  1. Locate the divas-config.properties file located in the $DIVAS_HOME/DIVAS_Domain/config/dwsConfig/AppFileOverrides directory.

  2. Edit the following parameters to reflect the DIVArchive and DIVAnet IP address and port number:

    divas.service.connection.hostAddress= {DIVA IP address}
    divas.service.connection.hostPort= {DIVA port number}
    
Task 6   Restart Enterprise Connect
  1. Using the same user account that was used to run the installation script, change to the /bin subdirectory under the $DIVAS_HOME directory, and execute the following commands:

    ./DIVAS stop divaSvcs
    ./DIVAS start divaSvcs
    
  2. This set of commands stops and starts the DivaServices server within WebLogic without affecting the WebLogic AdminServer.

Windows Installation

Oracle DIVA Enterprise Connect runs on a Windows 64-bit OS. The executable installs and configures Oracle WebLogic 12c, the Java 8 JDK, and the Enterprise Connect web services.

After installation, you can start and stop Enterprise Connect by setting the AdminServer and DivaServices Windows Services to the running state, or using the DIVAS command-line utility (see "Starting and Stopping WebLogic Services with the DIVAS Script").

Task 1   Launch the .exe File and Select Installation Options
  1. Launch the Oracle DIVA Enterprise Connect NEEDFILENAME.exe file.

  2. Select the installation options:

    • Install WebLogic

    • Configure Enterprise Connect

Task 2   Install WebLogic and Java JDK
  1. Enter the location of the WebLogic installer jar (by default, this is the same directory as the Enterprise Connect installer). The filename for this jar file follows the pattern fmw_infrastructure-12.*.jar.

  2. Enter the target installation directory for WebLogic.

  3. Enter a temporary staging directory to use for the installation process.

Task 3   Configure Enterprise Connect
  1. Enter the home directory where WebLogic was installed.

  2. Enter the following:

    • New Weblogic admin username and password

    • New keystore passwords

    • Weblogic domain name

    • Ports for the admin and diva web services

    • DIVArchive Manager address and port

    Note:

    The passwords must contain at least 8 characters, at least one letter, and at least one number or special character.
  3. The installer creates the Weblogic domains and servers, configures and deploys the services, and installs two Windows services: a WebLogic AdminServer service, and a DivaService service.

Task 4   Configure the Connection to DIVArchive and DIVAnet
  1. Locate the divas-config.properties file located in the %WL_HOME%/%DOMAIN_NAME%/config/dwsConfig/AppFileOverrides directory.

  2. Edit the following parameters to reflect the DIVArchive and DIVAnet IP address and port number:

    divas.service.connection.hostAddress= {DIVA IP address}
    divas.service.connection.hostPort= {DIVA port number}
    

Generating an API User

DIVArchive Web Services clients must supply a user name and API key to access the services. See "Generating API Users and API Keys".