5         Installation

This section provides detailed steps to install the OFS ALM Application Pack.

Topics:

·        Installation Checklist 

·        Extract the OFS ALM Application Pack Software

·        Configure the OFS_ALM_PACK.xml File

·        Configure Schema Creator Utility 

·        Execute the Schema Creator Utility

·        Configure the OFSAAI_InstallConfig.xml File

·         Manifest.xml file

·        Configure the Silent.props file

·        Install the OFS ALM Application

·        Install the OFS ALM Application on Existing OFSAA Instance

Installation Checklist

You can use this checklist to have a quick glance at everything that you will be doing to install this application. The link provided in each step takes you to a section either within this document or to another referenced document.

Table 5: Installation Checklist

Sl. No.

Activity

1

Extract the installer kit.

2

Configure the OFS_ALM_PACK.xml file.

3

Configure the Schema Creator Utility.

4

Execute the Schema Creator Utility in Offline, Online, or TCPS modes and verify the log file.

5

Configure the OFSAAI_InstallConfig.xml file.

6

Configure the Manifest.xml file.

7

Configure the Silent.props file.

8

Trigger the OFS ALM Application Pack installation.

9

Install ALM Pack on Pack.

Extract the OFS ALM Application Pack Software

You must be logged in to the UNIX operating system as a non-root user to perform the following steps. To extract the software, follow these steps:

1.     If you already have an unzip utility to extract the contents of the downloaded archive, skip this step. Uncompress the unzip installer file with the command:

2.     Download the unzip utility (OS-specific) unzip_<os>.Z and copy it in Binary mode to the directory that is included in your PATH variable.

uncompress unzip_<os>.Z

 

NOTE

If an error message "uncompress: not found [No such file or directory]" is displayed, contact your UNIX administrator.

 

3.     Assign 751 permission to the file using the following command:

chmod 751 unzip_<OS>

For example chmod 751 unzip_sparc

4.     Extract the contents of the OFS ALM Application Pack Release 8.1.0.0.0 installer archive file in the download directory using the following command:

unzip OFS_ALM_PACK.zip

NOTE

Do not rename the Application Pack installer folder name on extraction from the archive.

 

5.      Extract the following one-off patches in the download directory:

a.       31545589

b.      31605076

6.     Navigate to the download directory and assign 750 permission to the installer directory using the following command:

chmod -R 750 OFS BSP Pack

 

Install Pre-installation Patches

Apply the 31545589 one-off patch and see the Readme packaged with the patch for further instructions on how to install before proceeding with OFS ALM 8.1.0.0.0 installation.

See My Oracle Support for more information on the latest release.

Configure the OFS_ALM_PACK.xml File

The OFS_ALM_PACK.xml file contains details of the various products that are packaged together in the OFS ALM Applications Pack.

To configure the OFS_ALM_PACK.xml file, follow these steps:

1.     Navigate to the OFS_ALM_PACK/conf directory.

2.     Open the OFS_ALM_PACK.xml file in a text editor.

3.     Configure the OFS_ALM_PACK.xml file as mentioned in the following table.

Figure 4: Sample OFS_ALM_PACK.xml File

This is a sample of the OFS_ALM_Pack.xml file.

Description of Sample OFS_CFE_PACK.xml File as follows

 

Table 9: OFS_ALM_PACK.xml File Parameters

Tag Name or Attribute Name

Description

Mandatory (Y or N)

Comments

APP_PACK_ID

Unique Application Pack Identifier

Y

Unique Seeded Value. Do not modify this value.

IS_OPT_INSTALL VALUE="TRUE"

Unique Application Entry

Y

Unique Seeded Value. Do not modify this value.

APP_PACK_NAME

Unique Application Pack Name

Y

Unique Seeded Value. Do not modify this value.

APP_PACK_DESCRIPTION

Unique Application Pack Description

Y

Unique Seeded Value. Do not modify this value.

VERSION

Unique release version

Y

Unique Seeded Value. Do not modify this value.

APP

Unique Application Entries

Y

Unique Seeded Value. Do not modify this value.

APP_ID

Unique Application Identifier

Y

Unique Seeded Value. Do not modify this value.

APP_ID/ PREREQ

Prerequisite Application or Product

Y

Unique Seeded Value.

For most applications, the prerequisite that is set is OFS ALM. For all other applications, the default Application ID is set to none. You can set it for the applications you want to install.

Do not modify this value.

APP_ID/ DEF_SEL_FLAG

Default Selected Flag

Y

In all Application Packs, Infrastructure requires this value to be set to "YES".

Do not modify this value.

APP_ID/ ENABLE

Enable Application or Product

Y

·        Default YES for Infrastructure

·        NO for Others

Set this attribute value to YES against every APP_ID which is licensed and must be enabled for use.

NOTE: The Application or Product cannot be disabled once enabled.  Only Applications/Products which are enabled are installed. In order to enable other licensed Applications/Products, you need to reinstall by making the flag as Y for the App_ID. However, in case of reinstallation to enable the other Applications/Products, execution of the schema creation utility must be skipped if it does not include any additional sandboxes to be created.

APP_NAME

Unique Application or Product Name

Y

Unique Seeded Value. Do not modify this value.

APP_DESCRIPTION

Unique Application or Product Name

Y

Unique Seeded Value. Do not modify this value.

VERSION

Unique release version

Y

Unique Seeded Value. Do not modify this value.

 

Configure the Schema Creator Utility

Creating Database Users or Schemas (RDBMS) is one of the primary steps in the complete OFS ALM installation process. The Schema Creator utility enables you to quickly get started with the installation by creating Database User(s) or Schema(s) (RDBMS), assigning the necessary GRANT(s), creating the required entities in the Schemas and so on.

Configure and execute the schema creator utility before installing the OFS ALM Application Pack.

Topics:

·        Prerequisites

·        Configure Schema Creator Utility for RDBMS Installation

Prerequisites

Ensure you have the following before configuring the Schema Creator Utility:

·        Oracle User ID or Password with SYSDBA privileges

·        JDBC Connection URL for RAC or Non RAC database

·        The HOSTNAME or IP of the server on which OFSAA is getting installed

For HIVE installation, you must also have the following:

·        HIVE connection credentials (for example, Kerberos connection properties)

·        Hostname or IP of the HIVE Server installation

Configure the Schema Creator Utility for RDBMS Installation

If the installation is being performed for RDBMS, provide the Pack specific Schema details in the OFS_ALM_SCHEMA_IN.xml file.

You can configure the following types of Schemas:

·        CONFIG: This Schema contains the entities and other objects required for OFSAA setup configuration information. Only one CONFIG Schema per OFSAA instance is permitted.

·        ATOMIC: This Schema contains the data model entities. One ATOMIC Schema is attached to one Information Domain. You can have multiple ATOMIC Schemas for a single OFSAA Instance.

Configure the OFS_ALM_SCHEMA_IN.xml File

This section describes how to create database schemas, objects within schemas, and assign appropriate grants.

Specify the database schemas required for the installation in the OFS_ALM_SCHEMA_IN.xml file. Update the values of the various tags and parameters available in this file before executing the Schema Creator utility.

This file must be configured only if the database is RDBMS.

To configure the OFS_ALM_SCHEMA_IN.xml file, follow these steps:

