Sun Java System Portal Server 6 2005Q4 Release Notes

Portal Server And Secure Remote Access Configuration Checklist

The following tables are three column tables that list all the values that you might need for a post-install configuration. Depending on the type of installation you perform, the values that you use might vary. The first column lists the parameter; the second column lists the default value; and the third column lists the description. The Checklists are organized in the following way:


Note –

The Portal Server default base installation and product directory depends on your specific platform:

Solaris™ systems /opt

Linux systems: /opt/sun

For example, if the install root is /opt (the default) the Portal Server is installed in /opt/sun/portal for Linux platforms and /opt/SUNWps for Solaris platforms.



Note –

If a parameter is not applicable to a container, it is not included in the table.


Table 5 Component Selection

Parameter 

Default Value 

Description 

COMPONENTS

Sun Java System Portal Server components to be configured 

1,2,3,4,5 

Set “1” to configure PortalServer. 

Set “2” to configure Secure Remote Access Core. 

Set “3” to configure Gateway. 

Set “4” to configure NetletProxy. 

Set “5” to configure RewriterProxy. 

To Configure multiple components, use a comma (,) to separate entries. 

Table 6 Base Directory

Parameter 

Default Value 

Description 

BASEDIR

BASEDIR

The directory where Sun Java System Portal Server configurator components are installed 

 

This is the base directory in which the Portal Server software is installed using Java Enterprise System Installer. 

The base directory depends on the platform you are using. 

For example, if the install root is /opt (the default) the Portal Server is installed in: 

/opt/sun/portal for Linux platforms 

/opt/SUNWps for Solaris platforms. 

PS_CONFIGURATION_MODE

The Configuration mode in which you want the Sun Java System configurator needs to be executed 

configure 

Possible values are: 

configure–Configure the Portal Server Components. 

scrubds–Remove the Portal Server Components entries from the Directory Server. 

unconfigurewithoutscrubds–Unconfigure the Portal Server Components without removing the entries from the Directory Server. 

unconfigurewithscrubds–Unconfigure the Portal Server and also remove the entries from the Directory Server. 

Table 7 Deployment Information

Parameter 

Default Value 

Description 

PS_DEPLOY_TYPE

The web container on which Portal Server is being deployed. The Portal Server can be deployed on: 

  • Sun Java System Web Server Table 8

  • Sun Java System Application Server 7.0 Table 9

  • Sun Java System Application Server 8.1 Table 10

  • BEA WebLogic Server Table 11

  • IBM WebSphere Application Server Table 12

SUNONE8

Possible values are: 

IWS = Sun Java System Web Server 

SUNONE = Sun Java System Application Server 7.0 

SUNONE8 = Sun Java System Application Server 8.1 

WEBLOGIC = BEA WebLogic Server 8.1 SP2 

WEBSPHERE = IBM WebSphere Application Server. 

Table 8 Sun Java System Web Server

Parameter 

Default Value 

Description 

PS_DEPLOY_DIR

/opt/SUNWwbsvr

Directory in which the Sun Java System Web Server is installed. 

PS_DEPLOY_INSTANCE

myportalbox.mydomain.com 

The web server instance you want the Portal Server to use. Note: The instance name should not contain spaces. 

PS_DEPLOY_DOCROOT

/opt/SUNWwbsvr/docs

The Web Server Directory where static pages are kept. 

PS_DEPLOY_ADMIN

admin

The administrator user ID. 

PS_DEPLOY_ADMIN_PROTOCOL

http

The administration server Protocol. 

PS_DEPLOY_ADMIN_HOST

myportalbox.mydomain.com 

The administration server hostname. 

PS_DEPLOY_ADMIN_PORT

8888

The port number of the administration server. 

PS_DEPLOY_JDK_DIR

/usr/jdk/entsys-j2se

The JDK Dir that is being used by the web container. 

Table 9 Sun Java System Application Server 7.0

Parameter 

Default Value 

Description 

PS_DEPLOY_DIR

/opt/SUNWappserver7

Directory in which the Sun Java System Application Server 7.0 is installed 

PS_DEPLOY_DOMAIN

/var/opt/SUNWappserver7/domains/domain1

The Sun Java System Application Server domain contains a set of instances. 

The domain specified will contain the instance used by the Portal Server. This domain must already be configured. 

