firststeps command

firststeps command

+
Search Tips | Advanced Search

The firststeps command starts the First steps console. 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 appserver processes
Creating profiles
Accessing the console
Launching the Migration wizard
Accessing the online information center
Accessing the Samples gallery

First steps overview

This version lets you start the Profile Management tool to get started defining a cell, a deployment manager, and appservers for the cell. A cell consists of a deployment manager profile and a federated appserver profile. You can also define stand-alone appservers. 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 deployment manager profile, the stand-alone appserver profile, and the custom profile. Options that display on each First steps console are shown in the following table:

Available options for ND

Option Product Profiles
Cell * Deployment Manager Stand-Alone Application Server Custom
Cell Dmgr Cell Node

Installation verification No Yes No Yes Yes No
Start and stop the deployment manager No Yes No Yes No No
Start and stop the server No No No No Yes No
Administrative console No Yes No Yes Yes No
Profile Management tool Yes Yes Yes Yes Yes Yes
Samples gallery (when feature exists) No Yes No No Yes No
Information center Yes Yes Yes Yes Yes Yes
Migration wizard Yes Yes Yes Yes Yes Yes
Exit 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 stand-alone appserver during its start up.
If this is the first time that you have used the First steps console since creating a deployment manager or stand-alone appserver profile, click Installation verification to verify your installation. The verification process starts the deployment manager or the appserver.
The options...
Start the deployment manager
Start the appserver

...are unavailable while the IVT runs. The IVT provides the following useful information about the deployment manager or the appserver:

The name of the server process:

cellmgr
cellnode
dmgr
server1

The name of the profile

The profile path, which is the file path and the name of the profile

The type of profile:

cellmgr
cellnode
dmgr
default

The cell name

The node name

The current encoding

The port number for the 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 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 server

This option toggles to Stop the server when the appserver runs.
This option displays when the First steps console is in a stand-alone appserver 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 appserver runs.

Administrative console

This option is unavailable until the appserver or deployment manager runs.
The 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 stand-alone appserver or the deployment manager and all of the appservers that are in the cell.
To launch the 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 console port number, if 9060 does not load.
The 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 console or scripting.

Profile Management tool

This option starts the Profile Management tool. The PMT creates...

stand-alone appserver profiles
deployment manager profile
cell profile,
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. 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 appserver. 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 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 WAS

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.
The migration tools are described in WASPreUpgrade command and WASPostUpgrade command.
See Use the Migration wizard to migrate product configurations 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:

profile_root/firststeps/firststeps.sh

profile_root\firststeps\firststeps.bat

Parameters

No parameters are associated with this command.

Syntax for the firststeps command
Use the following syntax for the command:

./firststeps.sh

firststeps.bat

Link tips

The following links exist on the First steps console for the WAS ND product:
ND 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.

Option Link

Installation verification Calls the ivt command.The location of the installation verification test command is:

profile_root/bin/ivt.sh

profile_root\bin\ivt.bat

Start the server Calls the startServer command.The location of the startServer command is:

profile_root/bin/startServer.sh server1

profile_root\bin\startServer.bat server1

When you have more than one appserver on the same machine, the command starts the same appserver that is associated with the First steps console.
Stop the server Calls the stopServer command. The location of the stopServer command is:

profile_root/bin/stopServer.sh server1

profile_root\bin\stopServer.bat server1

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

profile_root/bin/startManager.sh

profile_root\bin\startManager.bat

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:

profile_root/bin/stopManager.sh

profile_root\bin\stopManager.bat

Administrative console Opens the default browser to...
http://localhost:9060/ibm/console

When you have more than one appserver on the same machine, the port varies. The First steps console starts the administrative console that is associated with the First steps console.
Profile Management tool The command file name is:

app_server_root/bin/ProfileManagement/pmt.sh

app_server_root/bin/ProfileManagement/pmt.bat

Samples gallery Opens the default browser to...
http://localhost:9080/WSsamples

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:

app_server_root/bin/migration.sh

app_server_root\bin\migration.bat

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

Related information
Configure the product after installation
Use the installation verification tools
Create profiles through the graphical user interface

Option	Product	Profiles
Cell *	Deployment Manager	Stand-Alone Application Server	Custom
Cell Dmgr	Cell Node
Installation verification	No	Yes	No	Yes	Yes	No
Start and stop the deployment manager	No	Yes	No	Yes	No	No
Start and stop the server	No	No	No	No	Yes	No
Administrative console	No	Yes	No	Yes	Yes	No
Profile Management tool	Yes	Yes	Yes	Yes	Yes	Yes
Samples gallery (when feature exists)	No	Yes	No	No	Yes	No
Information center	Yes	Yes	Yes	Yes	Yes	Yes
Migration wizard	Yes	Yes	Yes	Yes	Yes	Yes
Exit	Yes	Yes	Yes	Yes	Yes	Yes

Option	Link
Installation verification	Calls the ivt command.The location of the installation verification test command is: profile_root/bin/ivt.sh profile_root\bin\ivt.bat
Start the server	Calls the startServer command.The location of the startServer command is: profile_root/bin/startServer.sh server1 profile_root\bin\startServer.bat server1 When you have more than one appserver on the same machine, the command starts the same appserver that is associated with the First steps console.
Stop the server	Calls the stopServer command. The location of the stopServer command is: profile_root/bin/stopServer.sh server1 profile_root\bin\stopServer.bat server1
Start the deployment manager	Calls the startManager command. The location of the startManager command is: profile_root/bin/startManager.sh profile_root\bin\startManager.bat 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: profile_root/bin/stopManager.sh profile_root\bin\stopManager.bat
Administrative console	Opens the default browser to... http://localhost:9060/ibm/console When you have more than one appserver on the same machine, the port varies. The First steps console starts the administrative console that is associated with the First steps console.
Profile Management tool	The command file name is: app_server_root/bin/ProfileManagement/pmt.sh app_server_root/bin/ProfileManagement/pmt.bat
Samples gallery	Opens the default browser to... http://localhost:9080/WSsamples
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: app_server_root/bin/migration.sh app_server_root\bin\migration.bat The migration tools are also in the /migration folder on the supplements disc.