> Installation Guide > Starting the Installation Program

Installation Guide

     Previous  Next    Open TOC in new window  Open Index in new window  View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Starting the Installation Program

This section describes the standalone installation of BEA AquaLogic Service Registry and all settings. To install the registry, type the following at a command prompt:

java -jar BEA-aqualogic-service-registry-2.1.0.jar

and follow the wizard panels. If you have associated javaw with *.jar files on Windows, just double-click the icon for the file BEA-aqualogic-service-registry-2.1.0.jar

 

Starting the Installation Program on Windows Platforms

The following sections describe how to start the installation program (for console and silent modes) on a Windows platform:

For information about installing in graphical mode, see Running the Installation Program in Graphical Mode.

Notes: If you are installing the software on a Windows system that supports more than one monitor, you must disable all but one monitor before starting the installation program.

Starting in Graphical Mode

  1. To install the registry, type the following at a command prompt:
    2. java -jar BEA-aqualogic-service-registry-2.1.0.jar

    and follow the wizard panels.

    Note: If you have associated javaw with *.jar files on Windows, just double-click the icon for the file BEA-aqualogic-service-registry-2.1.0.jar
  2. Proceed to Running the Installation Program in Graphical Mode.

Starting in Console Mode

To start the console-mode installation process on a Windows platform, follow these steps:

  1. Log in to the target Windows system.
  2. Complete the appropriate procedure in the following table:

    3. If you are installing from . . .
    Perform the following action . . .
    Web download
    1. Open an MS-DOS command prompt window.
    2. Go to the directory where you downloaded the installation program.
    CD-ROM
    1. Insert the software CD into the CD-ROM drive.

    Note: If autorun is enabled, the installation program may start automatically in graphical mode. You must exit the installation program to use console-mode installation.

    1. Open an MS-DOS command prompt window.
    2. Go to the CD-ROM directory and navigate to the folder for the Windows installation program.

  3. Launch the installation by entering one of the following commands:
    • java -jar BEA-aqualogic-service-registry-2.1.0.jar -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:
      • Note: BEA-aqualogic-service-registry-2.1.0.jar -mode=console -log=C:\logs\server_install.log
      Note: For more information, see Generating a Verbose Installation Log.

      After a few moments, a BEA Installer window opens and the installation program begins to install the software.

  4. Proceed to Running the Installation Program in Console Mode.

Starting in Silent Mode

For details about silent-mode installation, see What Is Silent-Mode Installation?.

To start the silent-mode installation process on a Windows platform, follow these steps:

  1. Log in to the Windows system.
  2. Create a silent.xml file that defines the configuration settings normally entered by a user during an interactive installation process, such as graphical-mode or console-mode installation. For information about creating a silent.xml file, see Creating a silent.xml File for Silent-Mode Installation.
    3. 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.
  3. Complete the appropriate procedure in the following table.

    4. If you are installing from . . .
    Perform the following action . . .
    Web download
    1. Open an MS-DOS command prompt window.
    2. Go to the directory where you downloaded the installation program.
    CD-ROM
    1. Insert the software CD into the CD-ROM drive.
    2. Open an MS-DOS command prompt window.
    3. Go to the CD-ROM directory and navigate to the folder for the Windows installation program.

  4. Launch the installation by entering the following command:

    5. java -jar filename.jar -mode=silent -silent_xml=path_to_silent.xml

    Here, filename.exe is the name of the BEA software installation file, and path_to_silent.xml is the full pathname of the silent.xml file.

    Note: You can also include the -log=full_path_to_log_file option in the command line to create a verbose installation log. For example:
    Note: java -jar BEA-aqualogic-service-registry-2.1.0.jar -mode=silent -silent_xml=C:\silent.xml -log=C:\logs\server_install.log
    Note: For more information, see Generating a Verbose Installation Log.

    A BEA Installer window is displayed, indicating that the files are being extracted. No other prompt or text is displayed.

    For more information, see Running the Installation Program in Silent Mode.

 

Starting the Installation Program on UNIX Platforms

The BEA Products installation program requires a Java run-time environment (JRE) to run. A JRE is bundled in the Windows installation program, and in some UNIX installation programs (those with filenames ending in .bin). For other UNIX platforms, the installation program does not include a JRE. Filenames for these installation programs end in .jar. To run the .jar installation programs, you must have an appropriate version of a JDK installed on your system, and include the bin directory of the JDK at the beginning of your PATH system variable.

Notes: It is important that you use a JDK because the installation process assigns values to JAVA_HOME and related variables to point to this directory. All scripts installed by your installation program use this JDK by default, including scripts to start sample applications, the Configuration Wizard, and other development tools.
Note: To run graphical-mode installation, your console must support a Java-based GUI. If the installation program determines that your system cannot support a Java-based GUI, it automatically starts running in console mode. For details, see Running the Installation Program in Console Mode.

