WebSphere Enterprise Service Bus, Version 6.2.0 Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


Options on the First steps console

After installing WebSphere® ESB, use the First steps console to start product tooling, access product documentation, or direct elements such as servers and administrative consoles related to individual profiles. A generic version of the console, plus a version for each profile in your installation are available. Options on each console are displayed dynamically, depending on features you install and the availability of certain elements on particular operating systems. Options include verifying your installation, starting or stopping the server or deployment manager, accessing the administrative console, starting the Profile Management Tool, accessing the Samples gallery, accessing the product documentation, or starting the migration wizard.

Restrictions:
  • For i5/OS operating system On i5/OS® platforms: The i5/OS version of the First steps console does not have a migration wizard option.
  • The WebSphere ESB Client does not have an associated First steps console. The underlying WebSphere Application Server installation has its own First steps console.
Options that are displayed on the various types of First steps consoles are summarized in Table 1. Each option is defined in Option descriptions. Usage tips describes which commands each option calls.
Table 1. Available options on First steps consoles
Option Generic version Stand-alone server profile version Deployment manager profile version Custom profile version
Installation verification No Yes Yes No
Start and stop the server No Yes No No
Start and stop the deployment manager No No Yes No
Administrative console No Yes Yes No
Profile Management Tool Yes Yes Yes Yes
Samples gallery No Yes No No
Information center Yes Yes Yes Yes
Migration wizard Yes (except on i5/OS) Yes (except on i5/OS) Yes (except on i5/OS) Yes (except on i5/OS)
Copyright and trademark information Yes No No No
Exit Yes Yes Yes Yes

Option descriptions

Options that are displayed on the various versions of the First steps consoles are described here:
Installation verification
Starts the installation verification test. The test consists of starting and monitoring the stand-alone server or deployment manager during its start up.

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

The Start the server and Start the deployment manager options are unavailable while the Installation Verification Tool (IVT) runs.

The IVT provides the following useful information about the stand-alone server or deployment manager:
  • 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
  • Various informational messages that include the location of the SystemOut.log file and how many errors are listed within the file
  • A Health Monitor Report (only for stand-alone servers)
  • A completion message
Review more information about verifying your installation in Verifying the product installation and its child topics.
Start the server
Toggles to Stop the server when the server runs.

After selecting the Start the server option, an output screen is displayed with status messages. The success message informs you that the server is open for e-business. Then the menu item changes to Stop the server and both the Administrative console and Samples gallery options are enabled (if you installed them).

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

Start the deployment manager
Toggles to Stop the deployment manager when the deployment manager runs.

After selecting the Start the deployment manager option, an output screen is displayed 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 and the Administrative console option is enabled (if you installed it).

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

Administrative console
Displayed only if you deployed the Administrative console during profile creation or augmentation. This option is unavailable until you start the stand-alone server or deployment manager.

The administrative console is a configuration editor that runs in a Web browser. The administrative console lets you work with XML configuration files for the stand-alone server or deployment manager, and all of the applications that are in the cell.

To start the administrative console, select Administrative console.

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 procedures in the information center caution 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
Not available on 64-bit Linux® or Linux on System z® platforms. Starts the Profile Management Tool. The tool lets you create a stand-alone server, deployment manager, or custom profile.
A profile consists of files that define the runtime environment for the stand-alone server or deployment manager. Each profile has its own administrative interface. A custom profile is an exception. A custom profile is an empty node that you federate into a deployment manager cell and customize. No default server processes or applications are created for a custom profile.

Each profile has its own First steps console. The location of the command to start the First steps console is within the set of files in the profile. A prompt to start the First steps console that is associated with a profile is displayed on the last panel of the Profile Management Tool.

Samples gallery
Displayed only if you installed the WebSphere ESB samples during profile creation or augmentation. This option starts the WebSphere ESB Samples gallery in the administrative console. The option is unavailable until you start the server.

To start the Samples gallery, select Samples gallery.

If you did not install the WebSphere ESB 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 is displayed on the First steps console.

Information center
Links you to the online information center at http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/.
Migration wizard
Starts the WebSphere ESB version-to-version migration wizard, which is the graphical interface to the migration tools. The version-to-version migration wizard is a graphical interface that guides you through migrating from an older version to a newer version of WebSphere ESB. See the topic Migration wizard for more information about this interface.
Copyright and trademark information
Shows the copyright and trademark information for WebSphere ESB.
Exit
Closes the First steps console.