PS_DEPLOY_INSTANCE

server1

The name of the Sun Java System Application Server instance to which the Portal Server will be deployed. 

This instance must already be configured. The instance name should not contain spaces. 

PS_DEPLOY_DOCROOT

/var/opt/SUNWappserver7/domains/domain1/server1/docroot

The Application Server Directory where static pages are kept. 

PS_DEPLOY_ADMIN

admin

The administrator user ID. 

PS_DEPLOY_ADMIN_PROTOCOL

http

The administration server Protocol. 

PS_DEPLOY_ADMIN_HOST

myportalbox.mydomain.com 

The administration server hostname. 

PS_DEPLOY_ADMIN_PORT

4848

The port number of the administration server. 

PS_DEPLOY_JDK_DIR

/usr/jdk/entsys-j2se

The JDK Dir that is being used by the we container. 

Table 10 Sun Java System Application Server 8.1

Parameter 

Default Value 

Description 

PS_DEPLOY_DIR

/opt/SUNWappserver/appserver

Directory in which the Sun Java System Application Server 8.1 is installed 

PS_DEPLOY_DOMAIN

domain1

The Sun Java System Application Server domain contains a set of instances. The domain specified will contain the instance used by the Portal Server. 

This domain must already be configured. 

PS_DEPLOY_INSTANCE_DIR

/var/opt/SUNWappserver/domains/domain1

The full path of the domain specified that will be configured for the Portal Server. 

PS_DEPLOY_INSTANCE

server

The name of the Sun Java System Application Server instance to which the Portal Server will be deployed. 

This instance must already be configured. The instance name should not contain spaces. 

PS_DEPLOY_DOCROOT

/var/opt/SUNWappserver/domains/domain1/docroot

The Application Server Directory where static pages are kept. 

PS_DEPLOY_ADMIN

admin

The administrator user ID. 

PS_DEPLOY_ADMIN_PROTOCOL

https

The administration server Protocol. 

PS_DEPLOY_ADMIN_HOST

myportalbox.mydomain.com 

The administration server hostname. 

PS_DEPLOY_ADMIN_PORT

4849

The port number of the administration server. 

PS_DEPLOY_JDK_DIR

/usr/jdk/entsys-j2se

The JDK Directory that is being used by the web container. 

Table 11 BEA WebLogic Server

Parameter 

Default Value 

Description 

PS_DEPLOY_DIR

/usr/local/bea

The directory in which BEA is installed. 

PS_DEPLOY_DOMAIN

mydomain 

The BEA WebLogic Server domain contains a set of instances. The domain specified will contain the instance used by the Portal Server. This domain must already be configured. 

PS_DEPLOY_INSTANCE

myserver 

The name of the BEA WebLogic Server instance to which the Portal Server will be deployed. 

This instance must already be configured. The name must not contain a space. 

If you are installing Portal Server on an administration server instance this will be the name of the administration server instance. Otherwise it will be the name of the managed server instance. 

PS_DEPLOY_DOCROOT

/usr/local/bea/user_projects/domains/mydomain/applications

The document root value of DefaultWebApp needs to be deployed to the BEA WebLogic Server instance on which you are running the Portal Server software. 

DefaultWebApp is the default web application, from which is served static content in a BEA WebLogic Server. By default it is only deployed to the domain (mydomain) and the server instance defined or created during the BEA WebLogic Server install. This means that if you create your own BEA WebLogic Server or domain, you need to deploy the DefaultWebApp to it, either by copying the directory to the new server’s deployment directory, or by using the BEA WebLogic Server administration console. 

See the BEA WebLogic Server documentation for more detail on how to configure a default web application. 

PS_DEPLOY_ADMIN

weblogic

The administrator user ID. 

PS_DEPLOY_ADMIN_PROTOCOL

http

The administration server Protocol. 

PS_DEPLOY_ADMIN_HOST

myportalbox.mydomain.com 

The administration server host name. 

PS_DEPLOY_ADMIN_PORT

7001

The port number of the administration server. 

PS_DEPLOY_JDK_DIR

/usr/local/bea/jdk141_03

The JDK directory that is being used by the BEA WebLogic server. 

PS_DEPLOY_PRODUCT_DIR

/usr/local/bea/weblogic81

