+

Search Tips   |   Advanced Search

Starting and logging off the administrative console

This topic describes how to set up the administrative console environment, to access the administrative console, and to log out of the administrative console.

To access the administrative console, first install WebSphere Application Server and the administrative console.

IBM recommends using the High Performance Extensible Logging (HPEL) log and trace infrastructure . We view HPEL log and trace information using the LogViewer .

(ZOS) The administrative console application is installed during the initial installation process.

You start the administrative console, access the console through a web browser, and then log into the administrative console. After you finish working in the administrative console, save your work and log out.


Tasks

  1. Start the desired administrative console by starting the server process that runs the console application.

    We can start an unfederated application server, an administrative agent server, a deployment manager server, or a job manager server.

    Check the SystemOut.log file of the server that runs the console application to verify that the console application starts successfully. If the console application starts successfully, we see the WSVR0221I: Application started: isclite message.

    (Dist) If we cannot start the administrative console because the console port conflicts with an application that is already running on the machine, change the port number in the installation root/profiles/profile name/config/cells/cell/nodes/node/serverindex.xml file and the installation root/profiles/profile name/config/cells/cell/virtualhosts.xml files. Change all the occurrences of the console port to a new port number. Alternatively, shut down the other application that uses the conflicting port before starting the WAS product.

    (iSeries) If we cannot start the administrative console because the console port conflicts with an application that is already running on the machine, use the chgwassvr script command to change the port number. Read about changing the ports associated with an application server for more information. Alternatively, shut down the other application that uses the conflicting port before starting the WAS product.

  2. Access the administrative console.

    1. Enable cookies in the web browser used to access the administrative console.

    2. Enable JavaScript.

      Enablement of JavaScript is required. We must enable JavaScript so that all the features of the administrative console are available.

      (Windows) Important: If the application server is on Windows Server 2008 and we are accessing the console with Microsoft Internet Explorer V8.0, disable the enhanced security configuration in the browser. Otherwise, the console does not work correctly. For further information about enhanced security, read material on the Microsoft website.

    3. (iSeries) In the same web browser, type http://your_fully_qualified_server:port_number/ibm/console, where your_fully_qualified_server is the fully qualified host name for the machine that contains the administrative server, and port_number is the administrative console port number. When the administrative console is on the local machine, your_fully_qualified_server can be localhost unless security is enabled. On Windows platforms, use the actual host name if localhost is not recognized. If security is enabled, your request is redirected to https://your_fully_qualified_server:port_number/ibm/console, where your_fully_qualified_server is the fully qualified host name for the machine that contains the administrative server, and port_number is the administrative console secure port number.

      The administrative consoles for an unfederated application server, the deployment manager and the administrative agent use 9060 as the default port number for an unsecure administrative console and 9043 as the default port number for a secure administrative console. Each new administrative console that we deploy during profile creation is assigned a new unsecure port number, and, if you enable security during profile creation, a new secure port number. Whichever unsecure administrative console you create first is assigned port 9060, as long as the port is available. Likewise, whichever secure administrative console you create first is assigned port 9043, as long as the port is available.

      The administrative console for the job manager uses 9960 as the default port number for an unsecure administrative console and 9943 as the default port number for a secure administrative console. Each new administrative console that we deploy during profile creation is assigned a new unsecure port number, and, if you enable security during profile creation, a new secure port number. Whichever unsecure administrative console you create first is assigned port 9960, as long as the port is available. Likewise, whichever secure administrative console you create first is assigned port 9943, as long as the port is available.

      For a listing of supported web browsers, see system requirements.

    4. In the same web browser, type http://your_fully_qualified_server:port_number/ibm/console.

      The your_fully_qualified_server string is the fully qualified host name for the machine that contains the administrative console. The administrative console can be for an unfederated application server, a deployment manager, an administrative agent, or a job manager. The port number for the port_number string is 9060 by default for the unfederated application server, the deployment manager, and the administrative agent. For the job manager, the port number for the port_number string is 9960 by default.

      (ZOS) If we cannot start the administrative console because the console port conflicts with an application that is already running on the machine, do one of the following actions:

      • Change the port number and propagate the number to the appropriate files:

        1. Change all the occurrences of the console port to a new port number. Make the port changes in the installation root/profiles/profile name/config/cells/cell/nodes/node/servers/server/serverindex.xml file and the installation root/profiles/profile name/config/cells/cell/virtualhosts.xml files.

        2. Run the ./wsc2n.sh script from the installation root/WebSphere/AppServer/bin directory. The ./wsc2n.sh script generates the was.env file, the control.jvm.options file, the servant.jvm.options file, and the adjunct.jvm.options file for each server and the was.env file for the location service daemon. These generated files will contain the updated administrative console port number.

      • Shut down the other application that uses the conflicting port before starting the WAS product.

      For a listing of supported web browsers, see system requirements.

    5. Wait for the administrative console to load into the browser.

      A login page displays after the administrative console starts.

  3. Log into the administrative console.

    The administrative console can be for an unfederated application server, a deployment manager, an administrative agent, or a job manager.

    1. If we are logging into the administrative console for the administrative agent, and you have registered at least one node with the administrative agent, select the node to administer, and click Continue.

      The node can be the administrative agent node or a node for one of the application servers registered to the administrative agent. After you select a node, the login procedure is the same as that for the other server types, and for administrative agents with no nodes registered.

    2. Enter your user name or user ID.

      The user ID lasts only for the duration of the session for which it is used to log in.

      Changes made to server configurations are saved to the user ID. Server configurations also are saved to the user ID if a session timeout occurs.

      Changes made to server configurations are saved to the user ID. Server configurations also are saved to the user ID if a session timeout occurs.

      If we enter an ID that is already in use and in session, we are prompted to do one of the following actions:

      • Log out the other user with the same user ID. We can recover changes made during the other user's session.
      • Return to the login page and enter a different user ID.

    3. If the console is secure, we must also enter a password for the user name. The console is secure if someone has taken the following actions for the console:

      • Specified security user IDs and passwords
      • Enabled global security

    4. Click OK.

  4. Log off the administrative console. Click System administration > Save changes to master repository > Save to save work. Then click Logout to exit the console.

    If we close the browser before saving your work, we can recover any unsaved changes the next time that you log in under the same user ID.

We have set up the administrative console environment, accessed the administrative console, and logged out of the administrative console.


What to do next

Use the administrative console to manage the product.


Subtopics


Related