Thursday 1 September 2016

Step by Step Installation and Configuration of WebLogic Server 12C

Installation

  • Download the latest version of file from here. Accept the user license and select generic installer for latest Oracle weblogic server.
  • Extract the installation jar from downloaded zip.
  • Open a command window with administrator privilege. Navigate to the folder where the Jar is located.
  • Run the following command.
    java -jar .jar
  • Follow the on-screen instructions to install the weblogic server.

Domain Creation

  • Navigate to <WebLogic_installation_directory>\Middleware\Oracle_Home\oracle_common\common\bin
  • Run ‘config.cmd’. It would execute a wizard for domain creation.
  • Select ‘Create a new domain’ -> browse to the base folder where you want your domain to be created -> Next.
  • Create domain using product template -> Basic Weblogic Server Domain -> Next.
  • Create an administrator account for the domain -> Next.
  • Select domain mode -> Select JDK -> Next.
  • In advanced configuration, check the ‘Administration Server’ box. For clustering and load balancing, ‘Topology’ configuration is also needed. These can be set up later from admin console.
  • Enter Server name, listen address and port for Admin Server. This server provide the console for managing the domain -> Next.
  • Review the setup configuration -> Create.

Starting Admin Server

  • Navigate to the folder where the domain has been installed in previous step.
  • Run the file ‘startWebLogic.cmd’ from the folder.
  • When started, cmd will display ‘<Server state changed to RUNNING.>’.
  • Open browser and navigate to URL. http://<serverAddress>:<serverport>/console. With default setting, the URL should be http://localhost:7001/console.
  • With default setting, the admin console will be deployed on first access. Wait for few seconds for deployment to finish.
  • Login to the console with username and password created while domain creation.
  • The console screen can be used for all server configuration.

Deploying Web Application

  • In the web console, from the left hand sidebar, select deployments.
  • Click on install. It will open up the explorer in the console itself. Navigate to the war file, select it and click next.
  • Select ‘Install this deployment as an application’ as installation scope -> Next.
  • Give a name for this deployment. Keep the other setting as it is -> Next.
  • If you have multiple server or cluster, you will be taken to server selection screen for deployment.
  • Select finish. The application can be deployed to the server. The web application can be accessed through url http://<serverAddress>:<serverPort>/<ApplicationContextRoot>

Changing the Context Root of Web Application

Create a file name ‘weblogic.xml’ in WEB-INF folder of the web application. Add following to change the context root.

Step By Step Guide For Creating Drools Rules in Kie Workbench And Integrating It In External Java Application

Kie Workbench Side

Creating an organization, repository and project

    • Login to Kie workbench with an ‘admin’ account.
    • Create a new organization:
      • Authoring -> Administration -> Organizational Units -> Manage organizational Units -> Add
      • Give a name and group id to the organization.
    • Create a new repository in the organization.
      • Authoring -> Administration -> Repositories -> New Repositories.
      • Give a name and select the organization
    • Create a new project.
      • Authoring -> Project Authoring -> New Item -> New Project
      • Add a Project name and description.
      • Add Group ID (default value is organization id), Artifact id (default value is project name) and initial version number.

Creating a Rule

    • Select the Organization, Repository and Project in the Project explorer.
    • New Item -> Guided Rule
    • Enter a name for the rule and select the package.
    • Create the rule.

Adding external POJO model to the rules

The POJO model class that is needed by the workbench project need to be exported as a maven jar and uploaded to the workbench.

Uploading the POJO model class jar

  • Authoring -> Artifact Repository -> Upload -> Browse to the Jar and upload
  • If Jar does not contain a pom.xml file, you will be asked to manually enter a group and artifact id.

Adding model to the Project

  • Navigate to the project -> Open Project Editor
  • In project editor, from the dropdown, select Dependencies.
  • Add from repository -> Select the model class jar file.

Adding and using model class in Rules.

  • Open guided rule editor -> Navigate to the ‘Data Object’ tab.
  • New item -> Choose a type.
  • The type can be then used in rule editor.

Java Side

