Contents

Title and Copyright Information

Preface

• Audience
• Documentation accessibility
• Related documents
• Finding prerequisite software for Oracle Health Sciences applications
• Conventions

1 Empirica Signal Overview

• Introduction to the Empirica Signal software
• Assumptions
• Physical configuration options
• Components of the installation package

2 Planning your installation

• How to use this document
• Prerequisites for upgrading from 7.3.3.x to 8.0.1
• Migrating the database when upgrading from 7.3.3.x to 8.0.1
• Preparing the environment for the Empirica Signal installation
• Information to collect before you begin

3 Preparing the database and application servers

• Required privileges for the database server
• Required privileges for the application server
• Requirements and assumptions for the Linux accounts
  • Assumptions about environment variables and Linux user accounts
  • Setting the default file creation umask
• Preparing the installation staging area
  • Unpacking the installation files into the installation directory
• Configuring the connection to the Oracle database
  • Adding the database TNSNAMES entry
  • Setting environment variables
• Setting up the application database account (install only)
• Setting up the Sample Topic Workflow Oracle account (optional; install only)
• Installing test data (optional; install only)
• Applying upgrade scripts to migrated schemas to upgrade from 7.3.3.x to 8.0.1
• Preparing the environment on the application server
  • Installing unlimited strength encryption Java libraries
  • Installing and configuring Xvfb
    • Determining whether Xvfb is installed
    • Installing Xvfb
    • Configuring Xvfb
  • Modifying the default WebLogic Configuration
• Starting WebLogic and the Node Manager

4 Setting up the Empirica Signal software

• Configuring properties files
  • Reviewing the webvdme.properties file
  • Reviewing the listener.properties file
  • Setting up the report_listener.properties file
  • Creating the webvdme-fonts.properties file
  • Setting up the log4j.properties file
  • Reviewing the ldap.properties file
• Preserving customizations and copying Release Notes documents (upgrading from 7.3.3.x to 8.0.1)
• Making documentation available within the application

5 Configuring database and Topics credentials

• Creating the Topics service user (optional)
• Storing database and Topics credentials
• Setting up permissions for the credential store

6 Deploying the Empirica Signal application

• Creating the Empirica Signal deployment in WebLogic
• Setting up the Web Service Security Policy

7 Post-installation configuration

• Setting the passwords of the system and admin users (installation only)
• Configuring the Empirica Signal software
  • Installing report data (installation only)
  • Importing the Sample Topic Workflow Configuration (optional; installation only)
• Verifying the Empirica Signal setup

8 Upgrading the Signal application software from 8.0 to 8.0.1

• Components of the installation package
• Unpacking the installation files into the installation directory
• Stop Signal
• Applying upgrade scripts to schema
• Setting up the property files
• Preserving the Plan.xml file
• Preserving custom home pages, release notes, and images from the 8.0 installation
  • Making the Release Notes available within the application
• Deploying the Signal application
• Restarting the SignalServer managed server
• Verifying the Empirica Signal setup

9 Migrating the Signal Management software from 7.3.3.x to 8.0.1

• About migrating the Signal Management software

A Single sign-on (SSO) - Oracle Access Manager (OAM) setup

B Getting the application server ready for the Empirica Signal application

• Installing WebLogic
• Installing Oracle ADF Runtime
• Installing RCU and creating repositories
• Setting up the WebLogic domain
  • Creating and configuring the WebLogic domain
  • Creating the nodemanager.properties file
  • Starting WebLogic and the Node Manager
  • Creating a data source for credential access
  • Associating the credential store with the data source
  • Restarting the SignalServer managed server
• Configuring SSL
• Troubleshooting
  • Issue: An error occurs when you try to log in because the application cannot connect to the database.
  • Issue: An error occurs when you select Save to Topic, and the weberror.log contains an error message about a missing security heading.
  • Issue: The password for the OPSS database account changes.
  • Issue: The password for the MDS account changes.