3
Configuring Oracle9iAS Portal using OPCA

This chapter covers:

3.1 The Oracle9iAS Portal Configuration Assistant (OPCA)

The Oracle9iAS Portal Configuration Assistant (OPCA) is a java based configuration tool for installing and configuring the Oracle9iAS Portal repository. In a typical Oracle9i Application Server install the OPCA is invoked by the Oracle Universal Installer (OUI) in the post installation phase. The OPCA can also be invoked in the stand-alone mode.

3.1.1 OPCA and the Oracle9i Application Server Installation

In an Oracle9i Application Server installation, using OUI, the Oracle9iAS Portal install is performed in two phases. The Oracle9i Application Server Infrastructure install type loads the Portal repository in the database. The Oracle9i Application Server middle-tier install type performs the required configuration of the middle-tier, linking it with the Portal repository.

The OPCA is installed with the Oracle9i Application Server and is located in the directory

<iAS_Home>/assistants/opca

The scripts launch.sh and launch.bat are located at:

<iAS_Home>/assistants/opca

They are used by the Oracle Universal Installer (OUI) to invoke the OPCA on the UNIX and Windows NT/2000 platform respectively.

Note:

The launch scripts should not be used by users to invoke the OPCA. The only mode that is currently supported in the launch scripts is the MIDTIER mode with -typical installation type, most of the parameters of this mode would be obtained by the Repository Access API's within OPCA.

3.1.2 Using OPCA in Stand-alone mode

Starting with the Oracle9i Application Server release, Oracle9iAS Portal provides a command line script to invoke the OPCA in stand-alone mode. The scripts ptlasst.csh (UNIX) and ptlasst.bat (Windows NT/2000) are located at <iAS_Home>/assistants dir and can be used to run the OPCA stand-alone in different modes. To start the Oracle9iAS Portal Configuration Assistant, perform the following steps:

On Windows NT/2000:

First, set the ORACLE_HOME to the Oracle9i Application Server Home and JRE_HOME to the JRE home. You can then start the OPCA from the command line by navigating to the <iAS_Home>/assistants directory and using the command:

ptlasst.bat [parameters]

On UNIX:

First set the ORACLE_HOME to the Oracle9i Application Server Home.You can start the OPCA from the command line by navigating to the iAS_Home/assistants directory and using the command:

ptlasst.csh [parameters]

The ptlasst scripts launches the java based configuration program opca and can be launched without passing in any parameters.

3.2 OPCA Modes

For a description of all the OPCA modes, check the table below:

Mode	Description
PORTAL OPCA Mode	This mode installs the Portal repository in the target database. No information from the midtier is required. This mode can be used to create a pre-seeded Portal in the infrastructure database
MIDTIER OPCA Mode	This mode populates and configures the midtier for the Portal repository. Associating the SSO Server, Portal Repository, Oracle9iAS Web Cache and the Portal Repository as well as associating the iASW with the Portal Repository and creating the OID entries for Portal This mode assumes that OID, Oracle9iAS Portal and the Oracle9iAS Single Sign-On Server is installed in the database. Additionally, Oracle9iAS Web Cache and iASW need to be fully configured.
SSO OPCA Mode	This mode installs a stand-alone SSO server in the target database. This mode can be used to create a pre seeded SSO in the infrastructure database.
SSOPARTNERCONFIG OPCA Mode	This mode allows a Portal partner application to add to, modify, or delete, it's configuration information relating to the SSO server. This mode appends to the existing configurations.
LANGUAGE OPCA Mode	This mode installs the strings for a specific language in the Portal repository.
ALL OPCA Mode	This mode comprises of the PORTAL, SSO and MIDTIER mode.
SYSOBJECTS OPCA Mode	Installs Portal and SSO required SYS schema dependencies.

Note:

The scripts winstall, winstall.bat, ssodatan, ssodata.bat, langinst.csh, and langinst.bat are deprecated and their functionality is now handled by OPCA through the ptlasst scripts.