1.     Log in to the system as a non-root user.

2.     Navigate to the OFS_ALM_PACK/Schema_Creator/conf directory.

3.     Edit the OFS_ALM_SCHEMA_IN.xml file using a text editor and configure the values as mentioned in the following table. Save the file.

Figure 5: Sample of OFS_ALM_SCHEMA_IN.xml File

4.     This is a sample of the OFS_ALM_SCHEMA_IN.xml file.

Description of Sample OFS_CFE_SCHEMA_IN.xml File as follows


Table 10: OFS_ALM_SCHEMA_IN.xml File Parameters

Tag Name or Attribute Name

Description

Mandatory (Y or N)

Default Value or Permissible Value

Comments

<APP_PACK_ID>

Seeded unique ID for the OFSSAA Application Pack.

Y

Seeded

Do not modify this value.

<IS_TCPS>

Enter if the TCPS configuration is required.

Y

Seeded, with FALSE as the default value.

Modify this to TRUE if you require the installer to uptake the configuration.

<JDBC_URL>

Enter the JDBC URL.

NOTE:

You can enter the following JDBC URL types:

1.     RAC or NON-RAC enabled database connectivity URL.

2.     TCPS RAC or NON-RAC enabled database connectivity URL provided the <IS_TCPS> tag value is TRUE.

3.     Wallet-enabled JDBC URL.

Y

Example:

jdbc:oracle:thin:@< DBSERVER IP/ HOST/ IP>:<PORT>:<SID>

or

jdbc:oracle:thin:@//[HOS T][:PORT]/ SERVICE

or

jdbc:oracle:thin:@(DESCRI PTION=(ADDRESS_ LIST=(ADDRESS=(PROT OCOL=TCP)(HOST=[HO ST])(port=[PORT]))(ADD RESS=(PROTOCOL=TCP) (HOST=[HOST])(PORT=[ PORT]))(LOAD_ BALANCE=yes)(FAILOV ER=yes))(CONNECT_ DATA=(SERVICE_ NAME=[SERVICE])))

For example:

jdbc:oracle:thin:@//dbhos t.server.com:1521/service 1

or

jdbc:oracle:thin:@//dbsho st.server.com:1521/scan-1

or

jdbc:oracle:thin:@(DESCRI PTION=(ADDRESS_ LIST=(ADDRESS=(PROT OCOL=TCP)(HOST=dbhost1.server.com) (port=1521))(ADDRESS=(PROTOCOL=TCP)(HOST=dbhost2.s erver.com)(PORT=1521))( LOAD_BALANCE=yes)(FAILOV ER=yes))(CONNECT_ DATA=(SERVICE_NAME=service1)))

or

<JDBC_URL>jdbc:oracle:thin:@(DESCRIPTION = (ADDRESS = (PROTOCOL =TCPS)(HOST = dbhost.server.com)(PORT = 2484)) (CONNECT_DATA =(SERVER = DEDICATED) (SERVICE_NAME=SERVICEID))(security=(ssl_server_cert_dn=CN=dbhost)))

or

jdbc:oracle:thin:/@

Ensure to add an entry (with SID or SERVICE NAME) in the tnsnames.ora file on the OFSAA server. The entry must match with the SID or SERVICE NAME used in the JDBC URL.

Ensure that you have configured:

4.     The correct Oracle Wallet with the credentials for stored Sys, Config, and Atomic Users.

5.     The JDBC URL as follows:

jdbc:oracle:thin:/@

For more information on how to configure Oracle Wallets for OFSAA Installation and Data Sources, see the Oracle Financial Services Analytical Applications Infrastructure Administration and Configuration Guide.

<JDBC_DRIVER>

The name of the driver is seeded.

Y

Example: oracle.jdbc.driver.OracleDriver

Only JDBC Thin Driver is supported.

Do not modify this value.

<HOST>

Enter the Host Name or IP Address of the system on which you are installing the OFSAA components.

Y

Host Name or IP Address

 

<SETUPINFO>/PREFIX_SCHEMA_NAME

Identifies whether the value specified in <SETUPINFO>/NAME attribute must be prefixed to the Schema name.

N

Y or N

The default value is Y.

<SETUPINFO>/NAME

Enter the acronym for the type of implementation. This information is displayed in the OFSAA Home Page.

On executing the Schema Creator utility, this value is prefixed with each Schema name. For example: dev_ofsaaconf, uat_ofsaatm.

Y

Accepts strings with a minimum length of two and a maximum of four. For example: DEV, SIT, PROD.

This message appears in the OFSAA Landing Page as "Connected To: DEV".

The Schemas that are created get this prefix. For example, dev_ofsaaconf, uat_ofsaaconf, and so on.

<PASSWORD>/ DEFAULT*

Enter the password if you want to set a default password for all Schemas.

You also must set the APPLYSAMEFORALL attribute as Y to apply the default password for all the Schemas.

N

The maximum length allowed is 30 characters. Special characters are not allowed.

On successful execution of the utility, the entered password in the OFS_<APP PACK>_SCHEMA_IN.xml file is cleared.

<PASSWORD>/ APPLYSAMEFORALL

If you have entered Y in APPLYSAMEFORALL attribute and also have specified individual passwords for all the Schemas, then the specified individual passwords will take precedence.

Y

Default N Permissible: Y or N

Enter Y if you want to apply the password specified in the DEFAULT attribute for all the Schemas.

If you enter N,  provide individual passwords for all Schemas.

Setting this attribute value is mandatory if the DEFAULT attribute is set.

<SCHEMA>/TYPE

The types of Schemas supported in this release are: ATOMIC, CONFIG, SANDBOX, and ADDON.

By default, the Schema types are seeded based on the Application Pack.

Y

ATOMIC, CONFIG, SANDBOX, or ADDON

SANDBOX and ADDON Schemas do not apply to OFSAAI.

Only One CONFIG Schema can exist in the file.

Do not edit this attribute value.

This Schema identifies as the CONFIGURATION Schema that contains the OFSAA setup details and other Metadata information.

Multiple ATOMIC, SANDBOX, or ADDON Schemas can exist in the file.

<SCHEMA>/NAME

The Schemas’ names are seeded based on the Application Pack by default.

You can edit the Schema names if required.

The Schema Name will have a prefix of the SETUPINFO/ NAME attribute.

SCHEMA NAME must be the same for all the ATOMIC Schemas of the applications within an Application Pack.

Y

The permissible length is 15 characters and only alphanumeric characters are allowed. No special characters allowed except underscore '_'.

SETUPOINFO/NAME attribute value is prefixed to the Schema name being created.

For example, if a name is set as ofsaatm and setupinfo as uat, then Schema created is uat_ofsaatm.

NAME must be the same where APP_GRP=1 for all SCHEMA tags (not applicable for this Application Pack).

<SCHEMA>/PASSWORD

Enter the password of the Schema to be created.

If this attribute is left blank, then the password specified in the <PASSWORD>/DEFAULT attribute is taken as the Schema Password.

N

The maximum length allowed is 30 characters. Special characters are not allowed.

It is mandatory to enter the password if you have set the <PASSWORD>/ APPLYSAMEFORALL attribute as N.

<SCHEMA>/APP_ID

The Application ID is seeded based on the Application Pack.

Y

