Installing Oracle Utilities Application Framework
This section outlines the steps for installing the Oracle Utilities Application Framework, including:
Installation Process (Brief Description)
1. Login as the Oracle Utilities Application Framework administrator (the default is cissys on UNIX) or as a user with Administrator privileges (on Windows).
2. Configure your application server and any third-party software required for your platform, as outlined in Installing Application Server Prerequisite Software.
3. Change directory to the <TEMPDIR>/FW-V4.5.0.1.1 directory.
4. Set the following path:
export PATH=/<JAVA_HOME>/bin:/<JAVA_HOME>/lib:$PATH
 
Note: The above command is only applicable on a Unix platform. <JAVA_HOME> is the location where the JDK has been installed.
5. Start the application installation utility by executing the appropriate script.
For initial install:
Unix:
ksh ./install.sh
 
Windows:
install.cmd
 
6. Follow the messages and instructions that are produced by the application installation utility. Use the completed worksheets in the Installation Menu Functionality Overview section in Planning the Installation to assist you.
Installation of Oracle Utilities Framework Application Server is complete if no errors occurred during installation.
Installation Process (Detailed Description)
1. Login to the host server as Oracle Utilities Application Framework administrator.
Login as cissys (on UNIX) or as a user with Administrator privileges (on Windows).
2. Configure application server and third-party software.
Complete all steps outlined in the Installing Application Server Prerequisite Software in Installing Application Server Prerequisite Software. You will need to obtain specific information for the install.
3. Change directory to the <TEMPDIR>/FW-V4.5.0.1.1 directory and start the application installation utility by executing the appropriate script:
Unix:
ksh ./install.sh
 
Windows:
install.cmd
 
Note: In Windows platform, the installation must be on a NTFS filesystem. The script will error out if the filesystem is not NTFS.
4. On the Environment Installation Options menu, select item 1: Environment ID, Roles, Third Party Software Configuration.
Use the completed Environment ID, Roles, Third Party Software Configuration worksheet in the Installation Menu Functionality Overview section in Installing the Application Server Component of Oracle Utilities Application Framework to complete this step.
5. Select menu item 2: Keystore Options.
Use the completed Keystore Options Worksheet to complete this step. See Installation Menu Functionality Overview section in Installing the Application Server Component of Oracle Utilities Application Framework.
6. Select menu item 50: Environment Installation Options.
Use the completed Environment Installation Options Worksheet to complete this step. See Installation Menu Functionality Overview section in Installing the Application Server Component of Oracle Utilities Application Framework.
Note: You must create the directory for output (the Log Mount Point). The installation process fails if this directory does not exist.
• Specify the environment mount point, log files mount point, name and the environment directory names for a new installation on a menu screen.
• Specify the web application server type your environment will run with (the default will be WebLogic).
• Specify if you want to install sample custom code.
• Enter P to accept the selected options.
• During this step, the specification of a new environment is checked for validity against /etc/cistab and the permissions on mount points and directories.
7. Configure environment parameters.
• During this step you will configure environment parameters such as web server hosts and ports, database name, and user ID.
• The application installation utility shows default values for some configuration options.
• Use the completed Environment Configuration Worksheet to assist you.
Note: Some options require a value for a successful install. It is important to provide these values as described in the previous sections.
• When you are done with the parameters setup, proceed with the option P.
• All of the options will be written in the following File: $ SPLEBASE/etc/ENVIRON.INI.
• You will be warned if you did not edit a section. You may proceed if you want to keep the default settings.
• The application installation utility copies the installation media to a new environment.
• The application installation utility generates environment configuration parameters.
The application installation utility automatically executes the script initialSetup.sh (on UNIX) or initialSetup.cmd (on Windows), located in $SPLEBASE/bin (%SPLEBASE%\bin on Windows) directory. This script populates different application template configuration files with the new environment variables values and completes the rest of the installation steps.
8. Set up environment variables.
Once the ENVIRON.INI file is created and contains the correct environment parameters, the application installation utility starts a sub shell to the current process by executing the splenviron.sh (on UNIX) or splenviron.cmd (on Windows) script, located in $SPLEBASE/bin (or %SPLEBSE%\etc for Windows) directory. This script sets up all the necessary environment variables and shell settings for the application server to function correctly.
From this point, a number of environment variables have been set up. Some key ones are:
• $PATH: An adjustment to $PATH is made so that all of the environment scripts and objects will be in the path.
• $SPLEBASE (%SPLEBASE%): Stands for <SPLDIR>/<SPLENVIRON> directory
• $SPLOUTPUT (%SPLOUTPUT%): Stands for <SPLDIROUT>/<SPLENVIRON> directory
• $SPLENVIRON (%SPLENVIRON%): Environment name
For future operations or any post installation steps, you need to first execute the following command to setup your session to the new environment:
• Unix
$SPLEBASE/bin/splenviron.sh -e <SPLENVIRON>
 
• Windows
%SPLEBASE%\bin\splenviron.cmd -e <SPLENVIRON>
 
This script should be executed each time you want to connect to the specific environment before performing manual operations, such as shutdown, startup or performing an additional application product installation.
When you have finished the install process, your current online session will be connected to the new environment.
Refer to Planning the Installation for settings and configuration.
Configuring the OUAF Keystore
Refer to the Security Guide included in this release for a detailed description of the keystore.