The directory in which the BEA WebLogic Server software is installed. 

PS_DEPLOY_PROJECT_DIR

user_projects

This is the user project’s directory. Use the value you entered during BEA WebLogic installation. 

PS_DEPLOY_DOMAINS_DIR

domains

The name of the directory containing the BEA WebLogic Server domain. 

PS_WEBLOGIC_CONFIG_DIR

/usr/local/bea/user_projects/domains/mydomain

The full path of the BEA WebLogic Server domain. 

Table 12 IBM WebSphere Application Server

Parameter 

Default Value 

Description 

PS_DEPLOY_DIR

/opt/WebSphere/Express51/AppServer

The directory in which the IBM WebSphere Application Server software is installed. 

PS_DEPLOY_INSTANCE

server1

The name of the instance to which the Portal Server will be deployed. This instance must already be configured. 

Portal Server can not be installed into an application server instance or domain whose name contains a dash or a space, for example, Default-Server or Default Server. 

PS_DEPLOY_DOCROOT

/opt/IBMHTTPD/htdocs/en_US

The directory where static pages are kept. This directory is created during the Sun Java System Identity Server installation. 

PS_DEPLOY_ADMIN

admin

The administrator user ID. 

PS_DEPLOY_ADMIN_PROTOCOL

http

The administration server Protocol. 

PS_DEPLOY_ADMIN_HOST

myportalbox.mydomain.com 

The administration server host name. 

PS_DEPLOY_ADMIN_PORT

7080

The port number of the administration server. 

PS_DEPLOY_JDK_DIR

/usr/jdk/entsys-j2se

The JDK directory that is being used by the we container. 

PS_DEPLOY_NODE

myportalbox 

 

PS_DEPLOY_CELL

myportalbox 

 

PS_DEPLOY_VIRTUAL_HOST

default_host 

Use the value you entered during IBM WebSphere installation. 

Table 13 Portal Server Information

Parameter 

Default Value 

Description 

PS_DEPLOY_URI

/portal

The URI is the space on the web server or application server that the Portal Server uses. 

The value for the deployment URI must have a leading slash and must contain only one slash. However, the deployment URI can not be a "/" by itself. 

PS_LOAD_BALANCER_URL

Load balancer controlling Portal Server Instances 

http://myportalbox.mydomain.com:80/portal

If you are not using any Load Balancer URL then use the Portal Server URL. http://fully-qualified-domain:port/portal-deploy_uri

For example http://myportalbox.mydomain.com:80/portal

PS_PROTOCOL

http

The Protocol to be used while accessing the Portal Server. Possible values are http and https. 

PS_HOST

 

Fully Qualified Name of the Portal Server 

PS_PORT

 

Port number to be used for accessing the Portal Server. 

Table 14 Access Manager Information

Parameter 

Default Values 

Description 

PS_IDSAME_ADMIN_PASSWORD

Administrator (amadmin) Password 

 

The top level administrator (amadmin) password chosen during the Sun Java System Identity Server software installation. 

PS_IDSAME_LDAPUSER_PASSWORD

Internal LDAP Authentication User Password 

 

The Internal LDAP Authentication User Password chosen during the Sun Java System Identity Server installation. 

PS_DS_DIRMGR_DN

Directory Manager DN 

cn=Directory Manager

The directory manager DN chosen during the installation of the Sun Java System Directory Server. 

PS_DS_DIRMGR_PASSWORD

Directory Manager Password 

 

The directory manager Password chosen during the installation of the Sun Java System Directory Server. 

PS_DEPLOY_ADMIN_PASSWORD

Deploy Administrator Password 

 

This is the web-container’s Administrator Password. 

Table 15 Secure Remote Access Information

Parameter 

Default Values 

Description 

SRA_GW_PROTOCOL

Gateway Protocol 

https

The Protocol used by the gateway. The gateway will communicate using Secure Sockets Layer (SSL). 

SRA_GW_PORT

Gateway Port 

443

The port on which the gateway listens. 

SRA_GATEWAY_PROFILE

Gateway Profile Name 

default

A gateway profile contains all the information related to gateway configuration, such as the port on which gateway listens, SSL options, and proxy options. You can create multiple profiles in the gateway administration console and associate different instances of gateway with different profiles. 

