Advanced installation options

 


In addition to supporting typical installation scenarios, the WebSphere Portal installation program also provides advanced installation options to address special situations that might arise in your environment. This section describes the advanced installation options that are available.

Password considerations: For security reasons, not store passwords in the wpconfig.properties file. It is recommended that you edit the wpconfig.properties prior to running a configuration task, inserting the passwords needed for that task. Then, after the task has run, you should delete all passwords from the wpconfig.properties file.

Alternatively, you can specify the password on the command line using the following syntax:

WPSconfig.sh task_name -Dpassword_property_key=password_value

As with other properties, each password property must have the -D prefix and be set equal to (=) a value. If you have multiple properties in a single command, use a space character between each -Dproperty=value setting.

 

Install and modifying the default portal URI

By default the WebSphere Portal URI is /wps/portal.

To install WebSphere Portal and modify the default URI, do the following steps:

  1. Enter the following command from the root directory of the setup CD:

    ./install.sh -W installPortletsSequence.active="false"

  2. Proceed through the installation program panels and enter the requested information as you would with a typical installation.

  3. Modify the default URI by running the modify-servlet-path configuration task. Refer to Change the WebSphere Portal URI for detailed instructions.

    Do not run this task after portlets have been deployed.

  4. cd <wp_root>/config, and run...

    ./installportlets.sh portalAdminPassword portalHostName portalPortNumber

    Where

    • portalAdminPassword is the WebSphere Portal administrator password that is specified during installation.

    • portalHostName is the host.name of the machine where you installed WebSphere Portal. If WAS security is not enabled, you can use a value of localhost for this argument. Otherwise, use the fully qualified host.name, such as hostname.setgetweb.com.

    • portalPortNumber is the port number that is used to access WebSphere Portal. This value is stored in the WpsHostPort property in...

      <wp_root>/config/wpconfig.properties

    For example:

    installportlets.bat wpsadmin hostname.setgetweb.com 9081

  5. To verify that WebSphere Portal is running, open the following URL in a browser...

    http://<hostname.setgetweb.com>:<port_number>/<WpsContextRoot>/<WpsDefaultHome>

    Where

    • hostname.setgetweb.com is the fully qualified host.name of the machine that is running WebSphere Portal

    • port_number is the port number that is displayed on the confirmation panel

    • WpsContextRoot is the context root or base URI for the portal

    • WpsDefaultHome is the default portal page. For example, http://www.ibm.com:9081/home/ibm

 

Install an empty portal

In some situations it is possible that you might want to install an empty portal, where WebSphere Portal is installed normally but no portlets are installed or deployed and no pages are created. This can be useful if you want to transfer an entire portal configuration from one portal to another. For example, you might want to transfer a portal from your test environment to a production environment.

To install an empty portal with the WebSphere Portal installation program, do the following steps:

  1. Enter the following command from the root directory of the setup CD:

    • UNIX: ./install.sh -W installPortletsSequence.active="false"

    • Windows: install.bat -W installPortletsSequence.active="false"

  2. Proceed through the installation program panels and enter the requested information as you would with a typical installation.

  3. When the installation program is finished, the portal is ready for importing the new configuration. For more information on transferring a portal configuration in this way, refer to Working with the XML configuration interface.

 

Next steps

You have completed this step. Continue to the next step by choosing one of the following topics:

 

See also

 

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

 

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.