4 Running the Installation Program in Console Mode

This chapter describes how to run the WebLogic Server installer in console mode in different operating system environments.

When installing WebLogic Server in console mode, 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) in response to any prompt. To review or change your selection, enter previous (or p) at the prompt. To proceed to the following window, enter next (or n).

Note:

In the sample console text and directory path names provided in this section, Windows conventions (such as backslashes in path names) are used, for example, C:\Oracle\MW_HOME\wlserver_version. When entering path names on a UNIX system, be sure to use UNIX conventions. For example, use forward slashes in path names, such as C:/Oracle/MW_HOME/wlserver_version.

This chapter contains the following sections:

Starting the Installation Program in Console Mode
Installing WebLogic Server in Console Mode
Running the Upgrade Installer in Console Mode

Starting the Installation Program in Console Mode

This section describes how to start the installation program in console mode in different environments. It contains the following sections:

Starting the Installation Program in Console Mode on Windows
Starting .bin Installation Programs in Console Mode
Starting .jar Installation Programs in Console Mode

Starting the Installation Program in Console Mode on Windows

To start the installation program in console mode on a Windows platform, follow these steps:

Log in to the target Windows system.
Open a command prompt window.
Go to the directory that contains the installation program.
Launch the installation by entering the name of the installation program.

For example, to start the WebLogic Server Package installer for Windows in console mode, enter

wls1036_win32.exe -mode=console

Note:

You can include the -log=full_path_to_log_file option in the command line to create a verbose installation log.

For more information, see Generating a Verbose Installation Log.

After a few moments, the installation program begins to install the software. Proceed to Installing WebLogic Server in Console Mode, to continue.

Starting .bin Installation Programs in Console Mode

To start the installation program in console mode using a .bin installation file, follow these steps:

Log in to the target UNIX system.
Go to the directory that contains the installation program.
Launch the installation by entering the following commands:

chmod a+x file_name.bin

./file_name.bin -mode=console

file_name.bin is the name of your installation program. For example, for WebLogic Server 10.3.6, the name of the Package installer file for Solaris is wls1036_solaris32.bin.

Note:

If you plan to install the Server Examples, you must include the following parameter in the installation command. Otherwise, the installation may take longer than expected.

-Djava.security.egd=file:/dev/./urandom

After a few moments, the installation program begins to install the software. Proceed to Installing WebLogic Server in Console Mode, to continue.

Starting .jar Installation Programs in Console Mode

To start the installation program in console mode using a .jar installation file, follow these steps.

Note:

If you are installing WebLogic Server on a 64-bit platform, see Installing WebLogic Server on 64-Bit Platforms Using a 64-Bit JDK, for more information.

If you are installing WebLogic Server on a UNIX or Linux operating system, you must include the following parameter in the installation command if you plan to install the Server Examples. Otherwise, the installation may take longer than expected.

-Djava.security.egd=file:/dev/./urandom

Log in to the target system.
Add the directory of the appropriate JDK to the PATH variable definition on the target system. For example, on UNIX or Linux systems, add the bin directory to the beginning of the PATH variable:

PATH=$JAVA_HOME/bin:$PATH; export PATH
Go to the directory where you downloaded the installation program.
Launch the installation by entering the following command:

java -jar file_name.jar -mode=console

file_name.jar is the name of the installation file.

After a few moments, the installation program begins to install the software. Proceed to Installing WebLogic Server in Console Mode, to continue.

Installing WebLogic Server on 64-Bit Platforms Using a 64-Bit JDK

If you are installing WebLogic Server on a 64-bit platform using a .jar installation program:

Add the directory of the appropriate JDK to the PATH variable definition on the target system. For example, on UNIX, add the bin directory of the appropriate 64-bit JDK to the beginning of the PATH variable definition on the target system:

JAVA_HOME=path_to_64-bit_JDK; export JAVA_HOME

PATH=$JAVA_HOME/bin:$PATH; export PATH
(UNIX or Linux only) Include the -d64 flag in the installation command when using a 32/64-bit hybrid JDK (such as for the HP-PA, HPIA, and Solaris64 platforms). For example, if installing in graphical mode using the Package installer:

java -d64 -jar wlsversion_generic.jar -mode=console
Run the java -version command (or java -d64 -version command on UNIX or Linux platforms using a 32/64-bit hybrid JDK) to ensure that your JAVA_HOME refers to a 64-bit JDK.
If you are using the Sun 64-bit JDK, use the following command to install WebLogic Server:

