A Using Console Mode

This appendix describes how start the Configuration Wizard in console mode. It also describes how to navigate in console mode, as well as perform various actions such as selecting items in a list or table. You can use console mode to create or extend a domain if your environment is not GUI-based.

Note:

In situations where you cannot run the Configuration Wizard in GUI mode, Oracle recommends that you use a WLST script to create or extend a domain. For more information, see "Creating and Using a Domain Template (Offline)" in Oracle WebLogic Scripting Tool.

This appendix contains the following sections:

Before You Begin

Prior to running the Configuration Wizard to create a domain on a UNIX or Linux operating system, if you have not already done so, set the CONFIG_JVM_ARGS environment variable as follows:

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

This decreases the amount of time it takes for the Configuration Wizard to create or update a domain.

Starting the Configuration Wizard in Console Mode

When run in console mode, the Configuration Wizard is executed in a text-based environment.

To start the Configuration Wizard in console mode:

  1. Log in to the system on which the product installation resides.

  2. Open an MS-DOS command prompt window (on Windows) or a command shell (on UNIX).

  3. Go to the following directory:

    On Windows: WLHOME\common\bin

    On UNIX: WLHOME/common/bin

    where WLHOME is the directory in which WebLogic Server is installed.

  4. Execute the following command:

    • Windows: config.cmd -mode=console

    • UNIX: sh config.sh -mode=console

    The command and arguments must be entered in lowercase.

    Note:

    When you run the config.cmd or config.sh command, the following error message might be displayed to indicate that the default cache directory is not valid:

    *sys-package-mgr*: can't create package cache dir

    You can change the cache directory by including the -Dpython.cachedir=<valid_directory> option in the command line.

The Welcome text is displayed.

Respond to each prompt as appropriate. Refer to the next section for general information about how to respond to console mode prompts.

Responding to Console Mode Prompts

In console mode, you are presented with a series of prompts, tables, and lists which allow you to configure your domain as desired. The various actions you can perform are described as follows:

  • The following common key entries are available throughout the Configuration Wizard:

    • To accept a current selection or configuration and continue to the next prompt, enter next (or n).

    • To close the Configuration Wizard, enter exit (or x).

    • To return to a previous prompt to review or change a selection, enter previous (or p).

  • If you are prompted to enter a directory path, or the path to a file name, enter the full path. On Windows systems, you must include the drive letter in the path.

  • When you are presented with a list of commands, such as Accept or Discard, you must enter the entire command.

  • For some prompts, you select from a list of options by entering the number of the desired option. The selected option is indicated by a check mark.

  • In some cases, you must select one or more items in a list by entering the number (such as 1, 1.1, or 2.1.1) shown in square brackets. Enter each number one at a time, exactly as shown in the brackets. A check mark is displayed next to each selected item. You can toggle the check mark on an off for a given item in the list by re-entering the number in brackets.

  • For some prompts, you are presented with a list of possible settings. Enter the number for the setting you want to use.

  • For some prompts, you are presented with a numbered list of configuration settings. To select the setting you want to change, enter the number for that setting, and then enter the value you want to use.

  • If a list of items (such as a list of schemas or data sources) is presented in a table, select the item you want to configure by entering the table row number for that item. Your selection is indicated by an arrow (->).

  • If a list of configuration settings is displayed:

    • Select the setting you want to change by entering the appropriate number.

    • Enter the value for the setting.

    • Repeat until all settings are as desired.

    • Enter n to continue to the next prompt.

  • If a table of configuration settings is displayed:

    • Select the setting you want to change by entering the appropriate row number.

    • Enter the value for the setting.

    • Repeat until all settings are as desired.

    • Review the settings to ensure they are accurate.

    • Enter Accept to accept the configuration.

    • Enter n to continue to the next prompt.

  • For some prompts, you have to enter a number to select an operation (such as Add, Modify, or Delete), which then determines the next sequence of displayed prompts.

  • For some prompts, such as selecting the servers to add to a cluster or a machine, you can enter a single value, a range of contiguous values, or both:

    • To select a single item, simply enter the number for the item.

    • To select multiple non-contiguous items, enter each value separated by a comma. For example to select items 1, 3, and 5, enter 1, 3, 5.

    • To select a contiguous range of items, enter the low and high values of the range, separated by a hyphen. For example, to select items 2, 3, and 4, enter 2-4.

    • To select both single items and a range of contiguous items, separate each by a comma. For example to select item 1 and items 3-5, enter 1, 3-5.