Sun Java System Portal Server 7 Installation Guide

Installing the Portal Server Software

This section contains the following procedures:

To Install the Portal Server Software

Before You Begin

Tip –

Some post-install configuration tasks require you to use values that you entered during the install. Keep these values available for future use.

Unzip the download bits and go to the OS-arch directory, where OS-arch can be Solaris_sparc, or Solaris_x86, or Linux_x86.

Type ./installer to invoke the wizard to install the software.

Select Next (at the Welcome Screen), and Accept License.

Select the language support you want to install and the components you wish to install on this system.

To install Portal Server software, select Sun Java System Portal Server 7.

Specify the installation directory for the following software.

Note –
Access Manager must be installed in Legacy Mode.

Directory Preparation Tool

By default, this is installed in /opt/SUNWcomds

Access Manager

By default, this is installed in /opt

Web Server

By default, this is installed in /opt/SUNWwbsvr

Portal Server

By default, this is installed in /opt

Portal Server Secure Remote Access core cannot be installed on the same machine as Portal Server in different sessions. If Portal Server is selected without Secure Remote Access, a warning is displayed saying that Secure Remote Access core cannot be installed or configured in the second session.

Specify whether or not you wish to configure now.

The installer only supports adding one portal and one instance; for any other configuration, the configure later option must be selected. If the configure now option is selected, after the packages are installed, the configuration is immediately started; otherwise, the configuration can be done by selecting the configure later option. See Chapter 5, Configuring After the Installation for more information.

If you selected configure now option, proceed to the next step; otherwise, skip to step 24.

Specify the following common server settings:

Host Name, DNS Domain Name, Host IP Address

Host name, domain, and IP address of the system.

Administrator User ID and Password

User ID and password of the top-level administrator (typically amadmin).

System User and Group

System user name and group ID.

Values you enter here appear as default values during the rest of the installation.

Specify the web container settings for administration and default web container Instance.

For more information about configuring Web Server, see the Web Server Configuration Information in Sun Java Enterprise System 2005Q4 Installation Reference.

For more information about configuring Application Server, see the Sun Java Enterprise System 2005Q4 Installation Reference

Specify the Directory Server administration settings, server settings, configuration information, data storage location, populate data information.

For more information, see the Directory Server Configuration Information in Sun Java Enterprise System 2005Q4 Installation Reference.

Specify the Access Manager administration information, web container information, services information, directory server information, and provisioned directory information.

For more information, see the Access Manager Configuration Information in Sun Java Enterprise System 2005Q4 Installation Reference.

Select a web container for Portal Server software.

You can select one of the following:
- Sun Java System Web Server
- Sun Java System Application Server

Specify the information for you web container information.

Your selection in Step 8 affects the information you provide. For:
- Sun Java System Web Server
  
  Installation Directory
  
  Specifies the Web Server directory. By default, this is installed in /opt/SUNWwbsvr
  
  Server Instance and Server Instance Port
  
  Specifies the server instance ID and port number. By default, the server instance is the fully qualified host name of the system and 80 is the instance port.
  
  Server Document Root
  
  Specifies the document root directory. By default, /opt/SUNWwbsvr/https-hostname.domain/docs is the document root
  
  Secure Server Instance Port
  
  Specifies the secure server instance port number. Port number of the secure server instance
- Sun Java System Application Server
  
  Installation Directory
  
  specifies the installation directory of the Sun Java System Application Server. By default, this is /opt/SUNWappserver/appserver.
  
  Domain Name
  
  Specifies the domain name for the Application Server. By default, domain1.
  
  Server Instance Directory and Port
  
  Specifies the Application Server instance directory and port number. By default, the instance directory is /var/opt/SUNWappserver/domains/domain1 and port is 8080.
  
  Document Root Directory
  
  Specifies the document root directory. By default, /var/opt/SUNWappserver/domains/domain1/docroot.
  
  Administration Port
  
  Specifies the administration port for Application Server. By default, 4849.
  
  Administrator User ID and Password
  
  Specifies the Access Manager User ID and password. By default, admin.
  
  Secure Server Instance Port
  
  Specifies the secure server instance port. Port number of the secure server instance.
  
  Secure Administration Server Port
  
  Specifies the port number of the secure administration server.

Specify the following to deploy in to the web container:

Portal Access URL

By default, this is protocol://hostname.domain:port/portal.

Note –
The Portal Access URL and the Deployement URI must be the same. For example, if the Portal Access URL is protocol://hostname.doman:port/portal, the Deployment URI must be /portal

Portal ID

By default, this is portal1.

Search ID

By default, this is search1.

Deployment URI

By default, this is /portal.

Specify whether or not you wish to configure all sample portals.

You can select one or more sample portals to configure.

To install Secure Remote Access also, specify the following; otherwise, skip to step 24.

Protocol

The protocol can be HTTP or HTTPS.

Host and Port

By default, host is the hostname.domain and port is 80.

Deployment URI

By default, /portal.

Specify the following information to install the Gateway:

Gateway Protocol

Specifies the protocol by which the gateway communicates. By default, this is HTTPS.

Portal Server Domain

Specifies the domain in which the Portal Server is installed. By default, this is the domain name of the system.

Gateway Domain and Port

