Note:
You must execute the steps in each section in this chapter sequentially as listed.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:
TheSTAGING_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.
Open a command terminal.
Create a temporary staging directory (referenced as $STAGING_DIR
in this procedure).
Copy the DIVArchive Web Services installation package in the staging directory.
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.
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.
To customize the $DIVAS_HOME
directory, and other install-time parameters, open a command terminal and edit the $STAGING_DIR/install.properties
file.
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
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.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!
Execute the $STAGING_DIR/installDIVAS.sh
script in the staging directory.
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.
Decide whether to configure SSL. If you choose yes, enter in the Keystore passwords.
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.
Change to the $DIVAS_HOME/bin
directory.
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}
Write down the clientId
and API key appearing in the script output. API clients must supply these values when making web service requests.
Locate the divas-config.properties
file located in the $DIVAS_HOME/DIVAS_Domain/config/dwsConfig/AppFileOverrides
directory.
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}
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
This set of commands stops and starts the DivaServices server within WebLogic without affecting the WebLogic AdminServer.
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").
Launch the Oracle DIVA Enterprise Connect NEEDFILENAME.exe
file.
Select the installation options:
Install WebLogic
Configure Enterprise Connect
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
.
Enter the target installation directory for WebLogic.
Enter a temporary staging directory to use for the installation process.
Enter the home directory where WebLogic was installed.
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.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.
Locate the divas-config.properties
file located in the %WL_HOME%/%DOMAIN_NAME%/config/dwsConfig/AppFileOverrides
directory.
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}
DIVArchive Web Services clients must supply a user name and API key to access the services. See "Generating API Users and API Keys".