Chapter 4. Install and Set up Red Hat JBoss Developer Studio

Red Hat JBoss Developer Studio is the JBoss Integrated Development Environment (IDE) based on Eclipse. Get the latest Red Hat JBoss Developer Studio from the Red Hat Customer Portal. Red Hat JBoss Developer Studio provides plug-ins with tools and interfaces for Red Hat JBoss BRMS and Red Hat JBoss BPM Suite. These plugins are based on the community version of these products. So, the Red Hat JBoss BRMS plug-in is called the Drools plug-in and the Red Hat JBoss BPM Suite plug-in is called the jBPM plug-in.

See the Red Hat JBoss Developer Studio documentation for installation and setup instructions.

Warning

Due to an issue in the way multi-byte rule names are handled, you must ensure that the instance of Red Hat JBoss Developer Studio is started with the file encoding set to UTF-8. You can do this by editing the $JBDS_HOME/studio/jbdevstudio.ini file and adding the following property: "-Dfile.encoding=UTF-8".

4.1. Installing Red Hat JBoss Developer Studio Plug-ins

Get the latest Red Hat JBoss Developer Studio from the Red Hat Customer Portal. The Red Hat JBoss BRMS and Red Hat JBoss BPM Suite plug-ins for Red Hat JBoss Developer Studio are available using the update site.

Installing Red Hat JBoss BRMS and Red Hat JBoss BPM Suite Plug-ins in Red Hat JBoss Developer Studio

  1. Start Red Hat JBoss Developer Studio.
  2. Click HelpInstall New Software.
  3. Click Add to enter the Add Repository menu.
  4. Provide a name next to the Name field and add the following URL in the Location field: https://devstudio.jboss.com/10.0/stable/updates/integration-stack/.
  5. Click OK.
  6. Select the JBoss Business Process and Rule Development feature from the available options, click Next and then Next again.
  7. Read the license and accept it by selecting the appropriate radio button, and click Finish.
  8. Restart Red Hat JBoss Developer Studio after the installation process finishes.

4.2. Configuring Red Hat JBoss BRMS/BPM Suite Server

Red Hat JBoss Developer Studio can be configured to run the Red Hat JBoss BRMS and Red Hat JBoss BPM Suite server.

Configuring Red Hat JBoss BRMS and Red Hat JBoss BPM Suite Server

  1. Open the Drools view: click WindowOpen PerspectiveOther, select Drools and click OK.

    To open the Red Hat JBoss BPM Suite view, go to WindowOpen PerspectiveOther, select jBPM and click OK.

  2. Click WindowShow ViewOther…​ and select ServerServers to add the server view.
  3. Right click the Servers panel and select NewServer to open the server menu.
  4. Click JBoss Enterprise MiddlewareJBoss Enterprise Application Platform 6.1+ and click Next to define the server.
  5. Set the home directory by clicking Browse button. Navigate to the Red Hat JBoss EAP directory which has Red Hat JBoss BRMS installed.

    For configuring Red Hat JBoss BPM Suite server, select the Red Hat JBoss EAP directory which has Red Hat JBoss BPM Suite installed.

  6. Provide a name for the server in the Name field, ensure that the configuration file is set, and click Finish.

4.3. Importing Projects from Git Repository into Red Hat JBoss Developer Studio

You can configure Red Hat JBoss Developer Studio to connect to a central Git asset repository. The repository stores rules, models, functions, and processes.

You can either clone a remote Git repository or import a local Git repository.

Cloning Remote Git Repository

  1. Select the server from the Server tab and click the start icon to start your server.
  2. Start the Secure Shell server, if not running already, by using the following command. The command is Linux and Mac specific only. On these platforms, if sshd has already been started, this command fails. In that case, you may safely ignore this step.

    /sbin/service sshd start
  3. In Red Hat JBoss Developer Studio , select FileImport…​ and navigate to the Git folder. Open the Git folder to select Projects from Git and click Next.
  4. Select the repository source as Clone URI and click Next.
  5. Enter the details of the Git repository in the next window and click Next.
  6. Select the branch you wish to import in the following window and click Next.
  7. To define the local storage for this project, enter (or select) a non-empty directory, make any configuration changes and click Next.
  8. Import the project as a general project in the following window and click Next.
  9. Name the project and click Finish.

Importing Local Git Repository

  1. Select your server from the Server tab and click the start icon to start the server.
  2. In Red Hat JBoss Developer Studio, select FileImport…​ and navigate to the Git folder. Open the Git folder to select Projects from Git and click Next.
  3. Select the repository source as Existing local repository and click Next.
  4. Select the repository that is to be configured from the list of available repositories and click Next.
  5. In the dialog window that opens, select the Import as general project radio button from the Wizard for project import group and click Next.
  6. Name the project and click Finish.

4.4. Kie Navigator

Kie Navigator enables you to browse, change, and deploy the content of your Red Hat JBoss BPM Suite server. As a result, you can integrate Red Hat JBoss Developer Studio with Red Hat JBoss BPM Suite. For further information about Kie Navigator, see chapter Kie Navigator of the Red Hat JBoss BPM Suite Getting Started Guide.