Installing and uninstalling the administrative console

We can install the administrative console during profile creation or after we create a profile. We can uninstall any administrative console that you install. To install an administrative console after profile creation, or to uninstall the administrative console, use the wsadmin command. This topic discusses how to use the wsadmin command to install and uninstall the administrative console.

If we install the administrative console through the wsadmin command, a profile that does not have an administrative console installed must exist.

Run the deployConsole script on the wsadmin command whenever to uninstall the administrative console, or whenever to install the administrative console to a profile that does not have an administrative console installed.

We can run the script in either connected or disconnected mode.

Unfederated application servers, administrative agents, deployment managers, and job managers can have their own administrative consoles. The steps in this task apply to these consoles.

The usual security restrictions for the wsadmin command apply to this script. In connected mode, the user must authenticate if security is enabled.

To install or uninstall the dmgr console, the wsadmin command attempts to remotely connect to the deployment manager. However, various situations can keep the wsadmin command from connecting to the deployment manager, and an error message results. The command cannot connect if:

• The deployment manager is not running.

• The deployment manager is running, but the script was run somewhere other than on the deployment manager. We are most likely running the script on a federated node.

(iseries)

(zos) The deployConsole.py script is located in the profile_root/bin directory.

The deployConsole.py script is located in the profile_root\bin directory.

• To install the administrative console, issue the following command:
  wsadmin.bat -f deployConsole.py install

  (zos)

  wsadmin.sh -f deployConsole.py install

  (iseries)

  wsadmin -f deployConsole.py install

• To uninstall the administrative console, issue the following command:
  wsadmin.bat -f deployConsole.py remove

  (zos)

  wsadmin.sh -f deployConsole.py remove

  (iseries)

  wsadmin -f deployConsole.py remove

Results

The administrative console is installed or uninstalled, depending on whether specified the install or remove option.

Related tasks

Use the administrative console

Start and logging off the administrative console

Configure port settings

wsadmin scripting tool