3.2.1 PORTAL OPCA Mode

This mode installs the Portal repository in the target database. No information from the middle-tier is required. This mode can be used to create a pre-seeded Portal in the infrastructure database.

Action

Installs Portal Repository in the database with no middle-tier wiring and should be used for the Portal seed database creation.

Usage Example

Full Usage

ptlasst.csh -i typical -mode PORTAL -s portal -c myhost.domain.com:1521:mySID -p 
change_on_install -u users -t temp -d users -l users -in users -demo  -silent  
-verbose  -report -owa

Table 3-1 List of supported parameters for the PORTAL mode

Parameter	Description
`-i`	Install type. This can be set to typical and custom. In the typical mode, the OPCA takes all the user input passed in on the command line and only a progress bar will be visible. In the custom mode, the OPCA user interface is invoked, which includes all the wizards that prompt for user input, containing the values that are passed in on the command line if they are specified. Note that the Repository Access API's are only used only in the typical mode. Note also that the -silent parameter takes precedence over the -i parameter.
`-mode`	install mode. The different install modes are PORTAL, SSO, SSOPARTNERCONFIG, LANGUAGE, MIDTIER, ALL, SYSOBJECTS.
`-s`	Portal schema name.
`-c`	Connect string to the target database. The format should be hostname:port:sid.
`-p`	SYS password for the target database.
`-u`	Default tablespace.
`-t`	Temporary tablespace.
`-d`	Document tablespace.
`-l`	Logging tablespace.
`-in`	Index tablespace.
`-demo`	Installs the portlet builder demo components.
`-silent`	Runs the OPCA in the silent mode.
`-verbose`	This parameter enables logging in detail mode. The OPCA install continues even if there are errors in the log file.
`-report`	This parameter enables the Oracle9i Reports integration with Oracle9iAS Portal.
`-owa`	This parameter installs the PL/SQL Web Toolkit and other SYS schema packages. This need to be installed just once in the database.

3.2.2 MIDTIER OPCA Mode

Action

Associates the Oracle9iAS Single Sign-On Server and the Oracle9iAS Portal repository.
Associates the Oracle9iAS Web Cache and the Oracle9iAS Portal Repository.
Associates the iASW and the Oracle9iAS Portal Repository.

Assumptions

Oracle9iAS Portal and Oracle9iAS Single Sign-On Server are already installed.
OID, Oracle9iAS Single Sign-On Server and Oracle HTTP server are up and running.

Usage example

Full Usage

ptlasst.csh -i typical -mode MIDTIER -s portal -sp portal -c 
myhost.domain.com:1521:mySID -sdad portal -o orasso -op orasso -odad websso_sso 
-host myApache.domain.com -port 7777 -silent -verbose-ldap_h myOID.domain.com 
-ldap_p 389 -ldap_d cn=orcladmin -ldap_w welcome -portal_only -sso_only -chost 
myHostname.domain.com -cport_i 8001 -cport_a 8000 -sso_c 
myhost.domain.com:1521:mySID -sso_h myApache.domain.com -sso_p 7777 
-ultrasearch-oh /home/oracle -mc false -mi true

Note:

-portal_only and -sso_only should not be passed together.
See Section , "Problem: OPCA install hangs at Oracle Ultra Search phase" for possible issues that might occur during the installation.

Usage example

Basic Usage (Typical mode)

ptlasst.csh -i typical -mode MIDTIER  -host myApache.domain.com -port 7777 
-silent -verbose  -ldap_d cn=orcladmin -ldap_w welcome -oh /home/oracle -mc 
false -mi true

Usage example

Basic Usage (Custom mode)

ptlasst.csh -i custom -mode MIDTIER -s portal -sp portal -c 
myhost.domain.com:1521:mySID -sdad portal -o orasso -op orasso -odad websso_sso 
-host myApache.domain.com -port 7777 -silent -verbose -ldap_h myOID.domain.com 
-ldap_p 389 -ldap_d cn=orcladmin -ldap_w welcome -chost myHostname.domain.com 
-cport_i 8001 -cport_a 8000 -sso_c myhost.domain.com:1521:mySID -sso_h 
myApache.domain.com -sso_p 7777 -ultrasearch -oh /home/oracle -mc false -mi true

