WebSphere

 

Portal Express, Version 6.0
Operating systems: i5/OS, Linux, Windows

 

Install with a new instance of WebSphere Application Server

This Quick Installation Scenario takes you through a basic installation of IBM® WebSphere® Portal Express, with an emphasis on getting it up and running quickly. At the end of the scenario, you can login and start using WebSphere Portal Express or follow links to learn about configuring security or collaborative components.

Before you begin, review Planning for deployment, Supported hardware and software for WebSphere Portal Express Version 6.0, Preparing your operating system, and Choosing an installation source.

These instructions assume that you are installing WebSphere Portal Express on a clean machine, having no previous versions of WebSphere Portal Express or its component products, such as IBM WebSphere Application Server or DB2.

 

To install with a new instance of WebSphere Application Server, follow these instructions.

When installing on Linux, if you install WebSphere Portal Express into a directory that does not have write permissions, the installation is not affected and proceeds normally. This is because the installation is performed with the root user, which always has full permissions over files.

  1. If you are installing on a machine with a firewall enabled, disable the firewall before beginning the installation. If you do not disable the firewall and the installation program detects it, a warning message displays during the installation.

  2. Choose one of the following options to start the installation program through the launchpad:

    The launchpad has links that you can use to review system requirements and learn more about the product before you begin installation.

    • Use the Quick Start Setup discIf you have the Setup disc, perform the steps that are appropriate for your operating system:

      • Linux:

        Insert the Setup disc, and then run the ./setup.sh command from the root directory of the CD.

        When installing with CD-ROM discs, ensure that you do not have an open shell in the CD directory. This can interfere with the installation when the installation program requires you to change discs.

      • Windows:

        Insert the Setup disc into the CD-ROM drive. The installation program automatically starts when you insert the Setup disc. If the autostart function is disabled, run the following command from the root directory of the CD: 

        setup.exe

    • Access the downloaded product code

      If you downloaded the product code, perform the steps that are appropriate for your operating system:

      • Linux:

        Run the following command from the root directory of the Quick Start Setup image that you downloaded and extracted to your server's hard drive: 

        ./setup.sh

      • Windows:

        Run the setup.exe command from the root directory of the Quick Start Setup image that you downloaded and extracted to your server's hard drive.

    If you prefer to bypass the launchpad (for example, if you are installing in a console-only environment), you can start installation directly as follows: Run the appropriate command from the PortalExpress directory on the Quick Start Setup CD (if you are using the disc) or image (if you are using downloaded product code):

    • Linux:

      ./install.sh

    • Windows:

      install.bat

    • i5/OS:

      install400.bat

  3. Optional: When the Welcome panel displays, select a different language from the Language selection drop-down menu.

  4. Use the navigation links to explore the launchpad. For example, to access a high-level summary of the installation process with step-by-step instructions for setting up a basic, working WebSphere Portal Express, click Quick Start. To review system requirements and verify that your machine is ready for installation, click Prerequisite Information.

  5. When you are ready to begin installation, click Install and then click the option to launch the installation wizard for your platform.

  6. Select the language for the installation and click OK.

  7. When the welcome panel displays, click Next to continue.

  8. Select the option to accept the terms of the license agreement. Click Next. The installation program checks the machine for operating system and software prerequisites.

  9. Select Typical, and click Next.

  10. Specify the directory where you want to install WebSphere Portal Express. The directory that you specify must NOT exist; it will be created during the installation. If you are installing on Windows, do not include periods (.) or special characters in the installation path, and avoid using a long path name. Click Next.

    The installation program automatically installs the DB2 program files under the directory that you specify. In addition, it creates a database for WebSphere Portal Express data and stores this database in a directory that matches the DB2 administrator user name. By default, the installation program uses a preconfigured DB2 administrator user name (wpdb2ins), so it stores the database in a directory with that name (wpdb2ins). However, if a different DB2 administrator user name is required, the installation program creates the database in a directory that matches that name. To reduce the amount of time needed to install on Windows, the directory that contains the database is always located on the C: drive, no matter where you install WebSphere Portal Express.

  11. Specify the following WebSphere Application Server information, and then click Next:

    • Enter the cell name.

    • The node within the WebSphere Application Server cell where you want the WebSphere Portal Express application server to be installed. This value must be unique among other node names in the same cell. Typically, this value is the same as the host name for the computer.

    • The fully qualified host name or IP address of the computer that is running WebSphere Application Server.

  12. Enter the user ID and password for the WebSphere Portal Express and WebSphere Application Server administrator. Click Next.

    • Ensure that the administrator user ID and password that you type conforms to the recommendations that are specified in Special characters in user IDs and passwords and to any restrictions that are specific to your operating system.

    • The password that you specify here will also be used by the DB2 administrator user ID that the installation program creates.

    • Do not use blanks in either the user ID or the password, and ensure that the password is at least five characters in length. This user ID is used to access WebSphere Portal Express and WebSphere Application Server with administrator authority after installation.

    • This user ID is only used to log in to WebSphere Portal Express and WebSphere Application Server and is not related to any user IDs that are used to access the operating system.

  13. If the default DB2 administrator ID (wpdb2ins) already exists on the system because of a prior installation, the installation program prompts you to specify a different administrator ID and password. To continue, click Next, enter the new DB2 administrator ID and password, and then click Next.

    Ensure that the user ID and password conform to your organization's policies, including minimum password length and complexity. Failure to conform can result in a failed installation.

  14. Verify the components to be installed and click Next.

    When you install for the first time on the current machine, the installation program sets the DB2 administrator ID to a preconfigured name (wpdb2ins). The DB2 administrator ID uses the same password that you specified earlier for the WebSphere Portal Express and WebSphere Application Server administrator ID.

    The installation program begins installing the selected components. Throughout the installation and configuration process, the installation program displays progress indicators for the different components.

  15. When the installation is finished, the installation program displays a confirmation panel listing the components that have been installed. Write down the following information before clicking Finish:

    • The port number that is used to access WebSphere Portal Express is displayed on the confirmation panel. Write down the port number for use in verifying the WebSphere Portal Express URL. This value is also stored in the WpsHostPort property in the portal_server_root/config/wpconfig.properties file.

    • If you want to use the WebSphere Portal Express First Steps, ensure that Launch First Steps is selected. From First Steps you can access WebSphere Portal Express or read the documentation.

    • To enable LDAP security, transfer data to a different database, or run the Member Fixer tool, select Launch advanced configuration wizard.

  16. Click Finish.

  17. To verify that WebSphere Portal Express is running, open the following URL in a browser: http://example.com:port_number/wps/portal, where example.com is the fully qualified host name of the machine that is running WebSphere Portal Express and port_number is the port number that is displayed on the confirmation panel. For example, http://www.ibm.com:10038/wps/portal.

    At this point you are running with security enabled.

  18. IBM recommends that you install any manual fixes for WebSphere Application Server at this time. Refer to Supported hardware and software for manual fixes that should be applied.

  19. By default WebSphere Portal Express uses the internal HTTP transport within WebSphere Application Server to handle requests, but if you have an external Web server, such as IBM HTTP Server, you can configure WebSphere Portal Express to use the Web server. Refer to Setting up a Web server with WebSphere Portal Express for instructions.

 

Next steps

At this point, you can login and start using WebSphere Portal Express or you can continue to extend your WebSphere Portal Express environment.

 

Parent topic:

Installing on Windows and Linux