This chapter describes how to use the Oracle Communications Services Gatekeeper installers. This process must be followed on every server in the system. The chapter includes information on:
Before you run the installer, you should have a high level understanding of the entire installation and configuration process. See Task Overview for more information.
Use the following instructions if you wish to use the GUI-based installer to install Oracle Communications Services Gatekeeper. You must do this for all servers.
Note: | If you want to use the GUI-based installer, the console attached to the machine on which you are installing the software must support a Java-based GUI. All consoles for Windows systems support Java-based GUIs, but not all consoles for UNIX/Linux systems do. If you attempt to start the installation program in graphical mode on a system that cannot support a graphical display, the installation program automatically starts console-mode installation. |
Note: | Windows is only supported for dev/test environments. It is not supported for production. |
If you are using the GUI-based installer on a Windows machine, do the following:
_win_x86.exe
ocsg411_win_x86
You can also include the -log=full_path_to_log_file
option in the command line to create a verbose installation log. For example:
ocsg411_win_x86 -log=<full_path>install.log
If you are using the GUI-based installer on a UNIX/Linux machine, do the following:
chmod a+x ocsg411_<appropriate-platform-filename>.bin
./ocsg411_<appropriate-platform-filename>.bin
You can also include the -log=full_path_to_log_file
option in the command line to create a verbose installation log. For example:
ocsg411_<appropriate-platform-filename>.bin -log=<full_path>install.log
Note: | For Linux Redhat AS4, use ocsg411_linux_x86.bin for x86 installations and ocsg411_linux_x86_64.bin for x86-64 installations. For Solaris 9 or 10, use ocsg411_solaris_sparc.bin for 32 bit installations and ocsg411_solaris_sparc_64.bin for 64 bit installations. |
Oracle Communications Services Gatekeeper ships with a generic installer that is primarily designed to be run on machines running HP-UX. If you are using the GUI-based installer, do the following:
bin
directory of the appropriate JDK (installed separately) to the beginning of the PATH
variable definition on the target system. For example:PATH=JAVA_HOME/bin:$PATH
export PATH
Here JAVA_HOME
represents the full path to the JDK directory.
java -jar ./ocsg411_generic.jar
Note: | Once you have run the installer you must do the following additional two steps: |
WL_HOME
variable to the directory in which you installed your Oracle Communications product, and export WL_HOME
. For example:$ export WL_HOME=<your_installation_directory>/wlserver_10.3
cd $WL_HOME/server/native/hpux11/IPF32/
$WL_HOME/server/native
directory:$ chmod -R +x $WL_HOME/server/native/hpux11/
The installation program prompts you to enter specific information about your system and configuration. For instructions on responding to the prompts during installation, see the following table.
Use the following instructions if you wish to use the Console-based installer to install Oracle Communications Services Gatekeeper. You must do this for all servers.
Note: | Windows is only supported for dev/test environments. It is not supported for production. |
If you are using the Console-based installer on a Windows machine, do the following:
ocsg411_win_x86.exe -mode=console
You can also include the -log=full_path_to_log_file
option in the command line to ocsg411_win_x86.exe -mode=console -log=C:\logs\server_install.log
If you are using the Console-based installer on a UNIX/Linux machine, do the following:
chmod a+x ocsg411_<appropriate-platform-filename>.bin
./ocsg411_<appropriate-platform-filename>.bin -mode=console
You can also include the -log=full_path_to_log_file
option in the command line to create a verbose installation log. For example:
./ocsg411_<appropriate-platform-filename>.bin -mode=console -log=/home/logs/server_install.log [all on one line]
Note: | For Linux Redhat AS4, use ocsg411_linux_x86.bin for x86 installations and ocsg411_linux_x86_64.bin for x86-64 installations. For Solaris 9 or 10, use ocsg411_solaris_sparc.bin for 32 bit installations and ocsg411_solaris_sparc_64.bin for 64 bit installations. |
Oracle Communications Services Gatekeeper ships with a generic installer that is primarily designed to be run on machines running HP-UX. If you are using the console based installer, do the following:
bin
directory of the appropriate JDK (installed separately) to the beginning of the PATH
variable definition on the target system. For example:PATH=JAVA_HOME/bin:$PATH
export PATH
Here JAVA_HOME
represents the full path to the JDK directory.
java -jar ./wlng400_generic.jar -mode=console
Note: | Once you have run the installer you must do the following two additional steps: |
WL_HOME
variable to the directory in which you installed your Oracle Communications product, and export WL_HOME
. For example:$ export WL_HOME=<your_installation_directory>/wlserver_10.3
cd $WL_HOME/server/native/hpux11/IPF32/
$WL_HOME/server/native
directory:$ chmod -R +x $WL_HOME/server/native/hpux11/
The installation program prompts you to enter specific information about your system and configuration. For instructions on responding to the prompts during installation, see the following table.
To complete the console-mode installation process, respond to the prompts in each section by entering the number associated with your choice or by pressing Enter to accept the default. To exit the installation process, enter exit (or x, for short) in response to any prompt. To review or change your selection, enter previous (or p, for short) at the prompt. To proceed to the following window, enter next (or n, for short).
Note: | In the sample console text and directory pathnames provided in this section, Windows conventions (such as backslashes in pathnames) are used, for example, C:\bea\weblogic. When entering pathnames on a UNIX system, be sure to use UNIX conventions, instead. For example, use forward slashes in pathnames, such as /home/bea/weblogic. |
Specify the BEA Home directory that will serve as the central support directory for all BEA products installed on the target system.
If you already have a BEA Home directory on your system, you can select that directory or create a new BEA Home directory.
|
|||
Enter the number next to the name(s) of the component(s) you do not wish to install and hit Enter. The screen refreshes, and the checkmark next to that component is removed. Continue until only the items you wish to install are checkmarked.
|
|||
Specify the directories in which you want to install the Oracle Communications Services Gatekeeper software. These are the directories from which information will be copied during the domain configuration phase. You can accept the default product directories or create a one or more new directories by selecting the product index number and then inputting the full path to that directory. The installer asks you to confirm your choice.
|
|||
Specify the Start menu folder in which you want the Start menu shortcuts created. You can select from the following options:
Selecting this option provides all users registered on the machine with access to the installed software. However, only users with Administrator privileges can create shortcuts in the All Users folder. Therefore, if a user without Administrator privileges uses the Configuration Wizard to create domains, Start menu shortcuts to the domains are not created. In this case, users can manually create shortcuts in their local Start menu folders, if desired. Press ALT+Y on the keyboard to select the All Users Start Menu. Selecting this option ensures that other users registered on this machine will not have access to the Start menu entries for this installation. Press ALT+N on the keyboard to select the Local User's start menu. |
|||
Silent-mode installation is a way of choosing installation settings only once and then using those settings to duplicate the installation on many machines. During installation in silent mode, the installation program reads your settings from an XML file that you create prior to beginning the installation. The installation program does not display any options during the installation process. Silent-mode installation works on both Windows and Linux/UNIX systems. Please note: Windows is only supported for dev/test environments. It is not supported for production.
Note: | For more information on Silent-mode installation, see Oracle WebLogic Server Installation Guide at http://download.oracle.com/docs/cd/E12840_01/common/docs103/install/index.html, which gives a description of silent mode installation for WebLogic Server in general. |
Use the following instructions if you wish to use the Silent Mode installer to install Oracle Communications Services Gatekeeper. You must do this for all servers.
The entries in the silent.xml file correspond to the prompts that you would see if you used one of the interactive modes above.
Note: | Incorrect entries in the silent.xml file can cause installation failures. To help you determine the cause of a failure, we recommend that you create a log file when you start the installation. |
The following is a sample version of a silent.xml file, corresponding to a Complete installation type. Your input may be slightly different, depending on your installation:
Note: | This sample calls out explicitly what is to be installed. If you use a more generic version, you may encounter an error similar to this in the log. |
com.bea.plateng.domain.script.ScriptException: The template to read must be a jar file containing a valid domain configuration
Note: | This error can be ignored.See the Oracle WebLogic Server Installation Guide for more information. |
<?xml version="1.0" encoding="UTF-8" ?>
<bea-installer>
<input-fields>
<data-value name="BEAHOME" value="/var/nightly/bea" />
<data-value name="COMPONENT_PATHS" value="Oracle Communications Services Gatekeeper|WebLogic Communications Server|WebLogic Server/Core Application Server| WebLogic Server/Third Party JDBC Drivers|WebLogic Server/Web 2.0 HTTP Pub-Sub Server|WebLogic Server/WebLogic JDBC Drivers|WebLogic Server/WebLogic Web Server Plugins|WebLogicServer/Administration Console|WebLogic Server/Configuration Wizard and Upgrade Framework"/>
<data-value name="INSTALL_NODE_MANAGER_SERVICE" value="no" />
<data-value name="WLNGEclipseConfig.dir" value="/var/nightly/bea"/>
</input-fields>
</bea-installer>
If you are using the silent installer on a Windows machine, do the following:
ocsg411_win_x86.exe -mode=silent -log=<full_path_name>install.log -silent_xml=<full_path_name>silent_xml [all on one line]
If you are using the silent installer on a UNIX/Linux machine, do the following:
chmod a+x ocsg411_<appropriate-platform-filename>.bin
./<filename.bin> -mode=silent -log=<full_path_name>install.log -silent.xml=<full_path_name>silent.xml [all on one line]
Note: | For Linux Redhat AS4, use ocsg411_linux_x86.bin for x86 installations and ocsg411_linux_x86_64.bin for x86-64 installations. For Solaris 9 or 10, use ocsg411_solaris_sparc.bin for 32 bit installations and ocsg411_solaris_sparc_64.bin for 64 bit installations. |
Oracle Communications Services Gatekeeper ships with a generic installer that is primarily designed to be run on machines running HP-UX:
bin
directory of the appropriate JDK to the beginning of the PATH
variable definition on the target system. For example:PATH=JAVA_HOME/bin:$PATH
export PATH
Here JAVA_HOME
represents the full path to the JDK directory.
java -jar ./ocsg411_generic.jar -mode=silent -silent_xml=/full_path_to_silent.xml [all on one line]
Note: | Once you have run the installer you must do the following additional two steps: |
WL_HOME
variable to the directory in which you installed your Oracle product, and export WL_HOME
. For example:$ export WL_HOME=<your_installation_directory>/wlserver_10.3
cd $WL_HOME/server/native/hpux11/IPF32/
$WL_HOME/server/native
directory:$ chmod -R +x $WL_HOME/server/native/hpux11/
When run in silent mode, the installation program generates exit codes that indicate the success or failure of the installation. These exit codes are shown in the following table:
If you are launching the silent-mode installation process from a script, you can choose to have these exit codes displayed to the console. The following provides a sample command file that invokes the WebLogic Platform installation in silent mode and echoes the exit codes to the console from which the script is executed.
rem Execute the installer in silent mode
@echo off
ocsg411_win_x86.exe
-mode=silent-log=<full_path_name>install.log -silent_xml=<full_path_name>silent.xml
@rem Return an exit code to indicate success or failure of installation
set exit_code=%ERRORLEVEL%
@echo.
@echo Exitcode=%exit_code%
@echo.
@echo Exit Code Key
@echo ---------------
@echo 0=Installation completed successfully
@echo -1=Installation failed due to a fatal error
@echo -2=Installation failed due to an internal XML parsing error
@echo.
You must now configure Oracle Communications Services Gatekeeper’s Administrative Domain. See Configuring the Domain for Oracle Communications Services Gatekeeper
Note: | If you wish to be able to start and stop servers remotely, for example by using the Administration Console, you must set up Node Manager on each server. The software for Node Manager is automatically installed along with WebLogic Server software when you use any of the installation methods. See Oracle WebLogic Server Managing Server Startup and Shutdown, at http://download.oracle.com/docs/cd/E12840_01/wls/docs103/server_start/ for more information on setting up and configuring Node Manager. |