This chapter provides installation information and instructions for the Portal Server software.
This section contains the following procedures:
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.
Access Manager must be installed in Legacy Mode.
By default, this is installed in /opt/SUNWcomds
By default, this is installed in /opt
By default, this is installed in /opt/SUNWwbsvr
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, domain, and IP address of the system.
User ID and password of the top-level administrator (typically amadmin).
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
Specifies the Web Server directory. By default, this is installed in /opt/SUNWwbsvr
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.
Specifies the document root directory. By default, /opt/SUNWwbsvr/https-hostname.domain/docs is the document root
Specifies the secure server instance port number. Port number of the secure server instance
Sun Java System Application Server
specifies the installation directory of the Sun Java System Application Server. By default, this is /opt/SUNWappserver/appserver.
Specifies the domain name for the Application Server. By default, domain1.
Specifies the Application Server instance directory and port number. By default, the instance directory is /var/opt/SUNWappserver/domains/domain1 and port is 8080.
Specifies the document root directory. By default, /var/opt/SUNWappserver/domains/domain1/docroot.
Specifies the administration port for Application Server. By default, 4849.
Specifies the Access Manager User ID and password. By default, admin.
Specifies the secure server instance port. Port number of the secure server instance.
Specifies the port number of the secure administration server.
Specify the following to deploy in to the web container:
By default, this is protocol://hostname.domain:port/portal.
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
By default, this is portal1.
By default, this is search1.
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.
The protocol can be HTTP or HTTPS.
By default, host is the hostname.domain and port is 80.
By default, /portal.
Specify the following information to install the Gateway:
Specifies the protocol by which the gateway communicates. By default, this is HTTPS.
Specifies the domain in which the Portal Server is installed. By default, this is the domain name of the system.
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.
Specifies the profile name of the gateway. By default, this is default.
Specifies the password for the log user. Log user password
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.
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.
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.
Specifies the name, subdomain, and domain name of the machine on which the Netlet proxy resides. By default, the system values are used.
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
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.
Specifies the host name, subdomain, and domain name of the machine on which the Rewriter Proxy resides. By default, the system values are used.
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.
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.
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.
By default, host is the hostname.domain of the system where Portal Server is installed, port is 81, and URI is /portal.
Organization distinguished node.
By default, the URI is /amserver.
Specify the following certificate information for the Secure Remote Access software:
Specify your organization name, division, city, and state information.
Use the two character format.
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.
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.
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
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.