Unique Seeded Value

Identifies the Application or Product for which the Schema is being created. Do not modify this attribute value.

Do not modify this value.

<SCHEMA>/DEFAULTTABLESPACE

Enter the available default tablespace for DB User.

If this attribute is left blank, then USERS is set as the default tablespace.

N

Default USERS

Permissible Any existing valid tablespace name.

Modify this value to associate any valid tablespace with the Schema.

<SCHEMA>/TEMPTABLESPACE

Enter the available temporary tablespace for DB User.

If this attribute is left bank, TEMP is set as the default tablespace.

N

Default TEMP

Permissible Any existing valid temporary tablespace name.

Modify this value to associate any valid tablespace with the Schema.

<SCHEMA>/QUOTA

Enter the quota to be set on the DEFAULTTABLESPACE attribute for the Schema or user. By default, the quota size is set to 500M.

Minimum: 500M or Unlimited on default Tablespace.

N

Example:

600M/ m

20G/ g

UNLIMITED/ unlimited

Modify this value to grant the specified quota on the mentioned tablespace to the user.

<SCHEMA>/ INFODOM

Enter the name of the Information Domain to associate this Schema.

The Schema Creator utility automatically derives an Information Domain Name based on the Application Pack if no value is specified for this attribute.

N

Permissible length is 16 characters and only alphanumeric characters are allowed. No special characters are allowed.

 

<ADV_SEC_OPTIONS>/

Parent tag to hold Advance Security Options.

N

 

Uncomment the tag and edit if you want to add security options. For example, TDE and Data Redact.

For details, see the example in the comments for the <TABLESPACE>/ENCRYPT tag.

<ADV_SEC_OPTIONS>/TDE

Tag to enable or disable TDE.

N

The default is FALSE. To enable TDE, set this to TRUE.

Ensure this tag is not commented if you have uncommented <ADV_SEC_OPTIONS>.

<ADV_SEC_OPTIONS>/DATA_REDACT

Tag to enable or disable the Data Redaction feature.

N

The default is FALSE. To enable DATA_REDACT, set this to TRUE.

Ensure this tag is not commented if you have uncommented<ADV_SEC_OPTIONS>.

<TABLESPACES>

Parent tag to hold <TABLESPACE> Elements.

N

NA

Uncomment the tag and edit. ONLY if tablespaces are to be created as part of the installation.

For details, see the example following the table.

When TDE is TRUE in ADV_SEC_OPTIONS, it is mandatory for the <TABLESPACES> tag to be present in the XML file.

<TABLESPACE>/NAME

Logical Name of the tablespace to be created.

Y

 

Name, if specified, must be referred in the <SCHEMA DEFAULTTABLESPACE= "##NAME##"> attribute.

NOTE the ## syntax.

<TABLESPACE>/VALUE

Physical Name of the tablespace to be created.

Y

NA

Value, if specified, is the actual name of the TABLESPACE.

<TABLESPACE>/DATAFILE

Specifies the location of the data file on the server.

Y

NA

Enter the absolute path of the file to be created.

<TABLESPACE>/AUTOEXTEND

Specifies if the tablespace must be extensible or have a hard limit.

Y

ON or OFF

Set to ON to ensure that the tablespace does not run out of space when full.

<TABLESPACE>/ENCRYPT

Specifies if the tablespace (or tablespaces) must be encrypted using TDE.

Y

ON or OFF

Set to ON to ensure that the tablespaces when created are encrypted using TDE.

NOTE: Encryption of tablespaces requires enabling Transparent Data Encryption (TDE) on the Database Server.

Example: The following snippet shows that TDE is enabled and hence the tablespace is shown with encryption ON.

<ADV_SEC_OPTIONS>

<OPTION NAME="TDE" VALUE="FALSE"/>

<OPTION NAME="DATA_REDACT" VALUE="FALSE" />

</ADV_SEC_OPTIONS>

<TABLESPACES>

<TABLESPACE NAME="OFS_AAI_TBSP_1" VALUE="TS_USERS1" DATAFILE="/

scratch/ora19c/app/oracle/oradata/OFSPQA19cDB/ts_users1.dbf" SIZE="500M" AUTOEXTEND="ON" ENCRYPT="ON" />

<TABLESPACE NAME="OFS_AAI_TBSP_2" VALUE="TS_USERS2" DATAFILE="/

scratch/ora19c/app/oracle/oradata/OFSPQA19cDB/ts_users2.dbf" SIZE="500M" AUTOEXTEND="ON" ENCRYPT="ON" />

</TABLESPACES>

 

<SCHEMAS>

<SCHEMA TYPE="CONFIG" NAME="ofsaaconf" PASSWORD="" APP_ID="OFS_AAI" DEFAULTTABLESPACE="##OFS_AAI_TBSP_1##" TEMPTABLESPACE="TEMP"

QUOTA="unlimited"/>

<SCHEMA TYPE="ATOMIC" NAME="ofsaaatm" PASSWORD="" APP_ID="OFS_AAAI" DEFAULTTABLESPACE="##OFS_AAI_TBSP_2##" TEMPTABLESPACE="TEMP" QUOTA="unlimited" INFODOM="OFSAAAIINFO"/>

</SCHEMAS>

Enable TDE and Data Redaction - Example

The following snippet shows that TDE is enabled and hence the tablespace is shown with encryption ON.

<ADV_SEC_OPTIONS>

<OPTION NAME="TDE" VALUE="FALSE"/>

<OPTION NAME="DATA_REDACT" VALUE="FALSE" />

</ADV_SEC_OPTIONS>

<TABLESPACES>

<TABLESPACE NAME="OFS_AAI_TBSP_1" VALUE="TS_USERS1" DATAFILE="/

scratch/ora12c/app/oracle/oradata/OFSPQA12CDB/ts_users1.dbf" SIZE="500M" AUTOEXTEND="ON" ENCRYPT="ON" />

<TABLESPACE NAME="OFS_AAI_TBSP_2" VALUE="TS_USERS2" DATAFILE="/

scratch/ora12c/app/oracle/oradata/OFSPQA12CDB/ts_users2.dbf" SIZE="500M" AUTOEXTEND="ON" ENCRYPT="ON" />

</TABLESPACES>

 

<SCHEMAS>

<SCHEMA TYPE="CONFIG" NAME="ofsaaconf" PASSWORD="" APP_ID="OFS_AAI" DEFAULTTABLESPACE="##OFS_AAI_TBSP_1##" TEMPTABLESPACE="TEMP"

QUOTA="unlimited"/>

<SCHEMA TYPE="ATOMIC" NAME="ofsaaatm" PASSWORD="" APP_ID="OFS_AAAI" DEFAULTTABLESPACE="##OFS_AAI_TBSP_2##" TEMPTABLESPACE="TEMP" QUOTA="unlimited" INFODOM="OFSAAAIINFO"/>

</SCHEMAS>

Execute the Schema Creator Utility

Depending on the requirement, select the appropriate Schema Creator utility execution option.

Topics:

·        Execute the Schema Creator Utility in Offline Mode

·        Execute the Schema Creator Utility in Online Mode

·        Execute the Schema Creator Utility in TCPS Mode

·        Execute the Schema Creator Utility while Installing Subsequent Applications Pack

 

NOTE

