firststeps command

The firststeps command starts the First steps console. The First steps console is a post-installation ease-of-use tool for directing WebSphere® Application Server Network Deployment elements from one place. Options display dynamically on the First steps console, depending on features that you install and the availability of certain elements on a particular operating system platform. Options include verifying the installation, starting and stopping deployment manager and application server processes, creating profiles, accessing the administrative console, launching the Migration wizard, accessing the online information center, and accessing the Samples gallery.

First steps overview

This version lets you start the Profile Management Tool to get started defining a cell, a management profile, and application servers for the cell. A cell consists of a deployment manager profile and a federated application server profile. You can also define standalone application servers. Each profile has its own First steps console.

A prompt to launch the First steps console displays on the last panel of the Profile Management Tool.

You can also start the First steps console from the command line as described later in this topic.

First steps consoles exist for the cell profile, the management profiles, the standalone application server profile, and the custom profile. The secure proxy profile only has a first steps console when installed and configured on a DMZ Secure Proxy Server node.
Table 1. Available options for Network Deployment.

Options that display on each First steps console are shown in the following table:

Option Product Profiles  
Cell * Management (deployment manager, administrative agent, and job manager) Standalone Application Server Custom Secure proxy
Cell Dmgr Cell Node
Installation verification No Yes No Yes Yes No Yes
Start and stop the deployment manager No Yes No Yes (deployment manager) No No No
Start and stop the server No No No No Yes No Yes
Administrative console No Yes (if available) No Yes (if available) Yes (if available) No Yes
Samples gallery (when feature exists) No Yes No No Yes No No
Information center Yes Yes Yes Yes Yes Yes Yes
Migration wizard Yes Yes Yes Yes Yes Yes No
Exit Yes Yes Yes Yes Yes Yes Yes
* When launching the First steps console from the Profile Management tool in a cell-creation flow, the dmgr instance is used.

Option descriptions

Installation verification
This option starts the installation verification test. The test consists of starting and monitoring the deployment manager or the standalone application server during its start up.

If this is the first time that you have used the First steps console since creating a deployment manager or standalone application server profile, click Installation verification to verify your installation. The verification process starts the deployment manager or the application server.

The Start the deployment manager option or the Start the application server option is unavailable while the IVT runs.

The IVT provides the following useful information about the deployment manager or the application server:
  • The name of the server process
  • The name of the profile
  • The profile path, which is the file path and the name of the profile
  • The type of profile
  • The cell name
  • The node name
  • The current encoding
  • The port number for the administrative console, which is 9060 by default
  • Various informational messages that include the location of the SystemOut.log file and how many errors are listed within the file
  • A completion message

Start the server
This option toggles to Stop the server when the application server runs.

This option displays when the First steps console is in a standalone application server profile or a cell profile.

After selecting the Start the server option, an output screen displays with status messages. The success message informs you that the server is open for e-business. Then the menu item toggles to Stop the server and both the Administrative console option and the Samples gallery option enable.

If you select the Start the server option, the Installation verification option is unavailable while the application server runs.

Start the deployment manager
This option toggles to Stop the deployment manager when the deployment manager runs.

This option displays when the First steps console is in a deployment manager profile or a cell profile.

After selecting the Start the deployment manager option, an output screen displays with status messages. The success message informs you that the deployment manager is open for e-business. Then the menu item changes to Stop the deployment manager.

If you select the Start the deployment manager option, the Installation verification option is unavailable while the deployment manager runs.

Start the administrative agent
This option toggles to Stop the administrative agent when the administrative agent runs.

This option displays when the First steps console is in an administrative agent profile.

After selecting the Start the administrative agent option, an output screen displays with status messages. The success message informs you that the administrative agent is open for e-business. Then the menu item changes to Stop the administrative agent.

If you select the Start the administrative agent option, the Installation verification option is unavailable while the administrative agent runs.

Start the job manager
This option toggles to Stop the job manager when the job manager runs.

This option displays when the First steps console is in a job manager profile or a cell profile.

After selecting the Start the job manager option, an output screen displays with status messages. The success message informs you that the job manager is open for e-business. Then the menu item changes to Stop the job manager.

If you select the Start the job manager option, the Installation verification option is unavailable while the job manager runs.

Administrative console
This option is unavailable until the application server or deployment manager runs.

The administrative console is a configuration editor that runs in one of the supported Web browsers. The administrative console lets you work with XML configuration files for the standalone application server or the deployment manager and all of the application servers that are in the cell.

