B Silent Installation

This appendix describes how to install OracleAS Metadata Repository in silent mode. This appendix contains the following topics:

Section B.1, "Silent Installation"
Section B.2, "Create the Response File and Map File"
Section B.3, "Start the Installation"
Section B.4, "Post-Installation"
Section B.5, "Security Tips for Silent Installations"

B.1 Silent Installation

Silent installation eliminates the need to monitor OracleAS Metadata Repository Creation Assistant because there is no graphical output and no input by the user.

Silent installation of OracleAS Metadata Repository is accomplished by supplying the runRepca command with a response file. The response file is a text file containing variables and parameter values which provide answers to the installer prompts.

Use silent installation of OracleAS Metadata Repository when there are similar installations on more than one computer. Additionally, use silent install when performing the OracleAS Metadata Repository installation from a remote location using the command line.

B.2 Create the Response File and Map File

Before doing a silent installation, you must provide information specific to your installation in a response file. The installer will fail if you attempt an installation using a response file that is not configured correctly. If you are loading OracleAS Metadata Repository, you must also provide a map file to specify tablespace information. Response files and map files are text files that you can create or edit in a text editor.

B.2.1 Creating Response Files and Map Files from Templates

Templates for response files and map files are available in the ORACLE_HOME/repca/configdirectory. The directory contains the following templates:

Table B-1 Templates in the ORACLE_HOME/repca/config Directory

FileType	Filename
Response File for OracleAS Metadata Repository Creation Assistant	`repca.rsp`
Map File for Database that Uses File System	`file_tablespace.map`
Map File for Database that Uses Raw Devices	`raw_tablespace.map`
Map File for Database that Uses Oracle-Managed Files or Automatic Storage Management	`omf_asm_tablespace.map`

See the template files for descriptions of the parameters in the file.

Note:

For Boolean parameters, specify either "true" or "false".

B.2.2 Example Response Files

The following sections shows example response files for the following OracleAS Metadata Repository installation types:

Section B.2.2.1, "Example Files for Loading OracleAS Metadata Repository in a Database that Uses a File System"
Section B.2.2.2, "Example Response File for Registering with Oracle Internet Directory"

Note:

Be sure that you read the description of each parameter=value in the provided sample files, and edit value accordingly for your environment.

B.2.2.1 Example Files for Loading OracleAS Metadata Repository in a Database that Uses a File System

The following shows an example of a response file and a map file for a silent installation of OracleAS Metadata Repository into a file-based database as described in Section 2.1, "Installing in a Database that Uses the File System".

B.2.2.1.1 Example Response File for Loading OracleAS Metadata Repository in a Database that Uses a File System

The following shows an example of a response file for a silent installation. Note that for the loading operation, you only need to complete the sections named [GENERAL], [INSTALL_TYPE], [ORACLE_HOME], [DATABASE_CONNECT], and [STORAGE_MECHANISM]. You must also complete the section named [STORAGE_MECHANISM_FILE] because you are installing in database that uses a file system. Optionally, you may fill out the section named [ADVANCED]. You must include the other sections, but the information in them will be ignored.

[GENERAL]
RESPONSEFILE_VERSION=10.1.2.0.1

[INSTALL_TYPE]
OPERATION=LOAD

[ORACLE_HOME]
DATABASE_ORACLE_HOME="/private2/oracle/repcadb"
LOG_DIRECTORY="/private1/oracle/log"

[DATABASE_CONNECT]
DATABASE_TYPE=SINGLE
DATABASE_HOST_PORT = dbhost.oracle.com:1521
DATABASE_SERVICE_NAME = orcl
DATABASE_USER = SYS
DATABASE_PASSWORD = welcome1

[STORAGE_MECHANISM]
STORAGE_TYPE=FILE

[STORAGE_MECHANISM_FILE]
SAME_DIRECTORY_FOR_ALL = false
TABLESPACE_LOCATION ="/private1/oradata/orcl"
TABLESPACE_LOCATION_FILE_SPEC_FILE ="/private1/file_tablespace.map"

[STORAGE_MECHANISM_OMF]
TABLESPACE_LOCATION_OMF_SPEC_FILE ="default"

[STORAGE_MECHANISM_ASM]
DISK_GROUP ="datadisk1"
TABLESPACE_LOCATION_ASM_SPEC_FILE ="default"

[STORAGE_MECHANISM_RAW]
TABLESPACE_LOCATION_RAW_SPEC_FILE ="default"

[ORACLE_INTERNET_DIRECTORY]
ORACLE_INTERNET_DIRECTORY_HOST ="default"
ORACLE_INTERNET_DIRECTORY_PORT =389
ORACLE_INTERNET_DIRECTORY_SSL = false
ORACLE_INTERNET_DIRECTORY_USER ="cn=orcladmin"
ORACLE_INTERNET_DIRECTORY_PASSWORD=default
ORACLE_INTERNET_DIRECTORY_REALM ="default"
ORACLE_INTERNET_DIRECTORY_CONTEXT ="cn=OracleContext"

[ADVANCED]
PROCEED_ON_KNOWLEDGEBASE_FAILURE=false
DROP_CONFLICTING_SCHEMAS =false
SYSTEM_UNDO_TABLESPACE_REQUIREMENT_MET =false

B.2.2.1.2 Map File For File-Based Database

