WebSphere

 

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

 

Install remotely with the graphical interface

With the WebSphere Portal Express graphical installation program, you can install WebSphere Portal Express from a Windows workstation connected to your System i5 system.

Notes on installing WebSphere Portal Express remotely with the graphical interface

Installing WebSphere Portal Express

To install WebSphere Portal Express, follow the instructions below:

  1. If you are installing from a PC with a firewall enabled, it is recommended that you disable the firewall before beginning installation.

  2. IBM recommends that you end any applications running on the PC before beginning the installation program. If applications remain active, it may be necessary to minimize the windows in order to see the signon screen.

  3. Insert the Quick Start Setup disc into the CD-ROM drive of your Windows 2000 or Windows XP workstation. If the autostart function is enabled on your PC, the installation program should automatically start, and in this case cancel the activated install. If the autostart function is not active or working, or the activated install has been cancelled, manually launch the program by running the setup.exe file from the PortalExpress directory of the CD.

  4. A small i5/OS signon box will prompt you to enter your System i5 system name, user ID, and password.

    The ID you use to sign on must be of the user type (user class) *SECOFR. To check the level of authority, type the command DSPUSRPRF userID.

    • Place the mouse pointer inside the SYSTEM entry field, press the left mouse button, and enter the system name.

    • Tab into or press the left mouse button on the User ID entry field and enter your User ID.

    • Tab into or press the left mouse button on the Password entry field and enter your password.

    • When you have entered the information, tab to or press the OK button and press Enter.

    If you are prompted to change your password because your password has expired or is about to expire, cancel and exit the installation program. Log on to your i5/OS system using a 5250 session, update your password, and restart the installation program. Do not use the installation program's change password prompt, as it could cause your installation to fail.

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

  6. 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.

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

  8. Review the license agreement. Select I accept the terms of the licensing agreement and press Next.

  9. Select an install option: Install and Configure or Install only and press Next. Selecting either option will copy WebSphere Portal Express binary files from the install CDs or filesystem into the ProdData path for portal_server_root_prod directory. The Install and Configure option will continue to fully install a pre-configured WebSphere Portal Express on an existing WebSphere Application Server profile. The Install only option stops after the copy of files.

  10. The installation program will search for an installed WebSphere Application Server. In the event that there is more than one application server, you will be given the option to select the application server on which to install WebSphere Portal Express. If none is detected, exit the installation program and first install an edition of WebSphere Application Server. Select from the list the WebSphere Application Server edition that you installed and on which you wish to install WebSphere Portal Express; selecting either WebSphere Application Server - Base or WebSphere Application Server - Network Deployment. If you installed WebSphere Application Server - Express, select -Base, because the file system is shared between these two editions.

    1. For either option Install and Configure or Install only: The appropriate binary file will be copied from the install CDs or filesystem to the ProdData path for portal_server_root_prod on the hard drive. If you selected Install only, skip to reviewing the summary screen step.

    2. Install and Configure If you chose this option, the installation program continues, automatically creating a WebSphere Application Server profile, naming it wp_profile. If this profile already exists, then the profile name becomes wp_profilex , where x is 1 or the next available number.

  11. For the Install and Configure option only: A port number is automatically chosen by the installation program when the profile is created. The starting port is based on a range of 50 free ports within ports 10000 to 65000. If for some reason the installation program cannot detect ports for WebSphere Application Server or WebSphere Portal Express a warning message pops up stating that there was a problem detecting ports.

    The value provided for the starting port must be resolved prior to running the installation. When the value is specified as an argument, the installation program accepts it as provided and does not verify that the specified port is resolved. Using a port that is not resolved may interfere with other applications using the same ports on the same system. For example, if there is an existing profile using the same port block range, you will not be able to stop or start that profile once the second profile is configured.

    Press Enter.

  12. The screen for this step only appears if you chose the Install and Configure option: Enter an administrator user ID and password to be used for accessing both WebSphere Portal Express and WebSphere Application Server after installation. 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 collected by the installation program in order to enable security. If you intend to use a Lightweight Directory Access Protocol (LDAP) directory to manage your users, ensure that the administrator user ID you specify here conforms to the recommendations specified in Special characters in user IDs and passwords. Press Enter.

  13. The screen for this step appears whether you chose the Install and Configure or Install only option: Review the information on the installation summary screen and press Next. Throughout installation, the program displays progress messages related to the various components. Wrapper files from the archive install image are copied into the ProdData path for portal_server_root .

    This simplified and quick installation results in an updated, pre-configured, working portal with deployed portlets and security enabled.

    A sequential summary of the automatic copy, install, and configuration steps follows, described within the option in which it occurs:

    1. Install and Configure or Install only: This is the point at which the appropriate binary files are copied from the install CDs or filesystem to the ProdData path for portal_server_root_prod on the hard drive. The i5/OS library is populated with Java Content Repository (JCR) files.

    2. It is at this point that the Install only option completes. The Install and Configure option continues:

      • The installation program creates the WebSphere Application Server profile from the install image files.

      • The installation program extracts the WebSphere Portal Express install image files into the created WebSphere Application Server profile in UserData app_server_root.

      • Files used to update WebSphere Portal Express are copied into the UserData app_server_root.

      • The DB2 database library is created.

      • Database domain names are created.

      • Fix packs are automatically applied.

      • Portlets are pre-deployed, unless you specified an empty portal install.

      • Security is enabled.

  14. When WebSphere Portal Express finishes installing, the installation program displays a confirmation panel. Press Finish to exit the installation program. If you installed an empty portal, the portal is ready for importing the new configuration when the installation program is finished. Refer to details on transferring a portal configuration in Working with the XML configuration interface.

  15. Continue the installation process with Document Rendering on i5/OS.

    You can install more than one copy of WebSphere Portal Express on the same machine and have each WebSphere Portal Express operate independently of the others. Each copy of WebSphere Portal Express will be installed on a separate WebSphere Application Server profile.

    If a full installation has already been completed, re-invoke the installation program to add more than one portal on the same System i5 server where WebSphere Portal Express was installed.

  16. When performing certain tasks, you might need to increase your JVM heap size; see Setting the JVM max heap size for information about when and how to increase your heap size.

  17. Disable WebSphere Application Server informational logging by running the following command: 

    CHGJOBD JOBD(QWAS6/QWASJOBD) LOG(4 00 *NOLIST)

 

Parent topic:

Installing methods (Choose one)