Chapter 4. Post-install Instructions

1. Go to http://www.jboss.org/products/.
2. Find Red Hat JBoss Developer Studio in the list.
3. Click the Download Now button. You are prompted to save the ZIP file to a directory of your choice.

1. Open a terminal and navigate to the directory containing the downloaded .jar file.
2. Run the following command to launch the GUI installation program:

   java -jar jbdevstudio-build_version.jar

   Note

   Alternatively, you may be able to double-click the .jar file to launch the installation program.
3. Click Next to start the installation process.
4. Select I accept the terms of this license agreement and click Next.
5. Adjust the installation path and click Next.

   Note

   If the installation path folder does not exist, a prompt will appear. Click Ok to create the folder.
6. Choose a JVM, or leave the default JVM selected, and click Next.
7. JBoss Developer Studio includes JBoss Enterprise Application Platform. If it was previously installed, choose No. Otherwise, choose Yes to install and configure it for use with JDBS.
8. Review the installation details, and click Next.
9. Click Next when the installation process is complete.
10. Configure the desktop shortcuts for JBoss Developer Studio, and click Next.
11. Click Done.

Procedure 4.1. Command to start JBoss Developer Studio

1. Open a terminal and navigate to the JBoss Developer Studio installation directory.
2. Run the following command to start the JBoss Developer Studio:
   For Linux:

   [localhost]$ ./jbdevstudio

   For Microsoft Windows:

   C:\JDBS_INSTALL_DIRECTORY > jbdevstudio.bat

Procedure 4.2. Define a Server Using Runtime Detection

1. Click Window→Preferences, expand JBoss Tools and select JBoss Runtime Detection.
   

   Figure 4.1. JBoss Runtime Detection Pane

2. Click Add.
3. Select the directory containing the JBoss Enterprise Application Platform 6.2 installation and click OK. The directory is now scanned to find JBoss Enterprise Application Platform 6.2 application servers.
   

   Figure 4.2. JBoss Enterprise Application Platform 6.x Found by Runtime Detection

4. Be sure the jboss-eap-6.2 check box is selected and click OK.
5. Click Apply to create a server for JBoss Enterprise Application Platform 6.2. Then click OK to close the Preferences window. The server is listed in the Servers view.
   

   Figure 4.3. JBoss Enterprise Application Platform 6.2 Server Listed in Servers View

6. The server is initially shown in stopped mode. The server starts automatically when you deploy a quickstart. To manually start the server, right-click jboss-eap-6.2 and click Start. After a short pause, the view switches to the Console view and shows the startup output of the server.

Procedure 4.3. Add the server

1. Open the Servers tab. If there is no Servers tab, add it to the panel as follows:
   1. Click Window → Show View → Other....
   2. Select Servers from the Server folder and click OK.
2. Click on the link to create a new server or right-click within the blank Server panel and select New → Server.
   

   Figure 4.4. Add a new server - No servers available

3. Expand JBoss Enterprise Middleware and choose JBoss Enterprise Application Platform 6.1+. In the same dialog, click on the Add... link to define the new server runtime environment and click Next.
   

   Figure 4.5. Define a New Server

4. Click Browse and navigate to your JBoss EAP install location. Then click Next.
   

   Figure 4.6. Add New Server Runtime Environment

5. Review the new JBoss EAP Server definition and click Next to continue.
   

   Figure 4.7. Review the New Server Definition

6. On this screen you define the server behavior. You can start the server manually or let JBoss Developer Studio manage it for you. You can also define a remote server for deployment and determine if you want to expose the management port for that server, for example, if you need connect to it using JMX. In this example, we assume the server is local and you want JBoss Developer Studio to manage your server so you do not need to check anything. Click Next.
   

   Figure 4.8. Define the New JBoss Server Behavior

7. This screen allows you to configure existing projects for the new server. Because you do not have any projects at this point, click Finish.
   

   Figure 4.9. Modify resources for the new JBoss server