Usage example

Portal only configuration

ptlasst.csh -i typical -mode MIDTIER -s portal -sp portal -c 
myhost.domain.com:1521:mySID -sdad portal -o orasso -op orasso -odad websso_sso 
-host myApache.domain.com -port 7777 -silent -verbose -ldap_h myOID.domain.com 
-ldap_p 389 -ldap_d cn=orcladmin -ldap_w welcome -portal_only  -chost 
myHostname.domain.com -cport_i 8001 -cport_a 8000 -sso_c 
myhost.domain.com:1521:mySID -sso_h myApache.domain.com -sso_p 7777 
-ultrasearch-oh /home/oracle -mc false -mi true

Usage example

SSO Server only configuration

ptlasst.csh -i typical -mode MIDTIER -o orasso -op orasso -odad websso_sso 
-silent -verbose -ldap_h myOID.domain.com -ldap_p 389 -ldap_d cn=orcladmin 
-ldap_w welcome -sso_only -sso_c myhost.domain.com:1521:mySID -sso_h 
myApache.domain.com -sso_p 7777  -oh /home/oracle -mc false -mi true

Table 3-2 List of supported parameters for the MIDTIER mode.

Parameter	Description
`-i`	Install type. This can be set to typical and custom. In the typical mode, the OPCA takes all the user input passed in on the command line and only a progress bar will be visible. In the custom mode, the OPCA user interface is invoked, which includes all the wizards that prompt for user input, containing the values that are passed in on the command line if they are specified. Note that the Repository Access API's are only used only in the typical mode. Note also that the -silent parameter takes precedence over the -i parameter.
`-mode`	Mandatory install mode. The different install modes are PORTAL, SSO, SSOPARTNERCONFIG, LANGUAGE, MIDTIER, ALL, SYSOBJECTS.
`-mi`	Mandatory Midtier Installation. This includes the Oracle9iAS Portal OID and Oracle9iAS Single Sign-On Server integration. Default value: true
`-mc`	Mandatory middle-tier Configuration. This includes the Oracle9iAS Portal OC4J deployment and Oracle Enterprise Manager configuration. Default value: false
`-s`	Portal schema name. Default value: portal.
`-sp`	Portal schema password. Default value: portal.
`-c`	Mandatory connect string to the target Portal database. The format should be hostname:port:sid
`-sdad`	-sdad Portal Schema DAD name. Default value: portal
`-o`	Oracle9iAS Single Sign-On Server schema name. Default value: orasso.
`-op`	Oracle9iAS Single Sign-On Server password. Default value: orasso.
`-odad`	Oracle9iAS Single Sign-On Server DAD name. Default value: orasso.
`-host`	Mandatory HTTP server host name used for Oracle9iAS Portal.
`-port`	Mandatory HTTP server Port number used for Oracle9iAS Portal.
`-chost`	Oracle9iAS Web Cache host.
`-cport_i`	Oracle9iAS Web Cache invalidation port.
`-cport_a`	Oracle9iAS Web Cache administration port.
`-ldap_h`	Mandatory Host name of the OID server.
`-ldap_p`	Mandatory Port number of the OID server.
`-ldap_d`	Mandatory Administration DN.
`-ldap_w`	Mandatory Password for DN.
`-sso_c`	Connect string for the SSO database. The format should be hostname:port:sid.
`-sso_h`	HTTP server host name used for Oracle9iAS Single Sign-On Server.
`-sso_p`	HTTP server port number used for SSP.
`-ultrasearch`	Ultrasearch Integration.
`-oh`	Oracle Home.
`-portal_only`	Middle-tier Configuration for Oracle9iAS Portal only.
`-sso_only`	Middle-tier configuration for Oracle9iAS Single Sign-On Server only.
`-silent`	Runs the OPCA in silent mode.
`-verbose`	This parameter enables the Oracle9i Reports integration with Oracle9iAS Portal. If this parameter is not set, logging information will be brief and the OPCA aborts the installation if it encounters any kind of ORA-,PLS- or SP2 errors.