The following is an example of the tablespace file that you specified in the response file in the line TABLESPACE_LOCATION_FILE_SPEC_FILE ="/private1/file_tablespace.map".

PORTAL=HEAVY:/private/oradata/portal
PORTAL_DOC=HEAVY:/private/oradata/portal
PORTAL_IDX=HEAVY:/private/oradata/portal
PORTAL_LOG=HEAVY:/private/oradata/portal
IAS_META=MEDIUM:/private/oradata/iasmeta
DISCO_PTM5_META=MEDIUM:/private/oradata/disco1
DISCO_PTM5_CACHE=MEDIUM:/private/oradata/disco2
DCM=MEDIUM:/private/oradata/dcm
DSGATEWAY_TAB=MEDIUM:/private/oradata/dsgateway
WCRSYS_TS=MEDIUM:/private/oradata/wcrsys
B2B_RT=MEDIUM:/private/oradata/b2b_rt
B2B_DT=MEDIUM:/private/oradata/b2b_dt
B2B_IDX=MEDIUM:/private/oradata/b2b_idx
B2B_LOB=MEDIUM:/private/oradata/b2b_lob
BAM=MEDIUM:/private/oradata/bam
ORABPEL=MEDIUM:/private/oradata/orabpel
OCATS=SMALL:/private/oradata/oca
UDDISYS_TS=SMALL:/private/oradata/uddisys
OLTS_ATTRSTORE=SMALL:/private/oradata/oid1
OLTS_BATTRSTORE=SMALL:/private/oradata/oid2
OLTS_CT_STORE=SMALL:/private/oradata/oid3
OLTS_DEFAULT=SMALL:/private/oradata/oid4
OLTS_SVRMGSTORE=SMALL:/private/oradata/oid4

B.2.2.2 Example Response File for Registering with Oracle Internet Directory

The following shows an example of a response file for a silent registration of OracleAS Metadata Repository with an Oracle Internet Directory as described in Section 3.1, "Registering with Oracle Internet Directory".

Note that for the registering operation, you only need to complete the sections named [GENERAL], [INSTALL_TYPE], [ORACLE_HOME], [DATABASE_CONNECT], and [ORACLE_INTERNET_DIRECTORY]. Optionally, you may fill out the section named [ADVANCED]. You must include the other sections, but the information in them will be ignored.

[GENERAL]
RESPONSEFILE_VERSION=10.1.2.0.1

[INSTALL_TYPE]
OPERATION=REGISTER

[ORACLE_HOME]
DATABASE_ORACLE_HOME="/private2/oracle/repcadb"
LOG_DIRECTORY="/private1/oracle/log"

[DATABASE_CONNECT]
DATABASE_TYPE=SINGLE
DATABASE_HOST_PORT = dbhost.oracle.com:1521
DATABASE_SERVICE_NAME = orcl
DATABASE_USER = SYS
DATABASE_PASSWORD = welcome1

[STORAGE_MECHANISM]
STORAGE_TYPE=FILE

[STORAGE_MECHANISM_FILE]
SAME_DIRECTORY_FOR_ALL = false
TABLESPACE_LOCATION ="default"
TABLESPACE_LOCATION_FILE_SPEC_FILE ="default"

[STORAGE_MECHANISM_OMF]
TABLESPACE_LOCATION_OMF_SPEC_FILE ="default"

[STORAGE_MECHANISM_ASM]
DISK_GROUP ="datadisk1"
TABLESPACE_LOCATION_ASM_SPEC_FILE ="default"

[STORAGE_MECHANISM_RAW]
TABLESPACE_LOCATION_RAW_SPEC_FILE ="default"

[ORACLE_INTERNET_DIRECTORY]
ORACLE_INTERNET_DIRECTORY_HOST ="foo.acme.com"
ORACLE_INTERNET_DIRECTORY_PORT =389
ORACLE_INTERNET_DIRECTORY_SSL = false
ORACLE_INTERNET_DIRECTORY_USER ="cn=orcladmin"
ORACLE_INTERNET_DIRECTORY_PASSWORD=welcome123
ORACLE_INTERNET_DIRECTORY_REALM ="foobar"
ORACLE_INTERNET_DIRECTORY_CONTEXT ="cn=OracleContext"

[ADVANCED]
PROCEED_ON_KNOWLEDGEBASE_FAILURE=false
DROP_CONFLICTING_SCHEMAS =false
SYSTEM_UNDO_TABLESPACE_REQUIREMENT_MET =false

B.3 Start the Installation

To make the installer use the response file, specify the location of the response file that you want to use as a parameter when running the runRepca command using the -SILENT option.

To perform a silent installation, run the following command:

prompt> ORACLE_HOME/runRepca -SILENT -RESPONSEFILE absolute_path_and_filename

Note:

The options for the runRepca command are case sensitive.

B.4 Post-Installation

The success or failure of silent installations is logged in the repca_<time_stamp>.log file. The log file is created in the directory specified in the response file by the LOG_DIRECTORY parameter.

B.5 Security Tips for Silent Installations

One of the pieces of information in the response file is the database password and the Oracle Internet Directory password. The password information is in clear text.

To minimize security issues regarding the password in the response file, follow these guidelines:

Set the permissions on the response files so that they are readable only by the operating system user who will be performing the silent installation.
If possible, remove the response files from the system after the silent installation is completed.