This section provides detailed steps to install the OFS ALM Application Pack.
Topics:
· 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
· Configure the Silent.props file
· Install the OFS ALM Application
· Install the OFS ALM Application on Existing OFSAA Instance
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. |
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
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.
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
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. |
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:
· Configure Schema Creator Utility for RDBMS Installation
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
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.
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.
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> |
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>
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.
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.
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.
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.
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. |
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. |
|
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
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
This section is applicable for a new installation of the OFS ALM Application Pack Release 8.1.0.0.0.
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. |
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 |
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.
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.
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.
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.
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.
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.
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.
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.
Follow the steps mentioned in the Post-installation Steps section.