See also:

Oracle9i Application Server Administrator's Guide for more information on Oracle Enterprise Manager.

3.2.3 SSO OPCA Mode

Action

Installs a stand-alone Oracle9iAS Single Sign-On Server.

Assumptions

OID has been installed and fully configured.
The middle-tier is installed.
The Oracle9iAS Single Sign-On Server DAD has been created.

Usage example

SSO Server Install with repository and middle-tier

ptlasst.csh -i typical -mode SSO -s orasso -sso_c myhost.domain.com:1521:mySID 
-p change_on_install  -o orasso -odad orasso -sso_h myApache.domain.com -sso_p 
7777  -u users -t temp -d users -l users -in users -silent -verbose  -owa -ldap_
h myOID.domain.com -ldap_p 389 -ldap_d cn=orcladmin -ldap_w welcome -ssotype all

Usage example

SSO Server repository only install

ptlasst.csh -i typical -mode SSO -s orasso -sso_c myhost.domain.com:1521:mySID 
-p change_on_install -o orasso -u users -t temp -d users -l users -in users 
-silent -verbose -owa -ssotype repository

Usage example

SSO Server middle-tier only configuration

ptlasst.csh -i typical -mode SSO -s orasso -sso_c myhost.domain.com:1521:mySID 
-p change_on_install  -o orasso -odad orasso -sso_h myApache.domain.com -sso_p 
7777  -u users -t temp -d users -l users -in users -silent -verbose -owa -ldap_h 
myOID.domain.com -ldap_p 389 -ldap_d cn=orcladmin -ldap_w welcome -ssotype 
midtier

Table 3-3 List of supported parameters for the SSO mode

Parameter	Description
`-i`	Install type. This can be set to typical and custom. In the typical mode, the OPCA takes all the user input passed in on the command line and only a progress bar will be visible. In the custom mode, the OPCA user interface is invoked, which includes all the wizards that prompt for user input, containing the values that are passed in on the command line if they are specified. Note that the Repository Access API's are only used only in the typical mode. Note also that the -silent parameter takes precedence over the -i parameter.
`-mode`	Mandatory install mode. The different install modes are PORTAL, SSO, SSOPARTNERCONFIG, LANGUAGE, MIDTIER, ALL, SYSOBJECTS.
`-sso_c`	Mandatory connect string to the target database. The format should be hostname:port:sid.
`-sso_h`	HTTP server hostname for the Oracle9iAS Single Sign-On Server.
`-sso_p`	HTTP server port number for the Oracle9iAS Single Sign-On Server.
`-ssotype`	Mandatory option with three possible values: ALL, REPOSITORY, MIDTIER.
`-p`	SYS password for the target database.
`-o`	Oracle9iAS Single Sign-On Server server schema name.
`-odad`	Oracle9iAS Single Sign-On Server DAD name.
`-u`	Default tablespace.
`-d`	Document tablespace.
`-l`	Logging tablespace.
`-in`	Index tablespace.
`-silent`	Runs the OPCA in silent mode.
`-verbose`	This parameter enables the Oracle9i Reports integration with Oracle9iAS Portal. If this parameter is not set, logging information will be brief and the OPCA aborts the installation if it encounters any kind of ORA-,PLS- or SP2 errors.
`-owa`	This parameter installs the PL/SQL Web Toolkit and other SYS schema packages. This need to be installed just once in the database.
`-ldap_h`	Host name of the OID server.
`-ldap_p`	Port number of the OID server.
`-ldap_d`	Administration DN.
`-ldap_w`	Password for DN.

3.2.4 SSOPARTNERCONFIG OPCA Mode

Action