To launch the administrative console, click Administrative console or point your browser to http://localhost:9060/ibm/console. Substitute the host name for localhost if the address does not load. Verify the installation to verify the administrative console port number, if 9060 does not load.

Avoid trouble [Windows Vista] [Windows 7] Avoid trouble: If you are installing the product on these operating systems, then you must disable IPv6 and restart the machine to view and log on to the administrative console. See IPv6 for Microsoft® Windows®: Frequently Asked Questions for more information on disabling IPv6.gotcha

The administrative console prompts for a login name. This is not a security item, but merely a tag to identify configuration changes that you make during the session. Secure signon is also available when administrative security is enabled.

The installation procedure in the information center cautions you to write down the administrative user ID and password when security is enabled during installation. Without the ID and password, you cannot use the administrative console or scripting.

Profile Management Tool
This option starts the Profile Management Tool, which can create standalone application server profiles, a management profile, a cell profile, a secure proxy profile, or a custom profile.

Each profile has its own administrative interface. A custom profile is an exception. A custom profile is an empty node that you can federate into a deployment manager cell and customize. No default server processes or applications are created for a custom profile.

Each profile also has its own First steps console except for the secure proxy profile. The location of the command is within the profile as described later in this topic.

Samples gallery
This option starts the Samples gallery. The option is unavailable until you start the application server. The option displays when you have installed the Samples during installation.

To launch the Samples gallery, click Samples gallery or point your browser to http://localhost:9080/WSsamples. The Web address is case sensitive.

Substitute your own host name and default host port number if the address does not load. Verify the port number by opening the administrative console and clicking Servers > Application servers > server_name > [Communications] Ports. Use the WC_defaulthost port number value or the WC_defaulthost_secure value instead of 9080, which is the default.

If you do not install the Samples during the initial installation of the product, the option does not display on the First steps console. You can perform an incremental installation to add the Samples feature. After adding the Samples, the option displays on the First steps console.

Information center for WebSphere Application Server
This option links you to the online information center.
Migration wizard
This option starts the Migration wizard, which is the graphical interface to the migration tools.

See the migration documentation for more information about the Migration wizard.

Exit
This option closes the First steps console.

Location of the command file

The location of the firststeps command that starts the First steps console for a profile is:

Parameters

No parameters are associated with this command.

Syntax for the firststeps command

Use the following syntax for the command:
  • [AIX] [HP-UX] [Linux] [Solaris] ./firststeps.sh
  • [Windows] firststeps.bat

Link tips

The following links exist on the First steps console for the WebSphere Application Server Network Deployment product:

Network Deployment provides different types of profiles. Not all profiles have all of the links shown in the table. See the previous description of available options for each profile.

Table 2. Links on the First steps console.

Links that display on the First steps console are shown in the following table:

Option Link
Installation verification Calls the ivt command.
The location of the installation verification test command is:
Start the server Calls the startServer command.
The location of the startServer command is:

When you have more than one application server on the same machine, the command starts the same application server that is associated with the First steps console.

Stop the server Calls the stopServer command.
The location of the stopServer command is:
Start the deployment manager Calls the startManager command.
The location of the startManager command is:

When you have more than one deployment manager on the same machine, the command starts the same deployment manager that is associated with the First steps console.

Stop the deployment manager Calls the stopManager command.
The location of the stopManager command is:
Administrative console Opens the default browser to the http://localhost:9060/ibm/console Web address.

When you have more than one application server on the same machine, the port varies. The First steps console starts the administrative console that is associated with the First steps console.

Avoid trouble [Windows Vista] Avoid trouble: If you are installing the product on the Windows Vista operating system, then you must disable IPv6 and restart the machine to view and log on to the administrative console. See IPv6 for Microsoft Windows: Frequently Asked Questions for more information on disabling IPv6 on Windows Vista.gotcha
Profile Management Tool
The command file name is:
Samples gallery Opens the default browser to the http://localhost:9080/WSsamples Web address.
Information center for WebSphere Application Server products Opens the default browser to the online information center.
Migration wizard Calls the migration command to start the Migration wizard.
The location of the migration command is:

The migration tools are also in the /migration folder on the supplements disk.




Related information
Configuring the product after installation
Using the installation verification tools
Reference topic Reference topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Jun 11, 2013 11:43:36 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v701sca&product=was-nd-mp&topic=rins_firststeps
File name: rins_firststeps.html