Deploying the EAR file

After you have added custom groups, you deploy the Decision Center EAR file.

Before you begin

To deploy the EAR file, you work in the WebSphere Integrated Solutions Console. Log in to the console as explained in Before you start: Opening the administration console.

About this task

After you have added your custom groups to the deployment descriptors in the Decision Center EAR, you deploy the EAR file on WebSphere Application Server to be able to map security roles to users and groups.

Important:

When you deploy the Decision Center EAR file, the process sets the persistence locale. After you have saved a rule to the database, you are no longer allowed to change the persistence locale. If you want to install Decision Center in a language other than English, take note of the instructions in Set the persistence locale.

If you redeploy the Decision Center EAR file, the redeployment has the following consequences:
  • The class loading sequence is lost. See Changing the class loading sequence. WebSphere Application Server reverts to the default parent first setting.
  • All users, such as rtsUser1 and rtsAdmin, lose their role, even though they belong to the correct group. When you sign in to the Decision Center console, a message is displayed, such as rtsUser1 does not have the correct role.

Procedure

To deploy the EAR file:

  1. In the side panel of the console, click Applications > New Application and then New Enterprise Application.
  2. Click Browse and navigate to the Decision Center EAR file for your version of WebSphere Application Server.
    • <ODM_InstallDir>/teamserver/applicationservers/WebSphere8/jrules-teamserver-WAS8.ear
    • <ODM_InstallDir>/teamserver/applicationservers/WebSphere85/jrules-teamserver-WAS85.ear
  3. Click Next.
  4. Select Detailed - Show all installation options and parameters.
  5. Expand Choose to generate default bindings and mappings and select the Generate Default Bindings check box, then click Next.
  6. If a security warning is displayed, click Continue.
  7. On the Install New Application page, in Step 1, click Next to accept the default settings.
  8. In Step 2, select the target server and the WAR files and click Next. Keep the default setting if you have only one server.
  9. For Step 3 to Step 8, click Next to accept the default settings.
  10. In Step 9, map security roles to users and groups.

    The application server uses the roles that are defined in the deployment descriptors. You must map these roles to the groups found in the security settings.

    1. Select a check box next to a role in the table and click Map groups.
    2. Click Search in the middle of the page to display the groups.
    3. Map the group to the role that you are editing by moving that role to the Selected column.
    4. Click OK and repeat 10.a to 10.d for all the roles.
    5. In addition, if you want to follow the Decision Center permissions tutorial in your own installation, create two custom groups: Validator and Eligibility.

    After you have completed the assignments, they are shown as in the following table. If you have groups or users, you can map them to the existing role instead.

    Table 1. Mapping user groups to roles
    Role Mapped groups
    rtsUser rtsUser
    rtsAdministrator rtsAdministrator
    rtsConfigManager rtsConfigManager
    rtsInstaller rtsInstaller
    Validator Validator
    Eligibility Eligibility
  11. If your application server is WebSphere Application Server V8.0, V8.5, or 8.5.5, click Next for Step 10 and Step 11 to accept the default settings.

    Step 12 displays a summary.

    Note: If WebSphere eXtreme Scale is also installed, more settings are displayed as Step 12 in the side panel of the WebSphere Integrated Solutions Console. For more information on administering WebSphere eXtreme Scale with WebSphere Application Server, see Administering in the WebSphere eXtreme Scale information center.
  12. Click Finish.
  13. Click Save to save your workspace changes to the master configuration.
Parent topic: Step 4: Deploying the Decision Center EAR file