7 Post-installation configuration

This chapter includes the following topics:

Setting the passwords of the system and admin users (installation only)
Configuring the Empirica Signal software
Verifying the Empirica Signal setup

Setting the passwords of the system and admin users (installation only)

The system account is used internally by the Empirica Signal software. You cannot use the system account to log in to the Empirica Signal software.

The admin account is a superuser account and is not an SSO user account. You use the admin account to log in initially so you can create other users and configure the Empirica Signal software. You must set the password for the product installation to be complete.

Perform these steps as the non-privileged user.

Open a command shell, and navigate to the following directory:

<INSTALL_DIR>/bin/PasswordReset
Verify that the environment variable definitions in the runPasswordReset.sh file point to the appropriate locations for your system.

For example, open runPasswordReset.sh with a text editor and inspect the following lines. The values that appear are examples.
```
# System locations 
JAVA_HOME=/u01/app/oracle/product/jdk1.7.x_xx
WEBLOGIC_MODULES_DIR=/u01/app/oracle/Middleware/oracle_common/modules
JPS_CONFIG_FILE=/u01/app/oracle/Middleware/user_
projects/domains/empirica/config/fmwconfig/jps-config-jse.xml
# Product installation staging locations
INSTALL_ROOT=/u01/stage/Signal_Install
PRODUCT_BASE_DIR=$INSTALL_ROOT/Signal
```
Multiple directories named modules might be located under the Oracle installation home. Make sure that the WEBLOGIC_MODULES_DIR entry refers to the directory located below the oracle_common directory.

The JPS_CONFIG_FILE entry refers to the location of the OPSS configuration file, which by default is located in the config/fmwconfig sub-directory of the home directory of the WLS domain.
Set the password for the system user name:
1. In the command shell, execute the following command:
  
  $ ./runPasswordReset.sh system override-passwordmustchange
  
  Logging information appears, followed by a prompt to enter a new password.
2. Type the password for the system user name, and press Enter.
  
  By default, the password must contain at least eight characters, including an upper-case character, lower-case character, acceptable symbol, and number.
  
  A prompt to confirm the password appears.
3. Retype the password, and press Enter.
  
  The passwords must match. They are not echoed.
  
  If the passwords match and the password change is successful, a confirmation message appears.
  
  If the passwords do not match, an error message appears. Run the command again and use matching passwords.
Set the password for the admin user name:
1. In the command shell, execute the following command:
  
  $ ./runPasswordReset.sh admin
  
  Logging information appears, followed by a prompt to enter a new password.
2. Type the password for the admin user name, and press Enter.
  
  If you have not changed the default password requirements, the password must contain at least eight characters, including an upper-case character, lower-case character, acceptable symbol, and number, unless the product is already running. If the product is already running, the password must meet the requirements established by the Empirica Signal administrator for passwords.
  
  A prompt to confirm the password appears.
3. Retype the password, and press Enter.
  
  The passwords must match. They are not echoed.
  
  If the passwords match and the password change is successful, a confirmation message appears.
  
  If the passwords do not match, an error message appears. Run the command again and use matching passwords.
  
  Note:
  Remember this password for later use. You use the password to log in using the admin user name when you set up and configure the application.

Configuring the Empirica Signal software

Before users can begin using the Empirica Signal software, you must complete the following tasks. For information about how to perform each task, see the Empirica Signal and Topics User Guide.

To test that the site is set up correctly, open the Microsoft Internet Explorer browser, and enter the following URL:

https://<server name>:7004/Signal

Notes:
- If your site is not configured to require SSL connections, use the following values:
  - http://instead of https://.
  - 7003 instead of 7004.
- If you are using SSO, use the native login port provided to you by the administrator who configured OAM for your application. The native login port is listed as an entry in the Information to collect before you begin.
If the login page appears, the site is set up correctly.
Log in using the built-in administrative account:
- User name: admin
- Password: The password set during Setting the passwords of the system and admin users (installation only).
When prompted, change your password.

You are logged out of the software.
Log in using the built-in administrative account and the new password you just created.

The home page appears.
Verify site options:
1. Click Settings, and click Set Site Options.
  
  The Site Options page appears.
2. Verify the SMTP server name.
3. Specify e-mail addresses for Feedback Email and Error Email.
  
  The default email address is for the Empirica Signal support team (esignalcontact_ww_grp@oracle.com). Alternatively, you can send e-mail messages to an internal technical support team.
  
  Note:
  If you are upgrading, an email address appears in the field. You can modify it as needed. If you are installing, the field is blank.
4. Make sure that all other site options are set correctly.
Click Exit.