Allows an Oracle9iAS Portal partner application to add to, modify, or delete, it's configuration information relating to the Oracle9iAS Single Sign-On Server. This mode appends to the existing configurations.

Assumptions

Oracle9iAS Portal and Oracle9iAS Single Sign-On Server server are installed.
The Oracle9iAS Portal and Oracle9iAS Single Sign-On Server DADs are created.
The Oracle HTTP Server is installed, configured and running.

Usage example

Add or modify a Partner application

ptlasst.csh -i typical -mode SSOPARTNERCONFIG -s_id mySiteId -s_tkn mySiteToken 
-s_key  2145432 -s_cookie v1.2 -ps websso_ps -pp websso_ps -pd myPwdDBLink -s 
portal -sp portal -c myhost.domain.com:1521:mySID -sdad portal -odad websso 
-host myApache.domain.com -port 7777 -silent -verbose -sso_c 
myhost.domain.com:1521:mySID -sso_h myApache.domain.com -sso_p 7777 -p_tns 
orasso_ps -s_tns portal

Usage example

Delete a Partner application

ptlasst.csh -i typical -mode SSOPARTNERCONFIG -s portal -sp portal -c 
myhost.domain.com:1521:mySID -silent -verbose -remove portalHost

Table 3-4 List of supported parameters for the SSOPARTNERCONFIG mode

Parameter	Description
`-i`	Install type. This can be set to typical and custom. In the typical mode, the OPCA takes all the user input passed in on the command line and only a progress bar will be visible. In the custom mode, the OPCA user interface is invoked, which includes all the wizards that prompt for user input, containing the values that are passed in on the command line if they are specified. Note that the Repository Access API's are only used only in the typical mode. Note also that the -silent parameter takes precedence over the -i parameter.
`-mode`	Mandatory install mode. The different install modes are PORTAL, SSO, SSOPARTNERCONFIG, LANGUAGE, MIDTIER, ALL, SYSOBJECTS.
`-s_id`	Mandatory Site ID corresponding to the Oracle9iAS Single Sign-On Server's partner application configuration entry for this Oracle9iAS Portal instance.
`-s_tkn`	Mandatory Site token corresponding to the Oracle9iAS Single Sign-On Server's partner application configuration entry for this Oracle9iAS Portal instance.
`-s_key`	Mandatory Encryption Key corresponding to the Oracle9iAS Single Sign-On Server partner application configuration entry for this Oracle9iAS Portal instance.
`-s_cookie`	Mandatory Cookie version being used by the Oracle9iAS Single Sign-On Server.
`-ps`	Mandatory Password store schema.
`-pp`	Mandatory Password store password.
`-pd`	Mandatory Database link from Portal schema to password store.
`-s`	Mandatory Portal schema name.
`-sp`	Portal schema password.
`-c`	Connect string to the target database. The format should be hostname:port:sid.
`-sdad`	DAD for the Oracle9iAS Portal schema.
`-odad`	DAD for the Oracle9iAS Single Sign-On Server schema.
`-host`	HTTP server hostname for Oracle9iAS Portal.
`-port`	HTTP server port number for Oracle9iAS Portal.
`-silent`	Runs the OPCA in silent mode.
`-verbose`	This parameter enables the Oracle9i Reports integration with Oracle9iAS Portal. If this parameter is not set, logging information will be brief and the OPCA aborts the installation if it encounters any kind of ORA-,PLS- or SP2 errors.
`-sso_c`	Connect string to the target database. The format should be hostname:port:sid.
`-sso_h`	HTTP server hostname for Oracle9iAS Single Sign-On Server.
`-sso_p`	HTTP server portnumber for Oracle9iAS Single Sign-On Server.
`-p_tns`	Mandatory TNS connect string to Password Store.
`-s_tns`	Mandatory TNS connect string to Portal.
`-remove`	Removes the enabler configuration entry associated with the specified Portal.

3.2.5 LANGUAGE OPCA Mode

Action

Installs the strings for a specific language in the Oracle9iAS Portal repository or Oracle9iAS Single Sign-On Server or both.