For Pack on Pack installation, see the Install OFS ALM Application Pack v8.1.0.0.0 on an Existing OFSAA Instance section.

 

After creating the Schema, proceed to Configure the OFSAAI_InstallConfig.xml File.


Execute the Schema Creator Utility in Offline Mode

In the Offline mode, the utility generates an SQL script with all the required DDLs for Users, Objects, and Grants. This script must be executed by the DBA on the appropriate database identified for OFSAA usage. If you do not have the SYSDBA privileges, you can execute the Schema Creator Utility in Offline mode and generate the script file that contains the Schemas, Objects, and Grants information. Subsequently, a SYSDBA user can execute the script file manually. To run the OFSAA Application Pack installer in Silent mode, it is mandatory to execute the Schema Creator utility with -s option.

To execute the utility in Offline mode, you must have a database user with the following GRANTS (alternatively, you can also connect as a user with SYSDBA privileges):

·        SELECT ON DBA_ROLES

·        SELECT ON DBA_USERS

·        SELECT ON DBA_DIRECTORIES

·        SELECT ON DBA_TABLESPACES

·        CREATE SESSION

 

NOTE

Explicit Grants to the user are required. Grants assigned through Roles are not supported.

 

To execute the Schema Creator utility in the offline mode, follow these steps:

1.     Log in to the system as a non-root user.

2.     Navigate to the following path: OFS_ALM_PACK/Schema_Creator/bin.

3.     Execute the osc.sh file using the following command:

./osc.sh -s -o

4.     The following message is displayed:

You have chosen OFFLINE mode. Triggering the utility in OFFLINE mode will generate the script. Do you wish to proceed? (Y/y or N/n).

5.     Enter Y to proceed.

6.     Enter the DB Username with SELECT privileges.

7.     Enter the User Password.

Figure 6: Schema Creation in Offline Mode

Description of Schema Creation in Offline Mode as follows 

8.     The console runs the initial validation checks and displays the following message:

You have chosen to install this Application Pack on <Name of the Atomic Schema> ATOMIC Schema. Do you want to proceed? (Y/N).

Figure 7: Schema Creation in Offline Mode Script Generation

Description of Schema Creation in Offline Mode Script Generation as follows

 

9.     Enter Y to start the script generation. The following message is displayed:

You have chosen to install this Application Pack on <Name of the Infodom>. Do you want to proceed? (Y/N).

Figure 8: Schema Creation in Offline Mode Successful

Description of Schema Creation in Offline Mode Successful as follows

 

On successful execution of the Schema Creator utility, the console displays the following status message:

Schema Creator executed successfully. Please execute scratch/ofsaaapp/OFS_ALAM_PACK/Schema_Creator/sysdba_output_scripts.sql before proceeding with the installation.

Additionally, if you have configured the <<APP PACK>>_SCHEMA_BIGDATA_ IN.xml file, a file called hive_output_scripts.hql is also created in the /scratch/ofsaaapp/OFS_AAAI_PACK/Schema_Creator directory.

 

NOTE

If there are any errors during the SQL script execution, reconfigure the OFS_ALM_SCHEMA_IN.xml file and repeat steps in this procedure to execute the utility. This regenerates the scripts with the correct information.

 

10.  Navigate to the OFS_AAAI/Schema_Creator directory.

11.  Log in to SQLPLUS as a user having SYSDBA Privileges.

Figure 9: Schema Creation in Offline Mode – Execute sysdba_output_scripts.sql

Description of Schema Creation in Offline Mode – Execute sysdba_output_scripts.sql as follows

12.  Execute the sysdba_output_scripts.sql file using the following command:

SQL>@sysdba_output_scripts.sql

Alternatively, you can copy the sysdba_output_scripts.sql file and SQLScripts directory to a remote server and execute the sysdba_output_scripts.sql file, after providing appropriate execute permissions.

13.  Log in to the Hue Browser with System Administrator privileges. Execute the script mentioned under hive_output_scripts.hql (omitting the slash ('/')) in the HIVE Query Editor. For example:

CREATE SCHEMA IF NOT EXIST <<HIVE SCHEMA NAME>>

 

NOTE

See the sysdba_output_scripts.log file for execution status. If there are any errors, contact My Oracle Support. If there are no errors in the execution, the log file is empty.

 

The OFS_ALM_SCHEMA_OUTPUT.XML file is successfully generated. Do not modify this file.

After creating the Schema, proceed to the Configure the OFSAAI_InstallConfig.xml File section.

Execute the Schema Creator Utility in Online Mode

In Online mode, the utility connects to the database and executes the DDLs for Users, Objects, and Grants. If you have SYSDBA privileges you can execute the Schema Creator Utility in Online mode and thereby create the Users, Objects, and Grants during the execution process. To execute the utility in the Online mode, you must connect as "<User> AS SYSDBA".

If you want to run the OFSAA Application Pack Installer in Online mode, it is mandatory to execute the Schema Creator utility with -s option.

To execute the utility with -s option in online mode, follow these steps:

1.     Edit the file OFS_ALM_PACK/Schema_Creator/conf/OFS_ALM_PACK>_SCHEMA_IN.xml in a text editor. See the Configure the OFS_ALM_SCHEMA_IN.xml File section for values to modify in the XML file.

2.     Execute the utility with -s option. For Example: ./osc.sh -s

Figure 10: Schema Creation in Online Mode

Description of Schema Creation in Online Model as follows

3.     The following message is displayed:

You have chosen ONLINE mode. Triggering the utility in ONLINE mode will execute the DDLs directly on the Database. Do you wish to proceed? (Y/y or N/n).

4.     Enter Y to proceed.

Figure 11: Schema Creation in Online Mode – DDL Execution

Description of Schema Creation in Online Mode – DDL Execution as follows

5.     The following message is displayed:

You have chosen to install this application pack on INFODOM “<INFODOM_NAME>”. Do you wish to proceed? (Y/y or N/n).

6.     Enter Y to proceed.

Figure 12: Schema Creation in Online Mode – Infodom Confirmation

Description of Schema Creation in Online Mode – Infodom Confirmation as follows

 

7.     After Schema creation is successful, proceed to the Configure the OFSAAI_InstallConfig.xml File section.

Figure 13: Schema Creation in Online Mode –Successful

Description of Schema Creation in Online Mode –Successful as follows

 

The result of this task is that the OFS_ALM_SCHEMA_OUTPUT.XML file is generated. Do not modify this file.

Execute the Schema Creator Utility in TCPS Mode

If you intend to run the OFS ALM Application Pack Installer in TCPS mode, it is mandatory to execute the Schema Creator utility with -s option and in online mode.

Prerequisite:

Configure the Oracle Wallet with trusted certificates between the DB Server with TCPS configured and the DBClient to enable communication through the SSL protocol.

 

NOTE

You can also use Oracle Wallet to support OFSAA for storing Config and Atomic Schema credentials. To add OFSAA Config and Atomic Schema credentials to Oracle Wallet, see the OFS Analytical Applications Infrastructure Administration Guide.

For example, all the database utils such as sqlplus, tnsping, and sqlldr must work between the Client and the Server.

 

To execute the utility, follow these steps:

