ILOG JRules User Guide > Running and Debugging > Getting Started > Tutorial: Debugging a Remote Rule Execution Server Application > Task 1: Deploying the Loan Validation Application

Task 1: Deploying the Loan Validation Application

PREVIOUS NEXT

In this task, you deploy the loan validation Enterprise Archive (EAR), import the loan validation rule project in Rule Studio, create a RuleApp project in Rule Studio and deploy the loan validation RuleApp to Rule Execution Server.

Step 1: Deploying the Loan Validation Application

The loan validation Enterprise Archive (EAR) files can be found in the resdebugging tutorial task1/<applicationserver> directories. How you deploy the EAR file depends on which application server you are using. Here, we describe a number of options. We suggest that you refer to your application server documentation for a more detailed description.

To deploy the EAR file if you are using JBoss installed with JRules:

  1. Start the JBoss server:
    2. On Windows, click Start > All Programs > ILOG > ILOG JRules version > Web Interfaces > Start JBoss server.
    On UNIX, use the startserver executable in the <InstallDir>/shared/bin directory.
    Wait for the JBoss Server to be started.
  2. In a command prompt type: 
cd <InstallDir>/executionserver/tutorials/resdebugging/task1/jboss40
  1. Then type: 
ant deploy
This Ant target deploys the loan validation application to the JBoss server installed with JRules.

If you are using a JBoss server not installed with JRules, you paste the file into your deployment directory.

To deploy the EAR file for a JBoss server not installed with JRules:

  1. Copy the loan-validation-JBOSS40.ear file provided in the task1/jboss40 directory.
  2. Paste the file into: <JBOSS_HOME>/server/default/deploy.

Note
You can reconstruct the EAR file by running the build.xml script in the application server directories under task1.

For example, to compile and deploy the EAR on JBoss type the following in a command prompt:

  1. cd <InstallDir>/executionserver/tutorials/resdebugging/task1/jboss40
  2. ant jboss40.ear deploy

You can also deploy the EAR on application servers other than JBoss.

To deploy the EAR file on Sun AS 82:

  1. Open the file:
    2. <SUN_AS_82_InstallDir>\Sun\AppServer82\domains\domain1\config\server.policy
  2. Add the following permission:
    3. grant codeBase "file:${com.sun.aas.instanceRoot}${/}applications${/}j2ee-apps${/}loan-validation-sunas82${/}-" {permission java.io.SerializablePermission "enableSubclassImplementation";};
  3. Start the application server.
  4. Open Application Server > Resources > Connectors > Connector Connection Pools > XUPool and make sure that Transaction Support is set to No Transaction.
  5. Select deploy a new application and choose the loan validation EAR file specific to the application server in:
    6. <InstallDir>/executionserver/tutorials/resdebugging/task1

If you want to deploy the EAR file on WebLogic, WebSphere, or Oracle 10g, the procedure is the same in each case.

To deploy the EAR file on WebLogic, WebSphere, or Oracle 10g:

  1. Start the application server.
  2. Login to the application server administration console.
  3. Select deploy a new application and choose the loan validation EAR file specific to the application server under <InstallDir>/executionserver/tutorials/resdebugging/task1.

Step 2: Importing the Loan Validation Rule Project

The loan validation rule project is imported in Rule Studio. You need to be in the Rule perspective.

To import the rule project:

  1. On the Start menu, click All Programs > ILOG > ILOG JRules version > ILOG Rule Studio for Java to open Rule Studio.
  2. Check that you are in the Rule perspective.
    3. Rule perspective is the default setting. If you are in the Rule perspective, the Rule icon is highlighted in the top-right corner of the Rule Studio window. If this is not the case, on the Window menu, click Open Perspective > Other. Then, in the Open Perspective dialog, select Rule and click OK.
  3. On the File menu, click Import.
  4. In the Import wizard, under the General category, select Existing Project into Workspace, then click Next.
  5. On the Import Projects page, click Browse next to the Select root directory field.
  6. In the Browse for Folder dialog, select the directory:
    7. <InstallDir>/executionserver/tutorials/resdebugging/task1/studioproject
    Click OK.
  7. Return to the Import Projects page and make sure the projects loanvalidation-rules and loanvalidation-xom are selected in the Projects area. Click Finish.
    8. The two projects appear in the Rule Explorer.
    images/loanvalidation.png

Step 3: Creating a RuleApp Project in Rule Studio

In this step, you create a RuleApp project in Rule Studio.

To create a RuleApp project:

  1. On the File menu, click New > Project.
  2. Select RuleApp Project in the wizard, and then click Next.
  3. Enter loanvalidation as the name of the project, and then click Next.
  4. On the Add Ruleset Archives page, on the Rule Projects tab, click Add.
  5. In the Ruleset Archives dialog, select the loanvalidation-rules rule project.
  6. Make sure the option Use all rules contained in the project is selected, then click OK.
  7. Back into the Add Ruleset Archives page, you see the rule project loanvalidation-rules is added to the list. This means that rulesets extracted from this rule project are part of the RuleApp.
  8. Click Finish.
    9. The RuleApp project is created and appears in the list of projects. The RuleApp Editor opens and displays RuleApp information.
    images/loanvalidRuleApp.png

Step 4: Deploying the Loan Validation RuleApp to Rule Execution Server

The loan validation RuleApp is deployed using the Rule Studio deploy wizard.

To deploy the RuleApp:

  1. In the RuleApp Editor, in the Deployment section, click Deploy.
    2. images/deploy_ruleapp.png
  2. On the Deploy a RuleApp page, leave the default deployment type as Increment RuleApp major version, and click Next.
  3. Under Create a temporary Rule Execution Server Configuration, enter the following information if you use the JBoss server provided with JRules:
    4. URL: http://localhost:8080/bres
    Login: bres
    Password: bres
  4. If you have deployed the Rule Execution Server Console (jrules-bres-management EAR) to a different application server, use the following URLs:
    5. - WebSphere: http://localhost:9080/bres
    - WebLogic: http://localhost:7001/bres
    - Oracle: http://localhost:8888/bres
    - Sun AS 82: http://localhost:8080/bres
    images/target_server.png
    Note
    The Create a temporary Rule Execution Server Configuration radio button is selected by default because no configuration exists.
  5. Click Finish.
    6. You should receive the following message in the Console view:
    The "loanvalidation" RuleApp project was successfully deployed on the "temporaryServer" configuration.
    images/loandeployed.png

images/arrow_next.gif Next: Task 2: Executing the Loan Validation Application

Copyright © 1987-2008 ILOG S.A. All rights reserved. Legal terms. Documentation homepage. PREVIOUS NEXT