| Oracle® Health Sciences Adverse Event Integration Pack for Oracle Health Sciences InForm and Oracle Argus Safety Installation Guide for On-Premise Deployment Release 1.0.1 E36158-02 |
|
|
PDF · Mobi · ePub |
| Oracle® Health Sciences Adverse Event Integration Pack for Oracle Health Sciences InForm and Oracle Argus Safety Installation Guide for On-Premise Deployment Release 1.0.1 E36158-02 |
|
|
PDF · Mobi · ePub |
This chapter contains the following topics:
Section 7.1, "Installing the Adverse Event: InForm and Argus Safety"
Section 7.2, "Configuring the Adverse Event: InForm and Argus Safety"
Section 7.3, "Configuring the Adverse Event: InForm and Argus Safety Using Response File"
Section 7.4, "Configuring Pre-deployment Security for InForm-Argus Safety"
Section 7.5, "Deploying the Adverse Event: InForm and Argus Safety"
To install Adverse Event: InForm and Argus Safety, perform the following:
Download Oracle® Health Sciences InForm and Oracle Argus Safety Integration Release 1.0 from the edelivery page.
Unzip aia-inform_argus-pip.zip to any location on the server.
Navigate to the inform_argus-pip > Disk1.
Execute the following commands based on your platform.
Table 7-1 Launching the Adverse Event: InForm and Argus Safety Installer
| Field | Description |
|---|---|
|
Linux x86 (64-bit) Solaris SPARC (64-bit) |
At the command line prompt, enter: ./runInstaller -invPtrLoc <soa_Home>/oraInst.loc -jreloc <location of the jre specific to your operating system. This directory should have /bin/java> |
|
Microsoft Windows (32-bit or 64-bit) |
Double-click setup.exe. |
The Welcome screen is displayed, which lists prerequisites and information about how to begin the installation process.
Click Next.
Wait for the prerequisite checks to complete and then click Next.
The following prerequisite system checks are performed:
Operating system certification
Recommended operating system packages
Kernal parameters
Recommended gilbc version
Physical memory
After the prerequisite checks are complete, click Next.
The Installation location screen is displayed.
Select AIA Home where Foundation Pack is installed.
Click Next.
The Installation Summary screen is displayed.
Review the installation summary. To save the Response file, click Save.
The Response file stores the values that you previously entered and are on the summary page.
If you want to do the install again, you can run a command and the installer performs a silent install with inputs from the Response file instead of using the wizard. The following is an example of the command. Note the -silent and -response arguments.
./runInstaller -invPtrLoc <SOA_Home>/oraInst.loc -jreLoc <Oracle Home>/Middleware/jdk160_24/jre -silent -response <Oracle Home>/11.1_Installer_response.xml
Click Install.
A warning message is displayed indicating that any customizations would be overwritten.
Click Yes to proceed with the installation.
Alternatively, if you click No, you can go back to the previous screen. For more information on how to backup AIA_HOME and preserve customizations, see Section 5.4.
Click Next.
The Installation Progress screen is displayed.
Click Next.
The Installation Complete screen is displayed.
Click Finish.
The installation is complete.
The Configuration Wizard screens will prompt you to enter the data that is required for successful configuration of the Adverse Event: InForm and Argus Safety. Keep the completed worksheet of the Configuration Wizard screens ready before you launch the configuration wizard. For more information, see Chapter 6.
To configure the Adverse Event: InForm and Argus Safety:
Navigate to <AIA_Instance>/bin and run the following command as per your platform to configure the installation environment:
On Linux: source aiaenv.sh
On Windows: aiaenv.bat
Navigate to <AIA_HOME>/bin and run the following command as per your platform:
On Linux: ./aiaconfig.sh
On Windows: aiaconfig.bat
This launches the AIA Configuration Wizard.
Click Next.
Expand Core Process Integration Packs in the navigation tree.
Select Adverse Event: InForm and Argus Safety Version 1.0.
Click Next.
To specify Pre-Built Integration Server details:
Enter information related to your server in the Pre-built Integration Server Details screen.
Click Next.
To specify Argus Safety details:
Enter information about your Oracle Argus Safety Server instance in the Argus Safety Details screen.
Click Next.
To specify InForm and InForm Adapter details:
Enter information about your InForm Server in the InForm and InForm Adapter Details screen.
Click Next.
To complete configuration:
Review the configuration information in the Configuration Summary screen.
If you want to make changes to the configuration before starting the installation, use the navigation pane on the left and select the topic you want to edit. You can also create a response file based on the input provided and use it for future silent installations and deployments.
Click Configure to accept this configuration and begin the installation.
The system displays progress of the configuration in the Configuration Progress screen.
The system displays any warnings or errors as necessary. You can review the configuration log for additional details. The configuration log location is displayed in the Configuration Progress screen.
Click Next.
When the configuration process completes without errors, the AIA Configuration Wizard displays the Configuration Complete screen.
Click Finish to close the configuration wizard.
AIAInstallProperties.xml file is updated; this file is located under <AIA_HOME>/aia_instances/<AIA_instance_name>/config folder. Use this file for deploying the integration pack on SOA server.
To configure the Adverse Event: InForm and Argus Safety using response file, perform the following:
Open the response file.
When you create a response file through Oracle Universal Installer (OUI), passwords get stored as <SECURE>.
Replace the password fields with actual passwords in the response file.
Navigate to <AIA_Instance>/bin and run the following command to configure the environment:
On Linux: source aiaenv.sh
On Windows: aiaenv.bat
Navigate to <AIA_HOME>/bin and run the following command:
On Linux: ./aiaconfig.sh <Response File Location and Name>
On Windows: aiaconfig.bat <Response File Location and Name>
The InForm-Argus Safety integration stores messages containing the patient data in a JMS Queue on the SOA server. The JMS Queue must reside in an encrypted tablespace in the SOA database.
To configure pre-deployment security for InForm-Argus Safety, perform the following:
Create or open the sqlnet.ora file from $ORACLE_HOME/network/admin.
For example:
<Oracle Home>/db11g/product/11.2.0/dbhome_1/network/admin.
For creating a wallet that is used by the TDE encryption, follow the instructions in the Oracle® Database Advanced Security Administrator's Guide 11g Release 2 (11.2).
Ensure that the following line is present in the sqlnet.ora file. If it is not present, add it at the end of the sqlnet.ora file.
ENCRYPTION_WALLET_LOCATION=(SOURCE=(METHOD=FILE)(METHOD_DATA=(DIRECTORY=<ORACLE_BASE >/admin/<ORACLE_SID >/wallet/)))
For example:
ENCRYPTION_WALLET_LOCATION=(SOURCE=(METHOD=FILE)(METHOD_DATA=(DIRECTORY=<Oracle Home>/db11g/admin/phrmdev2/wallet/)))
Save sqlnet.ora file.
Navigate to the folder <AIA_HOME>/data/AEInFormandArgus/sql/JMSEncryption.
Open CreateSecureTableSpace.sql in an editor.
Locate the string <ORACLE_HOME>/db11g/admin/<ORACLE_SID>/secure01.dbf in CreateSecureTableSpace.sql and replace it with the appropriate location on your database server. Change any parameters for the tablespace to suit your environment.
For example:
/slot/machinename/xxxx.dbf
Save CreateSecureTableSpace.sql.
Connect to the database as a user with SYSDBA role using SQL*Plus.
For example:
sqlplus <username> as sysdba
Press Enter.
Enter <password>.
Execute CreateSecureTableSpace.sql.
For example:
SQL> @ /<AIA_HOME>/data/AEInFormandArgus/sql/JMSEncryption/CreateSecureTableSpace.sql
The SQL script prompts for the wallet password. Enter the wallet password provided during wallet creation. A secure tablespace is created upon successful execution of the script.
Exit SQL*Plus.
Connect to the database as a user with <AIA_INSTANCE>_JMSUSER role using SQL*Plus.
For example:
sqlplus <username>@<db sid>
Press Enter.
Enter <password>.
Note:
The script CreateSecureTable.sql can only be run once. If you run it second time, it deletes the existing table before creating a new one.Execute CreateSecureTable.sql.
For example:
SQL> @ <AIA_HOME>/data/AEInFormandArgus/sql/JMSEncryption/CreateSecureTable.sql
A secure tablespace is created in <AIA_INSTANCE>_JMSUSER schema upon successful execution of the script.
Exit SQL*Plus.
You need to deploy the Adverse Event: InForm and Argus Safety components on the SOA server as part of the post install configurations.
To deploy the integration to SOA Server, run the following commands specific to your platform.
Navigate to <AIA_HOME/aia_instances/<AIA_instance_name>/bin and perform the following:
On Linux: source aiaenv.sh
On Windows: aiaenv.bat
Table 7-2 Deployment commands for the InForm - Argus Safety Integration
| Platform | Deployment Command |
|---|---|
|
Linux Solaris SPARC |
ant -f $AIA_HOME/Infrastructure/Install/AID/AIAInstallDriver.xml -DPropertiesFile=$AIA_HOME/aia_instances/<instance_name>/config/AIAInstallProperties.xml -DDeploymentPlan=$AIA_HOME/pips/AEInFormandArgus/DeploymentPlans/AEInFormandArgusDP.xml -DSupplementaryDeploymentPlan=$AIA_HOME/pips/AEInFormandArgus/DeploymentPlans/AEInFormandArgusSupplementaryDP.xml -l $AIA_HOME/pips/AEInFormandArgus/DeploymentPlans/AEInFormandArgus.log |
|
Microsoft Windows |
ant -f %AIA_HOME%\Infrastructure\Install\AID\AIAInstallDriver.xml -DPropertiesFile=%AIA_HOME%\aia_instances\<instance_name>\config\AIAInstallProperties.xml -DDeploymentPlan=%AIA_HOME%\pips\AEInFormandArgus\DeploymentPlans\AEInFormandArgusDP.xml -DSupplementaryDeploymentPlan=%AIA_HOME%\pips\AEInFormandArgus\DeploymentPlans\AEInFormandArgusSupplementaryDP.xml -l %AIA_HOME%\pips\AEInFormandArgus\DeploymentPlans\AEInFormandArgus.log |
AIA ships a few artifacts in AIA Lifecycle Workbench which can be used in your integrations. You can modify these native artifacts or add new natively supported artifacts using AIA Lifecycle Workbench and generate a BOM.xml file.
AIA Foundation Pack also supports the deployment of custom artifacts. These artifact types are beyond what is natively supported by Project Lifecycle Workbench and AIA Harvester. For example, you can now deploy third party technology artifacts which constitute part of integration landscape in addition to those provided by AIA.
For more information on deploying artifacts, see Oracle® Fusion Middleware Developer's Guide for Oracle Application Integration Architecture Foundation Pack 11g Release 1 (11.1.1.6.0).
|
 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. Legal Notices |
|