See “Creating a Gateway Profile” in the Sun Java System Portal Server, Secure Remote Access 6 2005Q4 Administrator’s Guide. 

SRA_SERVER_DOMAIN

portal-server-domain-name

The domain name for the machine on which the Portal Server is installed. 

SRA_GW_DOMAIN

Gateway Domain 

gateway-domain-name

The domain name of the gateway machine. 

SRA_IDSAME_ADMIN_PASSWORD

Administrator (amadmin) Password 

 

The top level administrator (amadmin) password chosen during the Sun Java System Identity Server software installation. 

SRA_IDSAME_LDAPUSER_PASSWORD

Internal LDAP Authentication User Password 

 

The Internal LDAP Authentication User Password chosen during the Sun Java System Identity Server installation. 

SRA_DS_DIRMGR_DN

Directory Manager DN 

cn=Directory Manager

The directory manager DN chosen during the installation of the Sun Java System Directory Server. 

SRA_DS_DIRMGR_PASSWORD

Directory Manager Password 

 

The directory manager Password chosen during the installation of the Sun Java System Directory Server. 

SRA_DEPLOY_ADMIN_PASSWORD

Deploy Administrator Password 

 

This is the web-container’s Administrator Password. 

SRA_LOG_USER_PASSWORD

Gateway Logging User Password 

 

This allows administrators with non-root access to look at gateway log files. 

The sample silent file looks like the following:

################################################################################

#

# Install/Config components (Use comma (,) to separate entries ):

#

# 1. PortalServer

# 2. Secure Remote Access Core

# 3. Gateway

# 4. NetletProxy

# 5. RewriterProxy

#

################################################################################

COMPONENTS=1,2,3,4,5

BASEDIR=/opt

################################################################################

# Portal Server keys

################################################################################

##################### PS_CONFIGURATION_MODE possible values

####################

#

# configure - Configure the Portal Server Components.

# scrubds - Remove the Portal Server Components entries from the Directory Server.

# unconfigurewithoutscrubds - Unconfigure the Portal Server Components without removing the entries from the Directory Server.

# unconfigurewithscrubds - Unconfigure the Portal Server and also remove the entries from the Directory Server.

#

################################################################################

PS_CONFIGURATION_MODE=configure

##################### PS_DEPLOY_TYPE possible values###########################

#

# IWS = WebServer

# SUNONE = AppServer 7

# SUNONE8 = AppServer8.1

# WEBLOGIC = BEA WebLogic

# WEBSPHERE = IBM WebSphere

#

################################################################################

PS_DEPLOY_TYPE=SUNONE8

##################### PS_DEPLOY_DIR possible values############################

#

# /opt/SUNWwbsvr = WebServer

# /opt/SUNWappserver7 = AppServer 7

# /opt/SUNWappserver/appserver = AppServer 8.1

# /usr/local/bea = BEA WebLogic

# /opt/WebSphere/AppServer = IBM WebSphere

#

################################################################################

PS_DEPLOY_DIR=/opt/SUNWappserver/appserver

##################### PS_DEPLOY_DOMAIN possible values#########################

#

# null = WebServer

# /var/opt/SUNWappserver7/domains/domain1 = AppServer 7.0

# domain1 = AppServer 8.1

# mydomain = BEA WebLogic

# null = IBM WebSphere

#

################################################################################

PS_DEPLOY_DOMAIN=domain1

#################### PS_DEPLOY_INSTANCE_DIR possible values########################

#

# /var/opt/SUNWappserver/domains/domain1 = AppServer8.1

# null - for other containers.

#

################################################################################

PS_DEPLOY_INSTANCE_DIR=/var/opt/SUNWappserver/domains/domain1

##################### PS_DEPLOY_INSTANCE possible values#######################

#

# myportalbox.mydomain.com = WebServer

# server1 = AppServer 7.0

# server = AppServer 8.1

# myserver = BEA WebLogic

# server1 = IBM WebSphere

#

################################################################################

PS_DEPLOY_INSTANCE=server

##################### PS_DEPLOY_DOCROOT possible values#########################

#

# /opt/SUNWwbsvr/docs = WebServer

# /var/opt/SUNWappserver7/domains/domain1/server1/docroot = AppServer 7.0

# /var/opt/SUNWappserver/domains/domain1/docroot = AppServer 8.1