The following sections describe how to start the installation program on UNIX platforms (for console and silent modes) using filenames that end in .jar:

For information about installing in graphical mode, see Running the Installation Program in Graphical Mode.

Starting Graphical-Mode Installation

To start the graphical-mode installation process for installation files with names ending in .jar, follow these steps:

  1. Log in to the target UNIX system.
  2. Add the bin directory of the appropriate JDK to the beginning of the PATH variable definition on the target system. For example:

    3. PATH=JAVA_HOME/bin:$PATH
    export PATH

    Here JAVA_HOME represents the full path to the JDK directory.

  3. Go to the directory where you downloaded the installation program.
  4. Launch the installation program by entering the following command:
    5. java -jar BEA-aqualogic-service-registry-2.1.0.jar

    and follow the wizard panels.

  5. Launch the installation program by entering the following command:

    6. java -jar BEA-aqualogic-service-registry-2.1.0.jar

    Note: You can also include the -log=full_path_to_log_file option in the command line to create a verbose installation log. For example:
    Note: BEA-aqualogic-service-registry-2.1.0.jar -log=/home/logs/BEA_install.log
    Note: For more information, see Generating a Verbose Installation Log.

    The installation program begins to install the software.

  6. Proceed to Running the Installation Program in Graphical Mode.

Starting Console-Mode InstallationTo start the console-mode installation process for installation files with names ending in .jar, follow these steps:

  1. Log in to the target UNIX system.
  2. Add the bin directory of the appropriate JDK to the beginning of the PATH variable definition on the target system. For example:

    3. PATH=JAVA_HOME/bin:$PATH
    export PATH

    Here, JAVA_HOME represents the full path to the JDK directory.

  3. Go to the directory where you downloaded the installation program.
  4. Launch the installation by entering the following command:

    5. java -jar filename.jar -mode=console

    Here, filename.jar is the name of the BEA Products installation file, for example, BEA-aqualogic-service-registry-2.1.0.jar.

    Note: You can also include the -log=full_path_to_log_file option in the command line to create a verbose installation log. For example:
    Note: java -jar server910_generic.jar -mode=console
       -log=/home/logs/BEA_install.log
    Note: For more information, see Generating a Verbose Installation Log.
  5. Proceed to Running the Installation Program in Console Mode.

Starting Silent-Mode Installation

For details about silent-mode installation, see What Is Silent-Mode Installation?.

To start the silent-mode installation process for installation files with names ending in .jar, follow these steps:

  1. Log in to the target UNIX system.
  2. Create a silent.xml file that defines the configuration settings normally entered by a user during an interactive installation process, such as graphical-mode or console-mode installation. For information about creating a silent.xml file, see Creating a silent.xml File for Silent-Mode Installation.
    3. 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.
  3. Add the bin directory of the appropriate JDK to the beginning of the PATH variable definition on the target system. For example:

    4. PATH=JAVA_HOME/bin:$PATH
    export PATH

    Here, JAVA_HOME is the full path of the JDK directory.

  4. Go to the directory that contains the installation file.
  5. Launch the installation by entering the following command:

    6. java -jar filename.jar -mode=silent
    -silent_xml=/    path_to_silent.xml

    Here, filename.jar is the name of the BEA Products installation file (for example, BEA-aqualogic-service-registry-XXX.jar, where XXX represents the version number of the software you are installing) and path_to_silent.xml is the full path to the silent.xml file.

    Note: You can also include the -log=full_path_to_log_file option in the command line to create a verbose installation log. For example:
    Note: java -jar BEA-aqualogic-service-registry-2.1.0.jar -mode=silent -silent_xml=/home/silent.xml -log=/home/logs/BEA_install.log
    Note: For more information, see Generating a Verbose Installation Log.

    A BEA Installer window is displayed, indicating that the files are being extracted. No other prompt or text is displayed.

For more information, see Running the Installation Program in Silent Mode.

 

Generating a Verbose Installation Log

If you launch the installation from the command line or from a script, you can specify the -log option to generate a verbose installation log. The installation log stores messages about events that occur during the installation process, including informational, warning, error, and fatal messages. This type of file can be especially useful for silent installations.

Note: You may see some warning messages in the installation log. However, unless a fatal error occurs, the installation program completes the installation successfully. The installation user interface indicates the success or failure of each installation attempt, and the installation log file includes an entry indicating that the installation was successful.

Syntax

To create a verbose log file during installation, include the -log=full_path_to_log_file option in the command line. For example: 

java -jar BEA-aqualogic-service-registry-2.1.0.jar -log=C:\logs\server_install.log

The path must specify a file. You cannot create a folder simply by including a name for it in a pathname; your path should specify only existing folders. If your path includes a nonexistent folder when you execute the command, the installation program does not create the log file.

 

What's Next?

For details about running the installation program, see one of the following, depending on your selected installation mode:


  Back to Top       Previous  Next