Specifies the domain in which the gateway is installed and the port used by the gateway. By default, the domain is the default domain of the system and port is 443.

Gateway Profile Name

Specifies the profile name of the gateway. By default, this is default.

Log User Password

Specifies the password for the log user. Log user password

Host Name, Subdomain, and Domain

Specifies the host name subdomain and domain name for the gateway. By default, this is the host name, sub domain, and domain of the system on which you are installing the Gateway.

Host IP Address and Access Port

Specifies the host IP address and access port for the gateway. By default, this is the IP address of the system on which you are installing the Gateway and the port is, by default, 443.

Gateway Profile Name and Log User Password

Specifies the gateway profile name and log user password. By default, the gateway profile name is default.

Specify whether or not you wish to start Gateway after installation.

Specify the following information for the Netlet Proxy.

Host Name, Subdomain, and Domain

Specifies the name, subdomain, and domain name of the machine on which the Netlet proxy resides. By default, the system values are used.

Host IP Address and Access Port

Specifies the host IP address and access port of the machine on which the Netlet Proxy resides. By default, the IP address is the IP address of the system and port is 10555

Gateway Profile Name and Log User Password

Specifies the gateway profile name and log user password that the Netlet Proxy uses. By default, the gateway profile name is default.

Specify whether or not you wish to start Netlet Proxy after installation.

Specify the following information to install the Rewriter Proxy.

Host Name, Subdomain, and Domain

Specifies the host name, subdomain, and domain name of the machine on which the Rewriter Proxy resides. By default, the system values are used.

Host IP Address and Access Port

Specifies the Host IP address and access port of the machine on which the Rewriter Proxy resides. By default, the IP address is the IP address of the system and port is 10443.

Gateway Profile Name and Log User Password

Specifies the gateway profile name and log user password that Rewriter Proxy uses. By default, the gateway profile name is default.

Specify whether or not you wish to start Rewriter Proxy after installation.

Specify the following proxy information for the Secure Remote Access software.

Note –
Based on whether or not you wish to work with Portal Server software on another host, the ability to edit this page varies. If the proxy server being installed are to work with an instance of Portal Server installed on a different host, select the option to Work with Portal Server on another host, and specify the following information.

Portal Server Protocol, Host, Port, and Deployment URI

By default, host is the hostname.domain of the system where Portal Server is installed, port is 81, and URI is /portal.

Organization DN

Organization distinguished node.

Access Manager Service URI and Encryption Key

By default, the URI is /amserver.

Specify the following certificate information for the Secure Remote Access software:

Organization, Division, City/Locality, State/Province

Specify your organization name, division, city, and state information.

Country Code

Use the two character format.

Certificate Database Password

The certificate database password must be at least eight characters.

Specify whether or not you are ready to install by selecting the Next.

Specify whether or not you wish to open the registration window during installation and select Install to install the software.

To Install on a Second Machine

The GUI installer cannot be used for multi portal installation. Follow the instructions in this section to install Portal Server on a second machine.

Install Access Manager SDK and web container first.

Start the web container and then invoke the Portal Server software GUI installer to install the software in configure later mode.

Copy the /etc/opt/SUNWcacao/security directory from the machine where the first portal resides to the second machine.

Restart the CACAO server on the second machine.

For Solaris, use the command /opt/SUNWcacao/bin/cacaoadm restart.

for Linux, use the command /opt/sun/cacao/bin/cacaoadm restart.

Complete the Portal Server installation by running the psconfig --config example-config-xml-file command.

The psconfig utility is located in PortalServer7–base/bin. By default, PortalServer7–base is /opt/SUNWportal.

The example files are located in the following directories:

For Solaris:PortalServer7-base/samples/psconfig

For Linux: PortalServer7-base/samples/psconfig. By default, PortalServer7–base for Linux is /opt/portal.

Edit the configuration xml example files to specify the configuration details.

For more details on constructing a config xml file, see Constructing a Configuration XML File.

To Verify the Installation

Verify the Portal Server software installation by:

Accessing the Samples.
Accessing the Portal Server software administration console.
(Optional) Verifying the Gateway port and running the Portal Server in secure mode.

Type protocol://fully-qualified-hostname:port/portal-URI in the browser.

When you type the URL, the welcome page, a short description of Portal server and links to sample portals that you selected for installation is displayed. Click on one of the links and access the anonymous portal desktop for the sample portal. If the sample Portal desktop displays without any exception, then your Portal Server installation was successful.

Type protocol://fully-qualified-hostname:port/psconsole in the browser.

Run the following command to check if the gateway is running on the specified port (the default port is 443):

netstat -an | grep port-number

If the gateway is not running, use the following command to start the gateway:

PortalServer7-base/bin/psadmin start-sra-instance -u amadmin -f amadmin-password-file --instance-type gateway --instance-name GatewayInstanceName

By default the PortalServer7–base is /opt/SUNWportal

Note –
Create a file and add amadmin password in plaint text and pass it as an input to the -f option above.

Also view the log files. The log file name is picked up from the property called debug.com.sun.portal.handler.java.util.logging.FileHandler.pattern in the platform.conf file.

Run the Portal Server in secure mode by typing the gateway URL in your browser:

https://gateway-machine-name:portnumber

If you have chosen the default port (443) during installation, you need not specify the port number.