Oracle9iAS Portal is translated into 29 different languages. This allows developers to work in their own language when they build portals. In addition, the self-service content management supports multiple languages so that end users can provide documents and other content in different languages. Those who view the content can see the version that corresponds to the language setting in the browser or to the language they have selected in the set language portlet.

The table below shows the languages that are available for Oracle9iAS Portal:

Table 3-5 Oracle9iAS Portal Languages

Language	Language Abbreviation
Arabic	ar
Czech	cs
German	d
Danish	dk
Spanish	e
Greek	el
Latin American Spanish	esa
French	f
Canadian French	frc
Hebrew	iw
Hungarian	hu
Italian	i
Japanese	ja
Korean	ko
Norwegian	n
Dutch	nl
Polish	pl
Portuguese	pt
Brazilian Portuguese	ptb
Romanian	ro
Russian	ru
Swedish	s
Finnish	sf
Slovak	sk
Turkish	tr
Thai	th
Simplified Chinese	zhs
Traditional Chinese	zht

To install languages when you install Oracle9iAS Portal, run OPCA in the LANGUAGE mode. Note that you must run the ptlasst.csh script with -mode LANGUAGE for each language that you want Oracle9iAS Portal to support.

Running the ptlasst.csh script with -mode LANGUAGE invokes the Oracle9iAS Portal Configuration Assistant (OPCA) in the silent mode to install the language. Usage information on the ptlasst.csh script is generated by running the script without any parameters.

Assumptions

Portal and SSO repository has been already installed.

Usage example

Full usage

ptlasst.csh -mode LANGUAGE -s portal -sp portal -o orasso -op orasso -c 
myhost.domain.com:1521:mySID -lang us -available-silent-verbose-sso_c 
myhost.domain.com:1521:mySID

Usage example

Portal and SSO Server are installed on the same database

ptlasst.csh -mode LANGUAGE -s portal -sp portal -o orasso -op orasso -c 
myhost.domain.com:1521:mySID -lang us -available-silent-verbose

Usage example

Language requirement is for the Portal Repository only

ptlasst.csh -mode LANGUAGE -s portal -sp portal -c myhost.domain.com:1521:mySID 
-lang us -available -silent -m portal -verbose

Usage example

Language requirement is for the SSO Repository only.

ptlasst.csh-mode LANGUAGE -o orasso -op orasso -sso_c 
myhost.domain.com:1521:mySID -lang us -available -silent -m sso -verbose

Table 3-6 List of supported Parameters for the LANGUAGE mode

Parameter	Definition
`-mode`	Mandatory install mode. The different install modes are PORTAL, SSO, SSOPARTNERCONFIG, LANGUAGE, MIDTIER, ALL, SYSOBJECTS.
`-s`	Portal schema name. Default value: `portal`.
`-sp`	Portal schema password. Default value: `portal`.
`-c`	Mandatory connect string to the target database. The format should be hostname:port:sid.
`-o`	Oracle9iAS Single Sign-On Server schema name. Default value: `orasso`.
`-op`	Oracle9iAS Single Sign-On Server password. Default value: `orasso`.
`-sso_c`	Connect string to the target database where Oracle9iAS Single Sign-On Server is installed. The format should be `hostname:port:sid`. Note: If the Oracle9iAS Portal and Oracle9iAS Single Sign-On Server use the same database, argument `-c` would take care of both the Oracle9iAS Portal and Oracle9iAS Single Sign-On Server connections.
`-lang`	Abbreviation for the language to install. Default value: u`s`
`-m`	If `sso`, translations are only for Oracle9iAS Single Sign-On Server repository. If `portal`, translations are only for Oracle9iAS Portal repository. If not specified, translations are installed for both.
`-available`	Sets whether the language will be available for user translation.
`-silent`	Runs the OPCA in the silent mode. Default value: `TRUE`.
`-verbose`	Enables the logging in detail mode. Even if there are errors in the log file, the OPCA install would continue. If this parameter is not set, logging information will be brief and the OPCA aborts the installation if it encounters any kind of ORA-,PLS- or SP2 errors. Default value: `TRUE`.