java -Xmx1024m -jar wlsversion_generic.jar -mode=console

Installing WebLogic Server in Console Mode

After starting the installation program, follow these steps to complete the installation:

At the Welcome: prompt, type next (or n), or press Enter to continue with the installation process.

The Choose Middleware Home Directory prompt is displayed.
Specify the Middleware home directory that will serve as the central support directory for all Fusion Middleware products (including WebLogic Server) installed on the target system. For information about the Middleware home directory, see Choosing a Middleware Home Directory.

One of the following is displayed on your system:
- If you have existing home directories on your system, a list of the directories is displayed.
  
  To use an existing home directory, enter the number associated with the home directory.
  
  To create a home directory, enter 1 or press Enter.
- If there are no Middleware home directories on your system, or you selected Create a new Middleware Home, do one of the following:
  
  To use the default home directory, enter next (or n), or press Enter.
  
  To create a home directory, enter the full path of the home directory, for example C:\Oracle\Middleware. If you specify a directory that does not exist, the installation program creates it for you.
The installation program displays the home directory you have specified.

On the command line, press Enter to accept your selection. Otherwise, enter 1 or 2 to return to the Choose Middleware Home Directory panel, where you can modify your entry.

After you have selected your home directory and confirmed your selection, the Register for Security Updates: prompt is displayed.
To register for security updates, you must have a valid My Oracle Support account. By registering for security updates, Oracle Support notifies you immediately of any security updates that are specific to your installation.

If you want to register for security updates:
1. Enter 1, and then enter the email address for your My Oracle Support account.
2. Enter 2, and then enter the password for your My Oracle Support account.
3. Verify that Receive Security Update is set to Yes. If it is set to No, enter 3, and then enter Yes.
If you do not want to register for security updates, Enter 3, and then enter No. You are prompted to confirm that you want to bypass initiation of the Configuration Manager. Enter Yes.
After making the selections for security updates, press Enter to continue.
- If you are performing an initial installation, the Choose Install Type prompt is displayed. Go to step 5.
- If you are adding components to an existing installation, the Choose Products and Components prompt is displayed. Go to step 6.
(This step applies only if you are doing an initial installation) Specify the type of installation you want to perform by entering the number associated with the install type.
- To select a Typical installation, enter 1 or press Enter and proceed to step 8.
- To select Custom installation, enter 2. The Choose Products and Components to install prompt is displayed. Go to step 6.
For more information about Typical and Custom installations, see Choosing the Type of Installation.
(This step applies only if you are doing an initial Custom installation) Select the components you want to install. Selected components are indicated by a check mark. By default, the following items are already selected for installation:
- WebLogic Server and all its subcomponents, except for Server Examples (1.11)
- Oracle Coherence/Oracle Coherence Product Files
If you are adding components or products, the text [Installed] is shown for any component that is already installed in the current Middleware home directory.

Note:
The installer displays the estimated size of the installation for the selected components.

To select a component that is not already selected, enter its associated number. For example, to select the WebLogic Server Server Examples, enter 1.11. A check mark appears next to the component.

To clear a component that is already selected, enter its associated number. For example, if the Third Party JDBC Drivers component is already selected, enter 1.7 to clear the selection.

When you select or clear components, the installation program checks for dependencies between the components and automatically modifies the list of selected components.

After selecting the required components, enter n or press Enter.
(This step applies only if you are doing an initial Custom installation.) The JDK Selection prompt is displayed. Select the JDK(s) you want to add. Currently selected JDKs are indicated by a check mark.
- To add a local JDK, enter 1, and specify the location of the JDK.
- To toggle the selection for an existing JDK, enter the appropriate number (2 or higher).
- To retain the current selection(s) and proceed with the installation, press Enter.
Wait while the installer searches for the required archive files.
The Choose Product Installation Directories prompt appears. Specify the directory in which you want to install the software.

Note:
If you are adding components to an existing installation, the Confirm Product Installation Directories prompt appears instead. You cannot change the directories; new components will be installed to the original product installation directory. Press Enter to continue.
- To accept the default product directories, press Enter to continue.
- To change a product installation directory:
  1. Enter the number for the product for which you want to change the installation directory.
  2. Type the full path of the installation directory, and press Enter.
  3. When done, press Enter to continue the installation.
