Using the launchpad to start Liberty installations

The launchpad console is the starting point for installing WebSphere® Application Server Liberty .

Before you begin

  • The launchpad is a web application. Before using the launchpad, you must have a supported web browser. The launchpad supports the following browsers:
    • For LINUX platformsFor Solaris platformsFor HP UNIX platformsFor AIX platformsMozilla Firefox Version 3.5 or later
    • For Windows platformsInternet Explorer Version 6.0 Service Pack 2 or later
  • Install a supported web browser if one is not installed.
  • For LINUX platformsFor Solaris platformsFor HP UNIX platformsFor AIX platformsYou must install the Bash shell package to use the launchpad application. Although the Bash shell must be installed, the Bash shell does not need to be used to run the launchpad.sh command. If you attempt to run the launchpad application from a DVD on the HP-UX, Linux®, or Solaris operating systems without the Bash shell installed, the launchpad fails with an error message indicating that the Bash interpreter is not found. If you attempt to run the launchpad from any image on AIX®, the launchpad fails with an error message indicating that the current browser is not supported. The Bash package for the AIX operating system is included in the IBM® AIX Toolbox.
Examples of what the launchpad can do:
  • The launchpad does support installing Installation Manager in admin or non-admin (user) mode.
  • The launchpad does support updating Installation Manager from an earlier version in admin or non-admin (user) mode.
Examples of what the launchpad cannot do:
  • The launchpad does not support installing in group mode.
  • The launchpad does not support installing or updating with a custom application data location.
Restriction: You cannot run the launchpad remotely to install a product. Only local use of the launchpad is supported.

About this task

The launchpad identifies components on the product disk or image that you can install (launch).

The launchpad is a single point of reference for installing the application server environment. If you click a link that points to a product repository on another disk or image, you are prompted to insert that disk or browse to that image.

Procedure

  1. Start the launchpad.
    The launchpad program is available in the root directory of the product disk. You can start the launchpad manually using a fully qualified command instead of changing directories to the disk and running the command locally from the root directory:
    • For LINUX platformsFor Solaris platformsFor HP UNIX platformsFor AIX platformsMount the disk drive if necessary.
    • Open a shell window and issue a fully qualified launchpad command to start the launchpad.
      For Windows platformsTip: If you need to navigate using the keyboard, use Mozilla Firefox as your web browser and start the launchpad with the following command:
      launchpad_a11y.exe
    For Windows platformsNote: Some Windows operating systems such as Windows 2003, Windows Vista, Windows Server 2008, and Windows 7 have implemented a more restrictive security policy that denies access to trusted files by non-trusted files or applications. When the launchpad application is run as a non-trusted program, you will receive JavaScript Access is denied errors that subsequently cause the application to hang. Because downloaded images are automatically blocked, unblock the files so that the launchpad can successfully access the files. Before you extract the image, right-click the image file and select Properties to open the Properties panel and locate the security section and click the Unblock button. You can now extract the image and run the launchpad application.
    The launchpad opens in the language of the locale setting of the machine.
  2. Use the launchpad to perform the following Liberty related tasks.
    • View the Welcome page, and access links to the IBM WebSphere Application Server product documentation.
    • Launch IBM Installation Manager installation, and access the IBM Installation Manager product documentation.
    • Launch IBM Packaging Utility installation, and access the Packaging Utility information in the IBM Installation Manager product documentation.
    • Launch Installation Manager to install WebSphere Application Server Liberty, and access the installation instructions in the product documentation.
    • Launch Installation Manager to install IBM HTTP Server, and access the installation instructions in the product documentation.
    • Launch Installation Manager to install Web Server Plug-ins for IBM WebSphere Application Server, and access the installation instructions in the product documentation.
    • Launch Installation Manager to install the WebSphere Customization Toolbox, and access the installation instructions in the product documentation.
    • Access the latest version of IBM Support Assistant.
    • Launch Installation Manager to install IBM WebSphere Adapters.

Results

This procedure results in using the launchpad to start the installation and to access information through a browser.

Troubleshooting

If you can start the launchpad but clicking a link does not resolve to a page in the launchpad, you might have the wrong media in the disk drive. Check the validity of the media.

Use the following procedure to correct any error that is preventing the launchpad from displaying. Then, try to start the launchpad again:
  1. If the product disk is no longer accessible, insert the disk.
  2. For LINUX platformsFor Solaris platformsFor HP UNIX platformsFor AIX platformsMount the drive as necessary on platforms such as AIX or Linux.
  3. Enable the JavaScript function in your browser.
    Mozilla Firefox: Click Tools > Options > Content:
    • Select Enable Java.
    • Select Enable JavaScript.
    • Click Advanced and allow scripts to ... (Select all boxes.)

    For Windows platformsInternet Explorer: Click Tools > Internet Options > Security > Custom Level for Internet > Scripting > Active scripting > Enable.

  4. Restart the launchpad by issuing the launchpad command.

If the launchpad links still do not work after following this procedure, launch Installation Manager and point it at the appropriate repositories to install the offerings.

Distributed: [AIX MacOS Linux Windows]

What to do next

Go to Installing and uninstalling Liberty on distributed operating systems to continue installing your application serving environment.