# /usr/local/bea/user_projects/domains/mydomain/applications = BEA WebLogic

# /opt/IBMHttpd/docs = IBM WebSphere

#

################################################################################

PS_DEPLOY_DOCROOT=/var/opt/SUNWappserver/domains/domain1/docroot

PS_DEPLOY_ADMIN=admin

PS_DEPLOY_ADMIN_PROTOCOL=https

PS_DEPLOY_ADMIN_HOST=myportalbox.mydomain.com

PS_DEPLOY_ADMIN_PORT=4848

####################### PS_DEPLOY_JDK_DIR possible values########################

#

#/usr/local/bea/jdk141_03 = BEA WebLogic (Please change this to your weblogic JDK Dir in your setup)

#/usr/jdk/entsys-j2se = for other containers.

#

###################################################################################

PS_DEPLOY_JDK_DIR=/usr/jdk/entsys-j2se

###################### PS_DEPLOY_PRODUCT_DIR possible values####################

#

# /usr/local/bea/weblogic81 = BEA WebLogic

# null - for other containers.

#

################################################################################

PS_DEPLOY_PRODUCT_DIR=null

#################### PS_DEPLOY_PROJECT_DIR possible values####################

#

# user_projects = BEA WebLogic

# null - for other containers.

#

################################################################################

PS_DEPLOY_PROJECT_DIR=null

######################## PS_DEPLOY_DOMAINS_DIR possible values###############

#

# domains = BEA WebLogic

# null - for other containers.

#

################################################################################

PS_DEPLOY_DOMAINS_DIR=null

################## PS_WEBLOGIC_CONFIG_DIR possible values#####################

#

# /usr/local/bea/user_projects/domains/mydomain = BEA WebLogic

# null - for other containers.

#

################################################################################

PS_WEBLOGIC_CONFIG_DIR=null

##################### PS_DEPLOY_NODE possible values##########################

#

# myportalbox = IBM WebSphere

# null - for other containers.

#

################################################################################

PS_DEPLOY_NODE=null

##################### PS_DEPLOY_CELL possible values##########################

#

# myportalbox = IBM WebSphere

# null - for other containers.

#

################################################################################

PS_DEPLOY_CELL=null

#################### PS_DEPLOY_VIRTUAL_HOST possible values##################

#

# default_host = IBM WebSphere

# null - for other containers.

#

################################################################################

PS_DEPLOY_VIRTUAL_HOST=null

PS_DEPLOY_URI=/portal

PS_LOAD_BALANCER_URL=http://myportalbox.mydomain.com:80/portal

PS_PROTOCOL=http

PS_HOST=myportalbox.mydomain.com

PS_PORT=80

PS_IDSAME_ADMIN_PASSWORD=admin123

PS_IDSAME_LDAPUSER_PASSWORD=test1234

PS_DS_DIRMGR_DN=cn=Directory Manager

PS_DS_DIRMGR_PASSWORD=admin123

PS_DEPLOY_ADMIN_PASSWORD=admin123

################################################################################

# SRACore keys

################################################################################

SRA_GW_PROTOCOL=http

SRA_GW_PORT=443

SRA_GATEWAY_PROFILE=default

SRA_SERVER_DOMAIN=mydomain.com

SRA_GW_DOMAIN=mydomain.com

SRA_IDSAME_ADMIN_PASSWORD=admin123

SRA_IDSAME_LDAPUSER_PASSWORD=test1234

SRA_DS_DIRMGR_DN=cn=Directory Manager

SRA_DS_DIRMGR_PASSWORD=admin123

SRA_DEPLOY_ADMIN_PASSWORD=admin123

SRA_LOG_USER_PASSWORD=admin123

################################################################################

# Gateway keys

################################################################################

GW_PROTOCOL=https

GW_HOST=mygwbox.mydomain.com

GW_PORT=443

GW_IP=129.158.227.209

GW_GATEWAY_PROFILE=default

GW_LOAD_BALANCER_URL=http://mygwbox.mydomain.com:80/portal

GW_CERT_INFO=”CN=$GW_HOST,L=Santa

Clara,ST=California,C=us,O=Portal,OU=Sun”

GW_SRA_LOG_USER_PASSWORD=admin123

GW_CERT_DB_PASSWORD=admin123

################################################################################