(This step applies only if you are doing an initial Custom installation on Windows, and you have Administrator privileges.) The Install Node Manager as Windows Service prompt is displayed. To specify whether you want to install Node Manager as a Windows service:
- Enter 1 to install Node Manager as a Windows service. Then, at the prompt, enter the listen port for the Node Manager, or press Enter to accept the default (5556). If the Listen Port number you specify is being used by a running application, the installation program prompts you to enter a different Node Manager Listen Port number. You are prompted to confirm your selection.
- Enter 2 if you do not want to install Node Manager as a Windows service.
(This step applies only if you are doing an initial installation on Windows, and you have Administrator privileges.) The Choose Shortcut Location prompt is displayed. Specify the folder in which you want to create the Start menu shortcuts.

Do one of the following:
- Enter 1 or press Enter to create Start menu shortcuts in the All Users folder. This 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 WebLogic 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.
- Enter 2 to create shortcuts in your local user's Start menu folder. If you do so, other users registered on this machine will not have access to the Start menu entries for this installation.
When prompted to confirm your selection, enter 1 or press Enter to proceed with the installation. Otherwise, enter 2 to return to the previous panel, where you can modify your entry.
(This step does not apply if you are running an Upgrade installer.) The list of products and JDKs to be installed is displayed, as well as the estimated size of the installation.

Press Enter to continue.
The installation program begins copying the components you specified to your system.

Note:
It is normal for the installation program to pause for a long time, especially toward the end. The installation program is still working while this occurs.

After the installation completes, the following message is displayed:
```
Installation Complete
Congratulations! Installation is complete.
Press [Enter]to continue or type [Exit]>
```

Running the Upgrade Installer in Console Mode

If you are using an Upgrade installer, use the following steps to upgrade your installation in console mode.

Notes:

If you have an existing WebLogic Server 10.3.0, 10.3.1, 10.3.2, or 10.3.3 installation that includes Workshop for WebLogic, and you want to use an Upgrade installer to upgrade that installation to WebLogic Server 10.3.6, you must uninstall Workshop for WebLogic before running the Upgrade installer. See Chapter 7, "Uninstalling the Software," for more information.

If you do not remove Workshop prior to running the Upgrade installer, you can remove it after the upgrade only by reverting to the previous installation and running the WebLogic uninstall program to remove the WebLogic components. WebLogic Server 10.3.6 does not support removal of Workshop components.

When using an Upgrade installer to upgrade an existing WebLogic Server installation on Linux or UNIX operating systems, you must run the Upgrade installer using the same user ID as was used to perform the initial WebLogic Server installation.

Make backup copies of any files or applications that you have created in the WebLogic Server home directory. As part of the upgrade procedure, the installation program automatically overwrites any files, including applications, that you have created in this directory.

Note:
In some cases, changes are made in each domain's config.xml file between upgrade releases. You may want to make backup copies of the config.xml file in any domains you created, in case you later want to roll back or uninstall an upgrade installation.
Shut down any servers that are running.
Start the Upgrade installer as described in one of the following sections:
At the Welcome prompt, type n or press Enter to continue.
At the Choose Middleware Home Directory prompt, enter the number for the Middleware home directory that contains the WebLogic Server installation you want to upgrade, or enter 1 and then enter the full path to the Middleware home directory. Click Next.
To register for security updates, you must have a valid My Oracle Support account. By registering for security updates, Oracle Support notifies you immediately of any security updates that are specific to your installation.

If you want to register for security updates, at the Register for Security Updates prompt:
1. Enter 1, and then enter the email address for your My Oracle Support account.
2. Enter 2, and then enter the password for your My Oracle Support account.
3. Verify that Receive Security Update is set to Yes. If it is set to No, enter 3, and then enter Yes.
If you do not want to register for security updates, Enter 3, and then enter No. You are prompted to confirm that you want to bypass initiation of the Configuration Manager. Enter Yes.
After making your selections for security updates, press Enter.
At the Confirm Product Installation Directory prompt, click Next.
The Status screen is displayed to indicate the progress of the installation. When the installation completes, the Installation Complete message is displayed. Press any key to exit the installation program.
If you are using the JRockit SDK, Oracle recommends that you upgrade your domains to use the latest production version. See Configuring Domains to Use the Latest Version of JRockit.