test

Sun Java System Portal Server 7.1 Configuration Guide

ProcedureTo Install Sun Java System Portal Server 7.1

  1. From the installation location, go to the OS-arch directory, where OS-arch can be Solaris_sparc, Solaris_x86, or Linux_x86.

  2. Run ./installer to invoke the wizard to install the software.

  3. In the Welcome screen, click Next.

  4. In the Software License Agreement screen, read the agreement and click Yes, Accept License.

  5. The Choose Software Components screen appears. Select Portal Server 7.1.

    When this option this selected, the following components are selected by default:

    • The Directory Preparation Tool

    • Service Registry 3.1

    • Access Manager 7.1 and related sub components of Identity Management and Policy Services

    • Directory Server Enterprise Edition 6.0 including the Directory Server Core

    • Java DB 10.2

  6. Select the other software components that you want to install.

    • To install Secure Remote Access (SRA) services, select Portal Server Secure Remote Access 7.1. When you select this option, the Gateway, Netlet Proxy, and the Rewriter Proxy are selected by default.

    • To install Application Server, select Application Server Enterprise Edition 8.2 . When you select this option, the Domain Administration Server, Command Line Administration Tool, and Sample Applications for the Application Server are selected by default. The Application Server High Availability Session Store 4.4 and Sun Java System Message Queue 3.7 UR1 are also selected by default.

      Note –

      Select this option if you need EJB container for portal.

    • To install Web Server, select the Sun Java System Web Server 7.0. When you select this option, the Web Server CLI, Web Server Core, and Web Server Samples are selected by default.

      Note –

      Select this option if you require only Web Applications.

    • To install multilingual support for the selected Java ES components, select Install Multilingual Packages for Selected Component(s).

      Note –

      If J2SE-SDK or any shared components require upgrade, the installer displays the corresponding screens. By default, installer upgrade them with the latest version in the installer disk.

  7. The Shared Component Upgrades Requires screen is displayed if any one of the shared components requires upgrading. Click Next to upgrade these shared components.

  8. On the Specify Installation Directories page, specify the installation directory for the software. The following are the default locations. Use the Browse button to change the default location. Click Next.

    Access Manager

    /opt

    Application Server

    /opt/SUNWappserver

    Application Server: Data and Configuration

    /var/opt/SUNWappserver

    Directory Server

    /opt/SUNWdsee

    Directory Preparation Tool

    /opt/SUNWcomds

    Web Server

    /opt

    Web Server Instance

    /var/opt/SUNWwbsvr7

    Service Registry

    /opt

    Portal Server

    /opt

    The Verify System Requirements screen is displayed. The installer verifies each of the listed system requirements and displays OK if the requirements are met. If the installer indicates that all the requirements are met, the System Ready for Installation message appears. Click Next to continue with the installation. In case any of the requirements are not met, a text indicating the same appears with the following options: View Reports and Check Again. The View Report option provides the details about the requirements that are not met. It is recommended that you address these issues. After the requirements are met, click the Check Again option to verify whether the requirements are met.

    Click Next to continue the installation.

    The Choose a Configuration Type screen is displayed.

  9. Select Configure Now, and click Next.

    The installer only supports adding one portal and one instance only. 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 starts immediately.

    Select Configure Now, and click Next.

    The Custom Configuration screen is displayed.

  10. Service Registry 3.1 and Java DB are not configured during the installation. It can be configured after the installation. Click Next.

    The Specify Administrator Account Preferences screen is displayed.

  11. Enter the Administrator ID and password. Type the password, and click Next.

    You are also provided with an option to select different administrator accounts for each product.

    The Specify Common Server Settings screen is displayed.

  12. Specify the following server settings:

    Host Name, DNS Domain Name, and Host IP Address

    Host name, domain, and IP address of the system. The installer automatically displays these values.

    System User and Group

    System user name and group ID. For Solaris 10 OS and Linux, the default is root for system user name and root for group ID. For Solaris 9 OS, the default is root for system user name and other for group ID.

    Note –

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

  13. If you have selected Web Server as a component to install, the Choose Configuration Type screen is displayed. You have an option to configure administration instance as a server or as a node. By default, configure administration instance as server is selected. Click Next.

  14. If you have selected Web Server as a component to install, the Web Server: Specify Administration Server Settings and Web Server: Specify Instance Settings screens are displayed. Provide the information for Web Server, and click Next.

    Note –

    Specify the Runtime Unix user ID as root.

    You need to specify the following details for the Web Server: Specify Administration Server Settings screen:

    Server Host

    The default value is automatically created by joining the values that you provided for Host Name and DNS Domain Name under Common Server Settings. The value has the format hostname.domainname.

    SSL Port

    The default value is 8989.

    HTTP Port

    Port on which Web Server listens for HTTP connections. The default is 8800.

    Runtime User ID

    User ID that the default instance of Web Server uses to run on the system. The default is root.

    You need to specify the following details for the Web Server: Specify Instance Settings screen:

    Server Name

    A host and domain value that resolves to the local host. The value has the format hostname.domainname.

    HTTP Port

    Port on which Web Server listens for HTTP connections. The default value is 80.

    Runtime UNIX User ID

    An existing non-root user. If you are installing Access Manager or Portal Server, set this value to root and set the Runtime Group to other. You can change these values after installation. For other servers, the Runtime User ID should be a non-root user. The default value is webservd.

    Document Root Directory

    Location where Web Server stores content documents. For Solaris OS, the default value is /var/opt/SUNWwbsvr7/docs. For Linux and HP-UX, the default value is /var/opt/sun/webserver7/docs.

  15. The High Availability Session Store (HADB): Specify Configuration Data screen is displayed. The Installer displays the default values. This screen is displayed only if you have selected Application Server as a component to install. Click Next.

    HADB Management Port

    Port on which the HADB management listens. The default value is 1862.

    HADB Resource Directory

    Location where HADB stores resource contents. The default value is /var/opt.

    HADB Administrator Group

    The UNIX group (GID) in which the default instance of HADB runs as a user. The default value is other.

    Automatically start HADB when system starts

    Choose this option to direct the installer to configure HADB to start automatically when the system restarts. By default, this is selected.

    Allow Group Management

    Choose this option when you want HADB to be managed by the HADB Administration Group. If this parameter is set to yes, all members belonging to the group (HADB_DEFAULT_GROUP) can run and manage HADB. By default, it is set to No.

    The Application Server: Domain Administration Server screen is displayed.

  16. Provide or change values in the installer pages as needed and click Next.

    The installer displays the default values. This screen is displayed only if you have selected Application Server as a component to install.

    Admin Port

    Port on which Application Servers administrative server listens for connections. By default, it is 4849.

    JMX Port

    The default is 8686.

    HTTP Port

    The default value is 8080. If the installer detects that the default port is used, an alternative value is suggested.

    HTTPS Port

    The default is 8181.

    Master Password

    SSL certificate database password, used for asadmin operations such as Domain Administration Server startup and Node Agent startup. The default value is the Administrator Password you provided under Common Server Settings.

    The Application Server: Node Agent screen is displayed.

  17. Specify the details and click Next.

    This screen displays only if you have selected Application Server as a component to install.

    Admin Host Name

    Host name for administration server which the node agent can connect to.

    Admin User Name

    User ID of the Application Server admin user. The default value is the Administrator User ID you provided under Common Server Settings.

    If you chose to use a single administrator account, this field is not present.

    Password

    Password for the Application Server admin user. There is no default value.

    If you chose to use a single administrator account, this field is not present.

    Master Password

    SSL certificate database password, used for asadmin operations such as Domain Administration Server startup and Node Agent startup. There is no default value.

    Admin Port

    Port on which Application Servers node agent listens for connections. Provides access to the administration tools. The default value is 4849.

    Node Agent Name

    Name of the local node. The default value is the local host name

    The Application Server: Configure Load Balancing Plugin screen is displayed.

  18. Specify the details and click Next.

    This screen displays only if you have selected Application Server as a component to install.

    Web server that the load balancing plugin will use

    You can select either Sun Java System Web Server or Apache Web Server. HP-UX does not support Apache Web Server.

    Web server installation directory

    Installation directory for Web Server or Apache HTTP Server.

    The default value is:

    • Solaris OS: /opt/SUNWwbsvr7

    • Linux and HP-UX: /opt/sun/webserver7

    Web Server instance directory

    Installation directory for Web Server or Apache HTTP Server.

    The default value is:

    • Solaris OS: /var/opt/SUNWwbsvr7

    • Linux and HP-UX: /var/opt/sun/webserver7

    The Directory Server: Specify Instance Creation Information screen is displayed.

  19. Specify the information for Directory Server instance creation and click Next.

    Instance Directory

    Location of new instance.

    Directory Instance Port

    The default value is 389.

    Directory Instance SSL Port

    The default value is 636.

    Directory Manager DN

    Distinguished Name (DN) of the user who has unrestricted access to Directory Server. The default value is cn=Directory Manager.

    System User

    The default value is root.

    System Group

    The default value is root.

    Directory Manager Password

    Password for the directory manager.

    Suffix

    Initial directory suffix managed by this instance. The default value is formed by the segments of the fully qualified domain name for the current host. For example, if you install on siroe.sub1.example.com, the default value is dc=sub1,dc=example,dc=com.

    For more information, see Directory Server Configuration Information in Sun Java Enterprise System 5 Installation Reference for UNIX.

    The Access Manager: Specify Configuration Information screen is displayed.

  20. Specify the information for the Access Manager configuration and click Next.

    Install type

    Indicates the level of interoperability with other components. You have a choice of Realm mode (version 7 style) or Legacy mode (version 6 style). Default option is Legacy mode. You must use Legacy mode if you are installing Access Manager with Portal Server, Messaging Server, Calendar Server, Delegated Administrator, or Instant Messaging. The default value for Legacy mode is Enabled. The default for Realm mode is Disabled.

    Note –

    Portal Server supports Realm mode only if Sun Java System Directory Server is used as a user repository and Access Manager SDK is configured as the datastore plugin for the Realm mode. If you select the Configure Now option for the Realm mode, the installer does this by default.

    Administrator User ID

    Access Manager's top-level administrator. This user has unlimited access to all entries managed by Access Manager. The default name, amadmin, cannot be changed. This ensures that the Access Manager administrator role and its privileges are created and mapped properly in Directory Server, allowing you to log into Access Manager immediately after installation.

    Administrator Password

    Password of the amadmin user. The value must have at least eight characters.

    LDAP User ID

    Bind DN user for LDAP, Membership, and Policy services. This user has read and search access to all Directory Server entries. The default user name, amldapuser, cannot be changed.

    LDAP Password

    Password of the amldapuser user. This password must be different from the password of the amadmin user. It can be any valid Directory Service password.

    Password Encryption Key

    A string that Access Manager uses to encrypt user passwords. For security purposes, it is recommended that the password encryption key be 12 characters or longer.

    Note –

    amAdmin and amldapuser password should be different.

    For more information, see the Access Manager Configuration Information in Sun Java Enterprise System 5 Installation Reference for UNIX.

    Note –

    Portal Server supports installing Access Manager in the Realm mode or in the Legacy mode.

    The Access Manager: Choose Deployment Container screen is displayed.

  21. You can select either Sun Java System Web Server or Sun Java System Application Server. Select the option, and click Next.

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

    For more information about configuring Application Server, see the Sun Java Enterprise System 5 Installation Reference for UNIX

    The Access Manager: Specify Sun Java System Application Server screen is displayed.

  22. Specify the details and click Next.

    This screen is displayed only if you have selected Sun Java System Application Server as the web container for Access Manager.

    Secure Server Instance Port

    Specify whether the value for Instance Port refers to a secure port. A secure port uses the HTTPS protocol. A non-secure port uses HTTP.

    Secure Administration Server Port

    Specify whether the value for Administrator Port is a secure port. A secure port uses the HTTPS protocol. A non-secure port uses HTTP.

    The Access Manager: Specify Web Container for Running Access Manager Services screen is displayed.

  23. Specify the details for Access Manager and click Next.

    Host Name

    Fully qualified domain name of the host on which you are installing.

    Services Deployment URI

    Uniform Resource Identifier (URI) prefix for accessing the HTML pages, classes, and Java Archive (JAR) files associated with the Identity Management and Policy Services Core subcomponent. The default value is amserver. Do not enter a leading slash.

    Common Domain Deployment URI

    URI prefix for accessing the common domain services on the web container. The default value is amcommon. Do not enter a leading slash.

    Cookie Domain

    The names of the trusted DNS domains that Access Manager returns to a browser when Access Manager grants a session ID to a user. A leading dot (.) is required for each domain in the list. The default value is the current domain, prefixed by a dot (.).

    Password Deployment URI

    URI that determines the mapping that the web container running Access Manager will use between a string you specify and a corresponding deployed application. The default value is ampassword. Do not enter a leading slash.

    Console Protocol

    Specify whether the console uses a secure or unsecure port. A secure port uses the HTTPS protocol. A non-secure port uses HTTP. The default is HTTP.

    The Access Manager: Choose Access Manager Console screen is displayed.

    Note –

    This screen is displayed only if you select the Legacy mode to install Access Manager.

  24. By default, Deploy New Console is selected. Click Next.

    Administration Console

    Choose Deploy new console to deploy the console into the web container of the host on which Access Manager is being installed. Choose Use existing console to use an existing console that is deployed on a remote host.

    Console Deployment URI

    URI prefix for accessing the HTML pages, classes, and JAR files associated with the Access Manager Administration Console subcomponent.The default value is amconsole.

    Console Host Name

    Fully qualified domain name for the server hosting the existing console. This value is not needed if you are deploying a new console. You can edit the field only if you are using an existing console.

    Console Port

    Port on which the existing console listens for connections. Permitted values are any valid and unused port number, in the range 0 (zero) through 65535.

    The Access Manager: Choose Directory Server Instance screen is displayed.

  25. Use the Directory Server Instance that you just created. Click Next.

    Note –

    If you choose to use an existing instance instead of the default, the alternate instance must already be configured.

    The Access Manager: Specify Directory Server Data screen is displayed.

  26. You can select Yes or No for the option: Is Directory Server is Provisioned with User Data. By default, No is selected. If you select Yes, you need to provide the related information. Click Next.

  27. If you have selected Application Server as the deployment container for Access Manager, the Specify Sun Java System Application Server Information screen is displayed. Click Next.

    Secure Server Instance Port

    This protocol specifies whether the value for Server Instance port refers to a secure port. A secure port uses the HTTPS protocol. A non-secure port uses HTTP.

    The Portal Server: Specify Web Container Deployment Information screen is displayed.

  28. Specify the Web Container deployment information and click Next.

    Portal Access URL

    The default is host name:port/portal1.

    Portal ID

    The default is portal1.

    Search ID

    The default is search1.

    Deployment URI

    The default is /portal.

    Portal Instance ID

    The default is hostname-8080.

    Select the Enable Secure Remote Access option, if you wish to enable Secure Remote Access. Select Developer Sample, Enterprise Sample, and Community Sample if you wish to configure samples.

    The Portal Server: Secure Remote Access screen is displayed. The Portal Server: Secure Remote Access: Configure Gateway screen is displayed.

  29. Enter the following information and click Next.

    Gateway Protocol

    It is https by default.

    Portal Server Domain Name

    Portal Server domain name.

    Gateway Domain

    Gateway domain.

    Gateway Port

    It is 443 by default.

    Gateway Profile Name

    It is default by default.

    Log User Password

    The user password

  30. Specify the details and click Next.

    Protocol

    Protocol (HTTP or HTTPS) the gateway uses to communicate. In most cases the gateway should use HTTPS.

    Host Name, Subdomain, and Domain

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

    Host IP Address and Access Port

    The host IP address on which the Gateway Proxy resides. By default, the IP address is the IP address of the system and port is 443.

    Gateway Profile Name

    The gateway profile name. By default, the gateway profile name is default.

    The Portal Server: Secure Remote Access: Configure Netlet Proxy screen is displayed.

  31. Specify the following information for the Netlet Proxy.

    Host Name, Subdomain, and Domain

    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

    The host IP address 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

    The gateway profile name. By default, the gateway profile name is default.

    Click Next.

    The Portal Server: Secure Remote Access: Configure Rewriter Proxy screen is displayed.

  32. Specify the following information to install the Rewriter Proxy.

    Host Name, Subdomain, and Domain

    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

    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

    The gateway profile name. By default, the gateway profile name is default.

    Click Next.

    The Portal Server: Secure Remote Access: Specify Certificate Information screen is displayed.

  33. Specify the following certificate information for the Secure Remote Access.

    Organization, Division, City/Locality, State/Province

    The organization name, division, city, and state information.

    Country Code

    The country code in two character format.

    Certificate Database Password

    The certificate database password must be at least eight characters.

    Click Next.

  34. The Ready to Install screen is displayed. Specify whether you are ready to install by clicking Install.