Note:

When you configure bidirectional languages (Arabic and Hebrew), you must also execute the ORACLE_HOME/ora9ias/portal30/admin/plsql/nlsres/imginst.sql script as the Portal schema owner.
The character set for mod_plsql must be the same as the customer database character set.

See also:

Oracle9i Application Server Globalization Support Guide in the Oracle9i Application Server documentation library.

3.2.6 ALL OPCA Mode

Action

Installs Oracle9iAS Portal and Oracle9iAS Single Sign-On Server repository.
Configures the Oracle9iAS Portal and Oracle9iAS Single Sign-On Server middle-tier.

Assumptions

OID has been installed and fully configured.
Oracle9iAS Portal and Oracle9iAS Single Sign-On Server are to be installed in the same database.
Middle-tier is already installed, configured and running.

Usage example

Full usage

ptlasst.csh -i typical -mode ALL -s portal -c myhost.domain.com:1521:mySID -p 
change_on_install -sdad portal -o orasso -odad websso_sso -host 
myApache.domain.com -port 7777 -chost myHostname.domain.com -cport_i 8001 
-cport_a 8000 -u users -t temp -d users -l users -in users -demo  -silent 
-verbose -report  -owa -ldap_h myOID.domain.com -ldap_p 389 -ldap_d cn=orcladmin 
-ldap_w welcome -ultrasearch -sso_h myApache.domain.com -sso_p 7777 -oh 
/home/oracle -mc false -mi true

Usage example

Portal and SSO Server on the same database using the same HTTP server

ptlasst.csh -i typical -mode ALL -s portal -c myhost.domain.com:1521:mySID -p 
change_on_install -sdad portal -o orasso -odad websso_sso -host 
myApache.domain.com -port 7777 -chost myHostname.domain.com -cport_i 8001 
-cport_a 8000 -u users -t temp -d users -l users -in users -demo  -silent 
-verbose -report  -owa -ldap_h myOID.domain.com -ldap_p 389 -ldap_d cn=orcladmin 
-ldap_w welcome -ultrasearch-oh /home/oracle -mc false -mi true

Table 3-7 List of supported parameters for the ALL mode

Parameter	Description
`-i`	Install type. This can be set to typical and custom. In the typical mode, the OPCA takes all the user input passed in on the command line and only a progress bar will be visible. In the custom mode, the OPCA user interface is invoked, which includes all the wizards that prompt for user input, containing the values that are passed in on the command line if they are specified. Note that the Repository Access API's are only used only in the typical mode. Note also that the -silent parameter takes precedence over the -i parameter.
`-mode`	Mandatory install mode The different install modes are PORTAL, SSO, SSOPARTNERCONFIG, LANGUAGE, MIDTIER, ALL, SYSOBJECTS.
`-s`	Portal schema name.
`-c`	Mandatory connect string to the target database. The format should be hostname:port:sid.
`-p`	Mandatory SYS password of the target database.
`-sdad`	DAD for the Portal repository.
`-o`	Oracle9iAS Single Sign-On Server schema name.
`-odad`	DAD for the Oracle9iAS Single Sign-On Server server.
`-host`	Mandatory HTTP server Hostname for Oracle9iAS Portal.
`-port`	Mandatory HTTP server Port for Oracle9iAS Portal.
`-u`	Default tablespace.
`-t`	Temporary tablespace.
`-d`	Document tablespace.
`-l`	Logging tablespace.
`-in`	Index tablespace.
`-chost`	Oracle9iAS Web Cache host.
`-cport_i`	Oracle9iAS Web Cache invalidation port.
`-cport_a`	Oracle9iAS Web Cache administration port.
`-demo`	Portlet builder demo components will be installed.
`-silent`	Runs the OPCA in silent mode.
`-verbose`	This parameter enables the Oracle9i Reports integration with Oracle9iAS Portal. If this parameter is not set, logging information will be brief and the OPCA aborts the installation if it encounters any kind of ORA-,PLS- or SP2 errors.
`-report`	This parameter enables the Oracle9i Reports integration with Oracle9iAS Portal.
`-owa`	This parameter installs the PL/SQL Web Toolkit and other SYS schema packages. This need to be installed just once in the database.
`-ldap_h`	Host name of the OID server.
`-ldap_p`	Port number of the OID server.
`-ldap_d`	Administration DN.
`-ldap_w`	Password for DN.
`-sso_h`	HTTP server Hostname for the SSO.
`-sso_p`	HTTP server port number for the SSO.
`-oh`	Oracle Home.
`-mc`	Middle-tier Installation. This includes the Oracle9iAS Portal's OID and Oracle9iAS Single Sign-On Server integration. Default value: TRUE
`-mi`	Midtier Configuration. This includes Oracle9iAS Portal's OC4J deployment and Oracle Enterprise Manager configuration. Default value: FALSE

