Red Hat Training
A Red Hat training course is available for Red Hat Process Automation Manager
Integrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager
Red Hat Customer Content Services
brms-docs@redhat.com
Abstract
Preface
As a developer, you can integrate Red Hat JBoss Developer Studio with Red Hat Process Automation Manager to write complex applications and leverage code auto-completion.
Chapter 1. Installing Red Hat JBoss Developer Studio
Red Hat JBoss Developer Studio is the JBoss integrated development environment (IDE) based on Eclipse. It integrates tooling and runtime components by combining Eclipse, Eclipse Tooling, and Red Hat JBoss Enterprise Application Platform. Red Hat JBoss Developer Studio provides plug-ins with tools and interfaces for Red Hat Process Automation Manager.
Procedure
Download Red Hat JBoss Developer Studio:
- Log in to the Red Hat Customer Portal.
- Click DOWNLOADS at the top of the page.
- On the Product Downloads page that opens, navigate to the JBOSS DEVELOPMENT AND MANAGEMENT section, and click Red Hat JBoss Developer Studio.
-
On the Software Downloads page, download Red Hat JBoss Developer Studio 11.3.0 Stand-alone Installer (
devstudio-11.3.0.GA-installer-standalone.jar
).
In a terminal window, navigate to the directory where you downloaded the installer JAR file and enter the following command:
java -jar devstudio-11.3.0.GA-installer-standalone.jar
- Follow the instructions in the installer to complete the installation.
For more information, see the Red Hat JBoss Developer Studio Installation Guide.
Because of 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/devstudio.ini
file and adding the following property: "-Dfile.encoding=UTF-8"
.
Chapter 2. Installing Red Hat JBoss Developer Studio plug-ins
The Red Hat JBoss Developer Studio plug-ins for Red Hat Process Automation Manager are based on the community version of the plug-ins. For this reason, the Red Hat Process Automation Manager plug-in is called the Drools plug-in.
Procedure
Download the Red Hat Process Automation Manager plug-ins for Red Hat JBoss Developer Studio:
- Log in to the Red Hat Customer Portal.
- Click DOWNLOADS at the top of the page.
- On the Product Downloads page that opens, navigate to the JBOSS DEVELOPMENT AND MANAGEMENT section, and click Red Hat JBoss Developer Studio.
-
On the Software Downloads page, download Red Hat JBoss Developer Studio Integration Stack 11.3.0 Update Site Zip (
devstudio-integration-stack-11.3.0.GA-updatesite.zip
).
- Start Red Hat JBoss Developer Studio by selecting Red Hat JBoss Developer Studio from the Start menu.
- Click Help → Install New Software.
- Click Add to display the Add Repository box.
-
Enter a name in the Name field, for example,
devstudio-11.3.0.GA
. -
Click Archive, select the
devstudio-11.3.0.GA-updatesite-core.zip
file, and click OK. - In the Install window, select JBoss Business Process and Rule Development from the list, click Next, and then click Next again.
- Read the license agreement, accept it, and click Finish.
- Restart Red Hat JBoss Developer Studio after the installation process finishes.
Chapter 3. Configuring the Red Hat Process Automation Manager server
You can configure Red Hat JBoss Developer Studio to run the Red Hat Process Automation Manager server.
Prerequisites
- Red Hat JBoss Developer Studio is installed with the Red Hat Process Automation Manager plug-ins.
- Red Hat Process Automation Manager is installed in a Red Hat JBoss EAP 7.1 server instance.
Procedure
- Start Red Hat JBoss Developer Studio.
- Click Window → Show View → Other and select Server → Servers to add the server view.
- Right-click the Servers panel and select New → Server to open the server menu.
- Click Red Hat JBoss Middleware → JBoss Enterprise Application Platform 7.1 and click Next to define the server.
- Click Next on the Create a new Server Adapter page.
- To set the home directory on the JBoss Runtime page, click the Browse button and navigate to the Red Hat JBoss EAP directory where Red Hat Process Automation Manager is installed.
- Enter a name for the server in the Name field, ensure that the configuration file is set, and click Finish.
Chapter 4. Importing projects from a 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.
4.1. Cloning a remote Git repository
You can clone a git repository to use with Red Hat JBoss Developer Studio.
Prerequisites
- Red Hat JBoss Developer Studio is installed with the Red Hat Process Automation Manager plug-ins.
- You have access permission for the remote Git repository that you want to clone.
Procedure
- In Red Hat JBoss Developer Studio, select the server from the Server tab and click the start icon to start the server.
Enter the following command in a terminal to start the secure shell server, if it is not running already.
/sbin/service sshd start
NoteThis command is specific to Linux and Apple Macintosh. On these platforms, if
sshd
has already been started, this command fails. If this happens, you may safely ignore this step.- In Red Hat JBoss Developer Studio , select File → Import… and navigate to the Git folder.
- Open the Git folder, select Projects from Git, and click Next.
- Select the repository source as Clone URI and click Next.
- Enter the details of the Git repository and click Next.
- Select the branch you want to import and click Next.
- To define the local storage for this project, enter or select a non-empty directory, make any configuration changes, and click Next.
- Import the project as a general project in the following window and click Next.
- Name the project and click Finish.
4.2. Importing a local Git repository
You can import a local git repository to use with Red Hat JBoss Developer Studio.
Prerequisite
Red Hat JBoss Developer Studio is installed.
Procedure
- In Red Hat JBoss Developer Studio, select the server from the Server tab and click the start icon to start the server.
- Select File → Import and navigate to the Git folder. Open the Git folder to select Projects from Git and click Next.
- Select the repository source as Existing local repository and click Next.
- Select the repository that is to be configured from the list of available repositories and click Next.
- In the window that opens, select Import as general project and click Next.
- Name the project and click Finish.
Chapter 5. Next Steps
Appendix A. Versioning information
Documentation last updated on: Monday, October 1, 2018.