Accessing Workbench rule from external Java Application

  • Setup drool runtime. Add following dependencies to the application pom.xml
  • Add a new Repository to your maven. This is done by adding following line to settings.xml file residing in MAVEN_HOME folder. If there is no xml file, create one. Url tag must contain the link to the maven repository of kie workbench. The id of the repository must be ‘guvnor-m2-repo’.
  • Add the authentication details for the above repository in settings.xml file.
  • Java code to access the repositories and run the rules. In the release id, we need to pass the Group ID, Artifact ID and version number of the workbench project.

KieScanner and Repository Updation

KieServices tend to download the remote repository only once in a day and store it in local repository. We can however use the KieScanner and force the container to scan for any update in the remote repository. A scan will only update the local repository if we are using ‘LATEST’ as the version number and a new version of the repository is available in remote directory or the remote repository is in development stage (denoted by ‘-SNAPSHOT’ appended to the version number).

Wednesday 31 August 2016

Installing KIE workbench in Apache Tomcat 7 in Windows

KIE Drools Workbench

KIE workbench is the workflow engine where complex business process can be develop and executed. It also provide interface to create guided and DRL rules. The workbench can be linked through a Java application to use the created rule in our application.

Installing KIE workbench in Apache Tomcat 7 in Windows

  • Download the Kie workbench from http://download.jboss.org/drools/release/6.4.0.Final/kie-drools-wb-distribution-wars-X.X.X.Final-tomcat7.war. The X.X.X is version of the workbench. It must correspond to the version of Drools engine used.
  • The war file downloaded need to be deployed in the web-app folder of Apache tomcat.
  • Download and copy following jar files into TOMCAT_HOME/lib
    • btm-2.1.4.jar
    • btm-tomcat55-lifecycle-2.1.4.jar
    • h2-1.3.161.jar
    • jta-1.1.jar
    • slf4j-api-1.7.2.jar
    • slf4j-jdk14-1.7.2.jar
    • kie-tomcat-integration
    • JACC (javax.security.jacc:artifactId=javax.security.jacc-api in JBoss Maven Repository)
  • Create configuration files inside TOMCAT_HOME/conf
    • btm-config.properties
    • resources.properties
      The Path in above file need to be change to the actual system path.

  • Create setenv.sh (or setenv.bat) file inside TOMCAT_HOME/bin and add following:
  • Add valve configuration into TOMCAT_HOME/conf/server.xml inside Host element as last valve definition:
  • Edit TOMCAT_HOME/conf/tomcat-users.xml to include roles and users, make sure there will be 'analyst' or 'admin' roles defined as it's required to be authorized to use kie-wb
  • Start tomcat and open url http://127.0.0.1:8080/kie-drools-wb- distribution-wars-X.X.X.Final-tomcat7
  • Installing Drools in Eclipse and Creating Simple Hello World Application in Drools

    Drools

      • Drools is a Business rule management system
      • It is used to separate the data from logic.
      • It allow us to write logic (rules) in more layman readable form. This allow business people to create their own rules instead of depending on programmers and developers.

    Rules

    Rules are pieces of knowledge often expressed as, "When some conditions occur, then do some tasks."
    The most important part of a Rule is it’s when part. If the when part is satisfied, the then part is triggered

    Installing Drools in Eclipse

    Drools comes with plugin for eclipse to create and manage the project from eclipse itself.

    Prerequisites to install Drools Plugin:

    • Java 1.5 (or higher)
    • Eclipse 4.2

    Installation Step

    Drools Runtime

    Drool runtime is needed to create and execute drool rules.
    • Click on Windows -> Preference -> Drools -> Installed Drools Runtime -> Add -> Browse.
    • Browse to the downloaded binaries folder and Add.

    Example Project

    1. File -> New -> Drool Project -> Create an empty project.
    2. Enter project name -> finish.
    3. The project follow maven folder structure. Two primary folder are
      1. src/main/java – Java code would go here.
      2. src/main/resources – Drool files would go here.
    4. Create a new java class file in src/main/java. Say ‘Hello.java’ in package ‘com.example’.
    5. Create a new drool file in src/main/resources/rules. Say ‘ReplaceHello.drl’.
    6. Result.
    Apart from creating the rules file in resources folder, we can import the rules files from classpath as well as file system. Below example show an example of reading the rule file from classpath.