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).
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
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.
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.
5. Select menu item 2: Keystore Options.
6. Select menu item 50: Environment Installation Options.
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.
Configuring the OUAF Keystore
Refer to the Security Guide included in this release for a detailed description of the keystore.