1.     Edit the file OFS_ALM_PACK/Schema_Creator/conf/OFS_ALM_SCHEMA_IN.xml in the text editor. See the tables in Configure OFS_ALM_SCHEMA_IN.xml File for values to modify in the XML file.

2.     Execute the utility with -s option.

./osc.sh -s    TCPS  <WALLET_HOME>

For example: $    ./osc.sh -s TCPS /scratch/oraofss/wallet

Figure 14: Schema Creation in the TCPS Mode

3.     The following message is displayed:

Triggering the utility in ONLINE mode will execute the DDLS directly on the Database. Do you wish to proceed? (Y/y or N/n).

4.     Enter Y to proceed.

5.     The following message is displayed:

You have chosen to install this application pack on “<ATOMIC_SCHEMA_NAME>” ATOMIC Schema. Do you wish to proceed? (Y/y or N/n).

Figure 15: Schema Creation in the TCPS Mode–Install on Atomic Schema

6.     Enter Y to proceed.

7.     After Schema creation is successful, proceed to Configure the OFSAAI_InstallConfig.xml File.

Figure 16: Schema Creation in the TCPS Mode

The result of this task is that the OFS_ALM_SCHEMA_OUTPUT.XML file is generated. Do not modify this file.

Execute the Schema Creator Utility while Installing Subsequent Applications Pack

When executing the Schema Creator utility during the installation of a subsequent Applications Pack, you can choose to install the pack either on the same Information Domain or Atomic Schema of the existing application pack or on a new Information Domain or Atomic Schema. You can execute the Schema Creator utility either in Online or Offline mode.

To execute the Schema Creator utility while installing OFS ALM Application Pack over an existing Application Pack, follow these steps:

1.     Edit the file OFS_ALM_PACK/Schema_Creator/conf/OFS_ALM_SCHEMA_IN.xml in a text editor. See the Configure OFS_ALM_SCHEMA_IN.xml File section for values you must modify in the XML file.

2.     Execute the utility with -s option. For Example: ./osc.sh –s -o

Figure 17: Execute the Schema Creator Utility to Install Subsequent Applications Pack

Description of Execute the Schema Creator Utility to Install Subsequent Applications Pack as follows

 

After successful Schema creation, execute the sysdba_output_scripts.sql file.

Figure 18: Install Subsequent Applications Pack–Execute sysdba_output_scripts.sql

Description of Install Subsequent Applications Pack–Execute sysdba_output_scripts.sql as follows

 

 

NOTE

You must use the same config Schema user name as the previous Application Pack.

 

3.     The utility identifies the Application Packs that are already installed on the current OFSAA setup and displays the following on the console:

§       Atomic Schema of the existing Application Pack

§       Information Domain Name of the existing Pack

§       List of Installed Application Packs

Figure 19: Install Subsequent Applications Pack–Select Atomic Schema and Infodom

 Description of Install Subsequent Applications Pack–Select Atomic Schema and Infodom as follows

4.     Select the Atomic User on which you want to install the Application Pack.

Figure 20: Install Subsequent Applications Pack–Select Atomic Schema and Infodom

Description of Install Subsequent Applications Pack–Select Atomic Schema and Infodom as follows

 

On successful execution of Schema Creator utility, the console displays the following status message:

Success. Please proceed with the installation.

 

NOTE

1.     See the log file in OFS_ALM_PACK/Schema_Creator/ logs directory for the execution status.

2.     See the log file sysdba_output_scripts.log for execution status if executed in offline mode. This log will be empty if there are no errors in the execution.

3.     If there are any errors, contact My Oracle Support.

 

Configure the OFSAAI_InstallConfig.xml File

To configure the OFSAAI_InstallConfig.xml file, follow these steps:

1.     Navigate to the OFS_ALM_PACK/OFS_AAI/conf/ directory.

2.     Open the OFSAAI_InstallConfig.xml file in a text editor.

3.     Configure the OFSAAI_InstallConfig.xml file as mentioned in the following table.

You must manually set the InteractionVariable parameter values as mentioned in the table. If a value is not applicable, enter NA. Ensure that the value is not entered as NULL.

Figure 21: Sample of OFSAAI_InstallConfig.xml File

Description of Sample of OFSAAI_InstallConfig.xml File as follows

 

Table 11: OFSAA Infrastructure Installation Tasks and Descriptions

InteractionVariable Name

Significance and Expected Value

Mandatory

<Layer name="GENERAL">

InteractionGroup name=”WebServerType”

WEBAPPSERVERTYPE

Identifies the web application server on which the OFSAA Infrastructure web components are deployed.

Set the following numeric value depending on the type of web application server:

·        Apache Tomcat = 1

·        IBM WebSphere Application Server = 2

·        Oracle WebLogic Server = 3

For example, <InteractionVariable

name="WEBAPPSERVERTYPE">3</InteractionVari able>

Yes

InteractionGroup name=”OFSAA Infrastructure Server Details”

DBSERVER_IP 

Identifies the host name or IP address of the system on which the Database Engine is hosted.

NOTE: For RAC Database, the value must be NA. For example, <InteractionVariable name="DBSERVER_ IP">14.15.16.17</InteractionVariable> or

<InteractionVariable name="DBSERVER_ IP">dbhost.server.com</InteractionVariable>

Yes 

InteractionGroup name=”Database Details”

ORACLE_SID/SERVICE_NAME 

Identifies the Oracle DB Instance SID or SERVICE_NAME

NOTE: The Oracle_SID value must be exactly the same as it is mentioned in JDBC_URL.

For example, <InteractionVariable name="ORACLE_SID/SERVICE_

NAME">ofsaser</InteractionVariable>

Yes

ABS_DRIVER_PATH

Identifies the directory where the JDBC driver (ojdbc<version>.jar) exists. This is typically the $ORACLE_HOME/jdbc/lib directory.

For example, <InteractionVariable name="ABS_DRIVER_ PATH">">/oradata6/revwb7/ oracle </InteractionVariable>

NOTE: See Hardware and Software Requirements to identify the correct ojdbc<version>.jar file version to be copied.

Yes

InteractionGroup name=”OLAP Detail

OLAP_SERVER_ IMPLEMENTATION 

Identifies whether the OFSAA Infrastructure OLAP component must be configured. It depends on whether you intend to use the OLAP feature. The following numeric value must be set depending on your choice:

·        YES: 1

·        NO: 0

NOTE: If the value for OLAP_SERVER_IMPLEMENTATION is set to 1, the installer checks if the following environment variables are set in the .profile file:

·        ARBORPATH

·        HYPERION_HOME

·        ESSBASEPATH

No

InteractionGroup name=”SFTP Details”

SFTP_ENABLE 

Identifies if the SFTP (Secure File Transfer Protocol) feature is to be enabled. The following numeric value must be set depending on your choice:

·        SFTP: 1

·        FTP: 0

Yes

NOTE: The default value for SFTP_ENABLE is 1, which signifies that SFTP is used. Oracle recommends using SFTP instead of FTP because SFTP is more secure. However, you can ignore this recommendation and use FTP by setting SFTP_ENABLE to 0. You can change this selection later from the OFSAAI administration interface.

Set SFTP_ENABLE to -1 to configure ftpshare and weblocal path as a local path mounted for the OFSAAI server.

FILE_TRANSFER_PORT