3.2.7 SYSOBJECTS OPCA Mode

Action

Installs Oracle9iAS Portal and Oracle9iAS Single Sign-On Server required SYS schema dependencies as follows:

Installs PL/SQL Web Toolkit (OWA) packages

Installs VPD Context packages

Note:

This mode needs to be run only once per database.
The -sys option in the modes ALL, PORTAL and SSO provide the same functionality.
Only a silent install is supported for this mode.

Usage example

Full Usage

ptlasst.csh -mode SYSOBJECTS -c myhost.domain.com:1521:mySID -p change_on_
install -silent -verbose

Table 3-8 List of supported parameters for the SYSOBJECTS mode

Parameter	Description
`-mode`	Mandatory install mode. The different install modes are PORTAL, SSO, SSOPARTNERCONFIG, LANGUAGE, MIDTIER, ALL, SYSOBJECTS.
`-c`	Mandatory connect string to the target database. The format should be hostname:port:sid.
`-p`	Mandatory SYS password for the target database.
`-silent`	Runs the OPCA in silent mode. Default value: TRUE
`-verbose`	This parameter enables the Oracle9i Reports integration with Oracle9iAS Portal. If this parameter is not set, logging information will be brief and the OPCA aborts the installation if it encounters any kind of ORA-,PLS- or SP2 errors. Default value: TRUE

3 Configuring Oracle9iAS Portal using OPCA

3.1 The Oracle9iAS Portal Configuration Assistant (OPCA)

3.1.1 OPCA and the Oracle9i Application Server Installation

3.1.2 Using OPCA in Stand-alone mode

On Windows NT/2000:

On UNIX:

3.2 OPCA Modes

3.2.1 PORTAL OPCA Mode

Action

Usage Example

Table 3-1 List of supported parameters for the PORTAL mode

3.2.2 MIDTIER OPCA Mode

Action

Assumptions

Usage example

Usage example

Usage example

Usage example

Usage example

Table 3-2 List of supported parameters for the MIDTIER mode.

3.2.3 SSO OPCA Mode

Action

Assumptions

Usage example

Usage example

Usage example

Table 3-3 List of supported parameters for the SSO mode

3.2.4 SSOPARTNERCONFIG OPCA Mode

Action

Assumptions

Usage example

Usage example

Table 3-4 List of supported parameters for the SSOPARTNERCONFIG mode

3.2.5 LANGUAGE OPCA Mode

Action

Table 3-5 Oracle9iAS Portal Languages

Assumptions

Usage example

Usage example

Usage example

Usage example

Table 3-6 List of supported Parameters for the LANGUAGE mode

3.2.6 ALL OPCA Mode

Action

Assumptions

Usage example

Usage example

Table 3-7 List of supported parameters for the ALL mode

3.2.7 SYSOBJECTS OPCA Mode

Action

Usage example

Table 3-8 List of supported parameters for the SYSOBJECTS mode

3
Configuring Oracle9iAS Portal using OPCA