You are logged out.
If you configured access using single-sign on (SSO), test SSO login:
1. Log in to the Empirica Signal software as admin, and create a user that is enabled for SSO. The same user name must also be configured for OAM.
2. Open the Microsoft Internet Explorer browser, and type the URL using the SSO port, which is listed as an entry in Information to collect before you begin.
  
  The login prompt appears.
3. Type the SSO user name and password.
  
  The home page appears.
4. Click Exit.
  
  You are logged out.
  
  The Empirica Signal installation is complete.

Installing report data (installation only)

To use the standard reports provided with the Empirica Signal application, you must install a small data stub in the Oracle database.

This section describes how to install the necessary configuration, AERS (1q03: S). Do not perform this procedure if you already installed a copy of the AERS68_TO_1Q03 data set on the server that hosts the Empirica Signal software.

The installation package for the Empirica Signal software includes the Data_Stub.zip file, which contains the following files:

An Oracle DMP file.
Two SQL scripts.
A shell script (.sh).
An IMP file.

Perform these steps on the application server using the non-privileged user account.

Unzip the archive file:
1. On the server, create a directory named data_stub. For example:
  
  /u01/stage/data_stub
2. Using a tool such as unzip, unpack the Data_Stub.zip file into the data_stub directory.
3. Make sure the data_stub directory contains all the files from the Data_Stub.zip file.
Create the tablespaces and accounts used to store the production data:
1. Open the /u01/stage/data_stub/create_prod.sql file in a text editor.
2. To create the data file in a location other than the default location of your database, specify the alternate location in the DATAFILE_PATH variable.
3. In a command shell, use the following command to navigate to the /u01/stage/data_stub directory:
  
  $ cd /u01/stage/data_stub
4. Type the following command on one line to execute the script:
  
  $ sqlplus system@<TNS_name> @create_prod
5. When prompted, type the Oracle system account password.
6. When prompted, type a password for the AERS68_TO_1Q03 account.
7. When prompted, confirm the password.
  
  Note:
  Remember this password for later in this procedure.
8. Type the following command to exit:
  
  SQL> exit
  
  The create_prod.sql script creates a tablespace for the data consisting of one 40 MB data file.
To load the data into the Oracle database:
1. Edit the load_prod.imp file, supplying your Oracle instance at the end of the userid line. For example:
  
  userid=AERS68_TO_1Q03@orcl
2. Execute the following command to give execute permissions to load_prod.sh:
  
  $ chmod u+x load_prod.sh
3. Execute the load_prod.sh file using the following command:
  
  $ ./load_prod.sh
4. Type the password for the AERS68_TO_1Q03 account. You created the password in step 2f.
To import the supplied standard AERS (1Q03: S) configuration into the Empirica Signal application:
1. Log in to the Empirica Signal application using the admin username.
2. Click Settings, and click Manage Configurations.
3. Click Import Configurations.
4. Type the following account name:
  
  AERS68_TO_1Q03
5. Click OK.
6. Verify that the AERS (1q03: S) standard configuration is listed on the Manage Configurations page.
7. On the Manage Configurations page, click the row menu ( ), and click Edit.
8. On the Modify Configuration page, click Validate Now.
9. Click Continue.
  
  Note:
  For more information on working with configurations, see the Empirica Signal and Topics User Guide.
Optionally, delete the data_stub directory and its contents. These files are no longer needed.

Importing the Sample Topic Workflow Configuration (optional; installation only)

This section describes how to import the Sample Topic Workflow Configuration for use in the Empirica Signal application.

These steps are required only if you performed the steps in Setting up the Sample Topic Workflow Oracle account (optional; install only). However, Oracle recommends that you perform these steps so that you will have a sample configuration to copy and use as a template for new configurations. Do not edit the sample configuration.

Log in to the Empirica Signal application using the admin username.
Click Settings, and click Manage Topic Workflow Configurations.
Click Import Workflow Configuration Account.

A dialog box appears, asking you to confirm the restoration. This message appears even if no topic workflow configurations were deleted.
Click OK.
Type the following account name:

TOPIC_WORKFLOW
Click Import.
Verify that the Sample Topic Workflow Configuration is listed on the Manage Topic Workflow Configurations page.

For information about working with topic workflow configurations, see the Empirica Signal and Topics User Guide.

Verifying the Empirica Signal setup

To verify a new installation, see the following documents:

IQ_Test.doc for installation qualification information.
OQ_Test.doc for operational qualification information.

To verify an upgrade, see the following documents:

OQ_Test.doc for operational qualification information.
UQ_Test.doc for upgrade qualification information.