Identifies the port used for the file transfer service. The default value specified is 22 (SFTP). Specify the value as 21 or any other PORT value if the value for SFTP_ENABLE is 0.

For example, <InteractionVariable name="FILE_TRANSFER_ PORT">21</InteractionVariable>

Yes

InteractionGroup name=”Locale Detail”

LOCALE 

Identifies the locale information to be used during the installation. This release of the OFSAA Infrastructure supports only US English.

For example, <InteractionVariable name="LOCALE">en_US</InteractionVariable>

Yes

InteractionGroup name=”OFSAA Infrastructure Communicating ports"

NOTE: The following ports are used internally by the various OFSAA Infrastructure services. The default values mentioned are set in the installation. If you intend to specify a different value, update the parameter value accordingly, ensure that the port value is in the range 1025 to 65535, and the respective port is enabled.

JAVAPORT 

9999

Yes

NATIVEPORT

6666

Yes

AGENTPORT

6510

Yes

ICCPORT

6507

Yes

ICCNATIVEPORT

6509

Yes

OLAPPORT

10101

Yes

MSGPORT

6501

Yes

ROUTERPORT

6500

Yes

AMPORT

6505

Yes

InteractionGroup name="Web Details"

NOTE: If the value for HTTPS_ENABLE is set to 1, ensure that you have a valid certificate available from a trusted CA and it is configured on your web application server.

HTTPS_ENABLE 

Identifies whether the UI must be accessed using HTTP or HTTPS scheme. The default value is set to 0. The numeric value must be set depending on the following options:

·        YES: 1

·        NO: 0

For example, <InteractionVariable name="HTTPS_ENABLE">0</InteractionVariable>

Yes

WEB_SERVER_IP

Identifies the HTTP Server IP or Host name or Web application server IP or Host name, to be used to access the UI. This IP is typically the HTTP Server IP.

If a separate HTTP Server is not available, then the value must be Web application server IP/Host name.

For example, <InteractionVariable name="WEB_SERVER_ IP">10.11.12.13</InteractionVariable>

or

<InteractionVariable name="WEB_SERVER_ IP">myweb.server.com</InteractionVariable>

No

WEB_SERVER_PORT

Identifies the Web Server Port, which is typically 80 for non-SSL and 443 for SSL. If a separate HTTP Server exists, the port value must be the value configured for the Web Server.

Warning: The installer will not accept the port value as:

·        80, if the HTTPS_ENABLE variable is 1

·        443, if the HTTPS_ENABLE variable is 0

For example, <InteractionVariable name="WEB_ SERVER_PORT">80</InteractionVariable>

No

CONTEXT_NAME

Identifies the web application context name which is used to build the URL to access the OFSAA application. You can identify the context name from the following URL format:

<scheme>://<host>:<port>/<context-name>/login.jsp

For example:

https://myweb:443/ofsaadev/login.jsp

For example, <InteractionVariable name="CONTEXT_ NAME">ofsaadev</InteractionVariable>

Yes

WEBAPP_CONTEXT_PATH

Identifies the absolute path of the exploded EAR file on the web application server.

·        For Tomcat, specify the Tomcat directory path till /webapps. For example, /oradata6/ revwb7/tomcat/webapps/.

·        For WebSphere, specify the WebSphere path as <WebSphere profile directory>/installedApps/<NodeCellName>. For example, /data2/test//WebSphere/AppServer/profiles/<Profile_Name>/installedApps/aiximfNode01Cell, where aix-imf is the Host name.

·        For WebLogic, specify the WebLogic home directory path. For example, /<WebLogic home directory path>/bea/wlserver_10.3

NOTE: For WebLogic, the value specified for this attribute is ignored and the value provided against the attribute WEBLOGIC_DOMAIN_HOME is considered.

Yes

WEB_LOCAL_PATH

Identifies the absolute path to any directory on the web application server that can hold temporary files, which are uploaded as part of the usage of the application.

Set this in the FTPSHARE location.

NOTE: During a clustered deployment, ensure that this path and the directory are the same on all the nodes.

Yes

InteractionGroup name="Weblogic Setup Details”

WEBLOGIC_DOMAIN_HOME 

Identifies the WebLogic Domain Home.

For example, <InteractionVariable name="WEBLOGIC_DOMAIN_HOME">/home/weblogic/bea/user_ projects/domains/mydomain</InteractionVariable>

Yes.

Specify the value only if WEBAPPSERVERTYPE is set as 3 (WebLogic)

InteractionGroup name="OFSAAI FTP Details”

OFSAAI_FTPSHARE_PATH 

Identifies the absolute path of the directory that is identified as the file system stage area.

NOTE: The directory must exist on the same system on which the OFSAA Infrastructure is being installed (can be on a separate mount).

The user mentioned in the APP_SFTP_USER_ID parameter in the following example must have RWX permission on the directory.

For example, <InteractionVariable name="APP_FTPSHARE_PATH">">/oradata6/revwb7/ftpshare</ InteractionVariable>

Yes

OFSAAI_SFTP_USER_ID

Identifies the user who has RWX permissions on the directory identified for the parameter APP_FTPSHARE_PATH.

Yes

OFSAAI_SFTP_PRIVATE_KEY

Identifies the SFTP private key for OFSAAI.

For example,

<InteractionVariable name="OFSAAI_SFTP_PRIVATE_KEY">/home/ofsaapp/.ssh/id_rsa</InteractionVariable>

By default, the value is NA, which indicates that, for authentication, you are prompted to enter the password for the user <OFSAAI_SFTP_USER_ ID>.

For more information on how to generate an SFTP Private key, see the Set Up SFTP Private Key section.

No

OFSAAI_SFTP_PASSPHRASE

Identifies the passphrase for the SFTP private key for OFSAAI.

For example,

InteractionVariable name="OFSAAI_SFTP_PASSPHRASE">enter a pass phrase here</InteractionVariable>

By default, the value is NA.

If the OFSAAI_SFTP_PRIVATE_KEY value is given and the OFSAAI_SFTP_PASSPHRASE value is NA, then the passphrase is identified as empty.

No

InteractionGroup name="Hive Details"

The default value set for the interaction variables under this group is NA.

NOTE: The following values are required only for Hive Configuration.

HIVE_SERVER_PORT 

Identifies the port used for the file transfer service. The default value is 22 (SFTP). To use this port for FTP, set this value to 21.

For example,

<InteractionVariable name="HIVE_SERVER_PORT">22</InteractionVariable>

Yes

HIVE_SERVER_FTPDRIVE

Identifies the absolute path to the directory identified as file system stage area of the HIVE server.

For example,

<InteractionVariable name="HIVE_SERVER_FTPDRIVE">/scratch/ofsaa/ftpshare</InteractionVariable>

Yes

HIVE_SERVER_FTP_USERID

Identifies the user who has RWX permissions on the directory identified under the parameter HIVE_SERVER_FTPDRIVE.

For example,

<InteractionVariable name="HIVE_SERVER_FTP_USERID">ofsaa</InteractionVariable>

Yes

HIVE_SERVER_FTP_PROTOCOL

If the HIVE_SERVER_PORT is 21, then set the value to FTP. If not, set it to SFTP.

For example,

<InteractionVariable name="HIVE_SERVER_FTP_PROTOCOL">SFTP</InteractionVariable>

Yes