Usage tips

Table 2 shows which commands the options on the various WebSphere ESB First steps consoles call. For more information on selected individual commands, look up the command in the Command-line utilities section in the WebSphere Application Server Network Deployment information center:
  • startServer command
  • stopServer command
  • startManager command
  • stopManager command

The commands used to start the installation verification test, the First steps console, the Profile Management Tool, and the Migration wizard included in the WebSphere ESB product have different names, exist in different directory locations, or perform different functions than the equivalent WebSphere Application Server Network Deployment commands. Therefore, links to those commands in the WebSphere Application Server Network Deployment information center are not provided here.

Table 2. Commands called by First steps console options
Option Link
Installation verification Calls the wbi_ivt command.
The location of the installation verification test command is:
  • For i5/OS operating system On i5/OS platforms: profile_root/bin/wbi_ivt -username username -password password
    Note: The username and password parameters are mandatory for the iSeries® platform if security is enabled. They are optional for Linux, UNIX®, and Windows® platforms, but you will be prompted for their values if security is enabled.
  • For Linux operating systemFor UNIX operating system On Linux and UNIX platforms: profile_root/bin/wbi_ivt.sh
  • For Windows operating system On Windows platforms: profile_root\bin\wbi_ivt.bat
Start the server Calls the startServer command.
The location of the startServer command is:
  • For i5/OS operating system On i5/OS platforms: profile_root/bin/startServer
  • For Linux operating systemFor UNIX operating system On Linux and UNIX platforms: profile_root/bin/startServer.sh
  • For Windows operating system On Windows platforms: profile_root\bin\startServer.bat

When you have more than one stand-alone server on the same workstation, the command starts the stand-alone server that is associated with the same profile as in the First steps console.

Stop the server Calls the stopServer command.
The location of the stopServer command is:
  • For i5/OS operating system On i5/OS platforms: profile_root/bin/stopServer
  • For Linux operating systemFor UNIX operating system On Linux and UNIX platforms: profile_root/bin/stopServer.sh
  • For Windows operating system On Windows platforms: profile_root\bin\stopServer.bat
Start the deployment manager Calls the startManager command.
The location of the startManager command is:
  • For i5/OS operating system On i5/OS platforms: profile_root/bin/startManager
  • For Linux operating systemFor UNIX operating system On Linux and UNIX platforms: profile_root/bin/startManager.sh
  • For Windows operating system On Windows platforms: profile_root\bin\startManager.bat

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

Stop the deployment manager Calls the stopManager command.
The location of the stopManager command is:
  • For i5/OS operating system On i5/OS platforms: profile_root/bin/stopManager
  • For Linux operating systemFor UNIX operating system On Linux and UNIX platforms: profile_root/bin/stopManager.sh
  • For Windows operating system On Windows platforms: profile_root\bin\stopManager.bat
Administrative console Opens the default browser to the administrative console Web address.

When you have more than one server on the same workstation (or on the same logical partition on i5/OS), the port varies. The First steps console starts the administrative console that is associated with the same profile as in the First steps console.

Profile Management Tool Calls the pmt command.
The location of the pmt command is:
  • For i5/OS operating system On i5/OS platforms: The pmt command is run from the Windows workstation. The command is found in one of two locations:
    • install_image_location\WBI\iSeries\PMT\pmt.bat, where the install_image_location is either the path to the disc media or the location into which the Passport Advantage® image was downloaded
    • pmt_client_installation\PMT\pmt.bat, which is by default C:\ProgramFiles\IBM\WebSphere\PMTClient
  • For Linux operating systemFor UNIX operating system On Linux and UNIX platforms: install_root/bin/ProfileManagement/pmt.sh
  • For Windows operating system On Windows platforms: install_root\bin\ProfileManagement\pmt.bat
Samples gallery Opens the default browser to the Samples Web address.
Information center Opens the default browser to the online information center at the http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/ Web address.
Migration wizard Calls the WebSphere ESB version-to-version migration script to start the migration wizard.
The location of the version-to-version migration script is:
  • For Linux operating systemFor UNIX operating system On Linux and UNIX platforms: install_root/bin/wbi_migration.sh
  • For Windows operating system On Windows platforms: install_root\bin\wbi_migration.bat

concept Concept topic

Terms of use | Feedback


Timestamp icon Last updated: 21 June 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/cins_firststeps.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
This information center is powered by Eclipse technology (http://www.eclipse.org).