7 Post-installation configuration

This chapter includes the following topics:

Setting the passwords of the system and admin users (installation only)
Configuring the Empirica Healthcare Analysis software

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

The system account is used internally by the Empirica Healthcare Analysis software. You cannot use the system account to log in to the Empirica Healthcare Analysis 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 Healthcare Analysis 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=/usr/java/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/Healthcare_Install
PRODUCT_BASE_DIR=$INSTALL_ROOT/Healthcare
```
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.
  
  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.
  
  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 Healthcare Analysis software

Before users can begin using the Empirica Healthcare Analysis software, you must complete the following tasks. For information about how to perform each task, see the Empirica Healthcare Analysis 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/Healthcare

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. If R version 3.0.1 is installed on your system and you specified the r_path property in Reviewing the listener.properties file, select Show Evaluative Analysis tab to enable the evaluative analysis feature.
  
  If R version 3.0.1 is not installed on your system, make sure that Show Evaluative Analysis tab is not selected so that the evaluative analysis feature is disabled.
4. Make sure that all other site options are set correctly. If you change any site options, save the changes.
Click Exit.

You are logged out.
If you configured access using single-sign on (SSO), test SSO login:
1. Log in to the Empirica Healthcare Analysis 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 Healthcare Analysis installation is complete.