HIVE_SFTP_PRIVATE_KEY

Identifies the SFTP private key for the HIVE server.

For example,

<InteractionVariable name="HIVE_SFTP_PRIVATE_ KEY">/scratch/testuser/.ssh/id_rsa</InteractionVariable>

By default, the value is NA, which indicates that, for authentication, you are prompted to enter the password for the user <HIVE_SERVER_FTP_USERID>.

For more information on generating SFTP Private key, see the Set Up SFTP Private Key section.

 

HIVE_SFTP_PASSPHRASE

Identifies the passphrase for the SFTP private key for HIVE.

For example,

<InteractionVariable name="HIVE_SFTP_ PASSPHRASE">NA</InteractionVariable>

By default, the value is NA.

If the HIVE_SFTP_PRIVATE_KEY value is NA, then the passphrase is identified as empty.

 

Set Up the SFTP Private Key

Log in to OFSAA UNIX user using the Putty tool, where you plan for installation and generate a pair of authentication keys using the ssh-keygen command. If required, set passphrase. Otherwise, the OFSAAI_SFTP_PASSPHRASE tag must be set to NA.

To generate a private key, enter the commands as shown:

ssh-keygen -t rsa

Generating public/private rsa key pair.

Enter file in which to save the key (/home/ofsaapp/.ssh/id_rsa):

Created directory '/home/ofsaapp/.ssh'.

Enter passphrase (empty for no passphrase):

Enter same passphrase again:

Your identification has been saved in /home/ofsaapp/.ssh/id_rsa.

Your public key has been saved in /home/ofsaapp/.ssh/id_rsa.pub.

The key fingerprint is:

3e:4f:05:79:3a:9f:96:7c:3b:ad:e9:58:37:bc:37:e4

ofsaapp@OFSASERVER:~> cat /home/ofsaapp/.ssh/id_rsa.pub >> /home/ofsaapp/.ssh/authorized_keys

Ensure the following permissions exist for the given directories:

·        permissions of .ssh must be 700

·        permissions of .ssh/authorized_keys must be 640

·        permission of .ssh/id_rsa must be 400

·        Permission of UNIX User created must be 755

 

Manifest.xml File

The Manifest.xml file contains details of the various datamodels used during new Installation or Upgrade scenarios.

·         If you are using only ALM application standalone, then OFS_ALM_Datamodel.xml data model slice will be processed.

·        If you are using only ALMBI application standalone, then OFS_ALMBI_Datamodel.xml data model slice will be processed.

·         If you are using integrated upload (ALM and ALMBI), then OFS_ALM_PACK_Datamodel.xml data model slide will be processed.

Figure 22: Sample Manifest.xml File

 

  Description of Sample Manifest.xml File as follows

Configure the Silent.props File

This section is applicable for a new installation of the OFS ALM Application Pack Release 8.1.0.0.0.

Silent.template

To configure the Silent.props, follow these steps:

1.     Navigate to the installer kit path OFS_ALM_PACK/ appsLibConfig/conf

2.     Rename the Silent.template file to Silent.props.

3.     Edit the Silent.props file and modify only the following parameters.

Figure 23: Sample of Silent.props File

Description of Sample of Silent.props File as follows

Table 13: Parameters for the Silent.props File (Silent.template)

Property Name

Description of Property

Permissible values

Comments

LOG_MODE

Mode for logging

1= General

0 = Debug

Optional;

Default: 0

SEGMENT_1_CODE

Segment Code

Not Applicable

Mandatory

NOTE: The Segment Code should be in upper case.

In case of upgrade, use the existing Segment Code.

OFS_ALM SEGMENT_2_CODE

Segment Code

Not Applicable

Not required. Specify as blank or ignore it.

OFS_ALMBI SEGMENT_2_CODE

Segment Code

Not Applicable

Not required. Specify as blank or ignore it.

APPFTP_LOG_PATH

Infodom Maintenance log path (to be created) for the new Infodom for applayer

Not Applicable

# Mandatory if this an App Layer Installation and if you want to create a new infodom.

# That is, you have specified INSTALL_APP=1 and INFODOM_TYPE=0

DBFTP_LOG_PATH

Infodom Maintenance log path (to be created) for the new Infodom for DBLayer

Not Applicable

# Mandatory if this an App Layer Installation and if you want to create a new infodom.

# That is, you have specified INSTALL_APP=1 and INFODOM_TYPE=0

OBI_HOST

The hostname or IP Address of the OBIEE server.

For example: 10.11.12.13 Or myweb.server.com

Mandatory If you are installing ALMBI.

Else, enter some dummy value.

OBI_PORT

The port number of the OBIEE server.

For example: 9500

Mandatory If you are installing ALMBI.

Else, enter some dummy value.

OBI_CONTEXT

Context Name of the OBIEE Server

For example: Analytics

Mandatory If you are installing ALMBI.

Else, enter some dummy value.

OBI_PROTOCOL

HTTP details of the OBIEE Server

http or https

Mandatory If you are installing ALMBI.

Else, enter some dummy value.

UPLOAD_MODEL

If you want to perform Model Upload

0 = No

1 = yes

 

MODEL_TYPE

Released data model or Customized data model

0 = released

1 = customized

 

DATAMODEL

Path  for the customized data model

Not Applicable

# Mandatory only if you want to upload the customized data model.

# That is, you have specified MODEL_TYPE=1

DM_DIRECTORY

File name for the customized data model

Not Applicable

# Mandatory only if you want to upload the customized data model.

# That is, you have specified MODEL_TYPE=1

ETL_APPSRC_TYPE

Create new ETL App or Src pair or use an existing one

0 = New

1 = Existing

# Mandatory if this an App Layer installation.

# That is, you have specified INSTALL_APP=1

# 0 = If you want to create a new ETL app or src pair

# 1 = If you want to use an existing pair

ETL_APP_1_DESC

Description for the ETL App

Not Applicable

# Mandatory if you want to create new ETL app or src pair.

#That is, you have specified ETL_APPSRC_TYPE=0

ETL_SRC_1_1_DESC

Description for the ETL Staging source description

Not Applicable

# Mandatory if you want to create new ETL app or src pair.

#That is, you have specified ETL_APPSRC_TYPE=0

ETL_SRC_1_2_DESC

Description for the ETL Processing source description

Not Applicable

# Mandatory if you want to create new ETL app or src pair.

#That is, you have specified ETL_APPSRC_TYPE=0

ETL_APP_1_NAME

ETL application name

Not Applicable

This is for App Layer installation.

ETL_SRC_1_1_NAME

ETL Staging source name

Not Applicable

This Source must be mapped to the above ETL Application.

ETL_SRC_1_2_NAME

ETL Processing source name

Not Applicable

This Source must be mapped to the above ETL Application.

 

Install the OFS ALM Application Pack

 

ATTENTION

Before you begin the installation, configure and execute the following files:

1.     Configure the OS File System Settings and Environment Settings in the .profile file

2.     Configure the OFS_ALM_PACK.xml file

3.     Configure the OFS_ALM_SCHEMA_IN.xml file

4.     Configure the OFSAAI_InstallConfig.xml file (do not configure this file if an installation of OFSAAI 8.1 already exists.)

5.     Execute the Schema Creator Utility 

6.     Configure the Manifest.xml file 

7.     Configure the Silent.props file

 

To install the OFS ALM Application Pack, follow these steps:

1.     Log in to the system as a non-root user.

2.     Identify a directory for installation and set the same in the user .profile file as follows:

FIC_HOME=<OFSAA Installation Directory>

export FIC_HOME

3.     Execute the user .profile file.

. ./.profile

4.     Navigate to the OFS_ALM_PACK/bin directory.

 

ATTENTION

Do not install the new applications in the same segment if the preinstalled applications use run management.

 

5.     Enter the following command in the console to execute the application pack installer with the Silent option.

./setup.sh SILENT

6.     The installer proceeds with Pre-installation Checks.

Figure 24: Silent Mode of Installation

Description of Silent Mode of Installation as follows

 

7.     Enter the OFSAA Processing Tier FTP/SFTP password value and proceed, when promtped in the command prompt.

Figure 25: OFSAA Processing Tier FTP/SFTP Password Prompt

 

Description of OFSAA Processing Tier FTP/SFTP Password Prompt as follows

8.     The process displays the OFSAA License. Enter Y and proceed.

Figure 26: Accept the OFSAA License Agreement

 

Description of  Accept the OFSAA License Agreement as follows 

9.     The installer installs the AAI application.

Figure 27: OFS ALM Silent Mode Installation

 

Description of OFS ALM Silent Mode Installation as follows 

 

 

10.  After AAI is installed, the OFS ALM pack installation begins.

Figure 5: OFS ALM pack Silent Mode Installation

 

Description of Silent Mode Installation Complete as follows 

 

Data Model Upload may take several hours to complete. You can check the installation logs in the following location: OFS_AAAI/OFS_AAAI/logs

11.  The following message is displayed in the console:

Installation completed…

12.  The OFSAA Infrastructure installation performs a post install health check automatically on successful installation of the product.

Congratulations! Your installation is complete.

13.  On completion of installation, see the installation log files.

To verify if the release is applied successfully, check the log files mentioned in the  Verifying the Log File Information Section.

14.  Update .profile file to define $OFSAA_LOG_HOME

Example of entry:

OFSAA_LOG_HOME=/u01/app/FTPSHARE//logs

export OFSAA_LOG_HOME

15.  Verify FTPSHARE logs directory has 775 permission

chmod -R 775 FTPSHARE

16.  Perform the steps mentioned in the Post Deployment Configurations section.

17.  For enabling Transparent Data Encryption (TDE), see the Configuring TDE, Data Redaction and the Corresponding Settings in Oracle Financial Services Data Foundation Application Pack Data Protection Implementation Guide.

18.  For enabling Data Redaction, see the Data Redaction section under the Data Security and Data Privacy chapter in the Oracle Financial Services Analytical Applications Infrastructure Administration Guide 8.0.7.0.0.

Verify the Log File Information

See the following logs files for more information:

·        Pack_Install.log file located in the OFS_ALM_PACK/logs/ directory for OFS ALM Application Pack installation logs.

·        Log file (or files) located in the OFS_ALM_PACK/OFS_AAI/logs/ directory for Infrastructure installation logs.

·        OFSAAInfrastucture_Install.log file located in the $FIC_HOME directory for Infrastructure installation logs.

After the installation OFSAAAI 8.1.0.0.0 is successful, complete the required Post-installation steps.

Install OFS OFS ALM Application Pack v8.1.0.0.0 on an Existing OFSAA Instance

You have already installed an application pack from release 8.1.x.0.0 and now you want to install another application pack from Release 8.1.0.0.0. For example, OFS PFT Pack is already installed and now you want to install OFS ALM Pack.

Execute the Schema Creator Utility Only for the OFS ALM Application Pack

To execute the Schema Creator, follow these steps:

1.     To execute the Schema Creator, follow these steps:

 

NOTE

While defining the Schema details for the applications, provide exactly the same Schema details given in the previous installation. The output file (OFS_ALM_SCHEMA_OUTPUT.xml) is generated as a result of the Schema creation process.

 

a.     Edit the file OFS_ALM_PACK/Schema_Creator/conf/OFS_ALM_SCHEMA_IN.xml in a text editor. See the Configure the OFS_ALM_PACK.xml File section for values to modify in the XML file.

b.     Execute the utility with -s option.

For example: ./osc.sh -s

2.     Follow steps given in the section If the Schema Creator Output file (OFS_ALM_SCHEMA_OUTPUT .xml) was generated. Configuring the OFSAAI_InstallConfig.xml file is not required in this scenario.

Update the OFS_ALM_PACK.xml File for the OFS ALM Application Pack

The OFS_ALM_PACK.xml file contains details of the various products that are packaged in the OFS ALM Application Pack.

This section details the various tags or parameters available in the file and the values that must be updated. Prior to installing the OFS ALM Pack in SILENT mode, it is mandatory to update this file.

To configure the OFS_ALM_PACK.xml file, follow these steps:

1.     Navigate to the OFS_ALM_PACK/conf directory.

2.     Open the OFS_ALM_PACK.xml file in a text editor.

3.     Configure the OFS_ALM_PACK.xml file as mentioned in the Configuring the OFS_ALM_PACK.xml File section.

Update the Silent.Props File of the OFS ALM Application Pack

Most parameters in the Silent.props file for 8.1.0.0.0 have default values. Before triggering the installation, ensure that you review them thoroughly and update as required.

Update the Silent.props file in the Release 8.1.x pack ONLY for the newly licensed OFS ALM application pack.

1.     Navigate to the OFS_ALM_PACK/appsLibConfig/conf directory.

2.     Open the Silent.props file and edit the parameters as mentioned in the Configuring the Silent.props File section.

Trigger the Installation

To trigger the installation, follow these steps:

1.     Enter the following command in the console to execute the application pack installer with Silent option.

./setup.sh SILENT

2.     The installer proceeds with Pre-installation Checks.

Figure 1: Silent Mode Installation

Description of Silent Mode of Installation as follows

 

3.     Enter the OFSAA Processing Tier FTP/SFTP password value and proceed, when prompted in the command prompt.

Figure 2: OFSAA Processing Tier FTP/SFTP password

 

Description of OFSAA Processing Tier FTP/SFTP Password Prompt as follows

 

4.     The process displays the OFSAA License. Enter Y and proceed.

Figure 3: OFSAA License

 

Description of  Accept the OFSAA License Agreement as follows 

5.     The OFS ALM pack installation begins.

Figure 5: OFS ALM pack Silent Mode Installation

 

Data Model Upload may take several hours to complete.

6.     Do not close the console until the installation is complete.

Figure 6: Silent Mode Installation In Progress

 

Description of OFS ALM Silent Mode Installation as follows 

 

The following message is displayed in the console:

Congratulations! Your installation is complete.

Verify the Log File Information

See the following logs files for more information:

·        The Pack_Install.log file in the OFS_ALM_PACK/logs/ directory for OFS ALM Application Pack installation logs.

·        The Log file (or files) in the OFS_ALM_PACK/OFS_AAI/logs/ directory for Infrastructure installation logs.

·        The OFSAAInfrastucture_Install.log file in the $FIC_HOME directory for Infrastructure installation logs.

Post-installation Steps

Follow the steps mentioned in the Post-installation Steps section.