Create new JBoss Tools Documentation Jira issue
This will launch the Jboss Tools Jira page - to complete your feedback please login if needed, and submit the Jira.
JBoss.orgCommunity Documentation
The interfaces that the JBoss Developer Studio IDE is built for are discussed.
Eclipse is the container for all development work in the JBoss Developer Studio. It allows for control over the running of the application server, the applications on it and provides an interface for developing your own applications.
Eclipse is started by double-clicking on the eclipse executeable in your installation directory.
Following this you will be asked to specify a workspace. A workspace is the location on your computer where your files will be stored relating to the multiple sessions. If you wish to change your workspace location after this step you can do so by following the menu items , , .
After selecting a workspace location, you will be greeted with the Welcome screen. This screen provides a few pathway options, including a Getting Started link to a selection of documentation, an option to create a new project with the Create New... option and an option to skip straight to your Workbench.
Skipping straight to your workbench, you will see a screen with a few sections and the JBoss Application Server listed in the bottom area of the interface.
In the bottom left hand corner of the screen is a picture of a white column with a blue bar and a yellow plus sign beside it. Clicking on this button will open a menu of different views and windows.
The window that may be of most use to you can be found by following: → → . This window opens an interface to the tools included with the JBoss Developer Studio.
Refer to the Welcome to JBoss Developer Studio section of the Getting Started with JBoss Developer Studio guide for further details.
The JBoss Application Server provides the full range of Java EE 5 features as well as extended enterprise services including clustering, caching, and persistence.
This section discusses the JBoss Application Server with regards to its use through Eclipse. Once you have started the Eclipse interface for the JBoss Developer Studio, the JBoss Application Server can be started by clicking on its name in the lower part of the window and then clicking the green arrow to the right.
If the view is not displayed at the bottom of your Workbench, you can activate it through → → → → and then click the button.
After the server has been successfully started the status next to the server name will change from displaying Stopped to displaying Started, Synchronized.
Once Eclipse and the server are started, double click on the server name in Eclipse to see an Overview screen in the center.
From this Overview section there are six subsections consisting of: General Information, Login Credentials, Publishing, Timeouts, Server Polling and Server Ports.
The General Information subsection allows you to change the Server name and Host name to your own preferences. By clicking on the Runtime Environment label a dialog box with options to change the name of the server runtime, the home directory, the Java Runtime and which server configuration should be used when running the application server. The button displays a dialog box for configuring the technical details of the application server instance.
Below the General Information subsection is the Login Credentials subsection. Set the User Name and Password for secure access to your server.
The Publishing subsection at the top right of the Overview section allows you to set when applications will be published to the location specified (whether the applications will be made available through the application server depends on the server running and if it is configured to recognise dynamic changes). You can select to either never have an application be published automatically or for a check of new applications yet to be published to occur at a certain timed interval.
The Timeouts subsection below Publishing allows you to set the start and stop time (in seconds) for the server to complete all of its operations. This setting is made available in order to decrease the chance of the server freezing or hanging.
Below the Timeouts subsection is the Server Polling subsection. A server poller gathers information about the server at certain points in time, capturing information about processes and applications. This section allows you to select between either the JMX Poller or Timeout Poller for startup and the Process Terminated Poller or Timeout Poller for shutdown.
The final subsection is Server Ports, below Server Polling. This section allows you to alter the port numbers that the server pollers gather their information from. The two settings of JNDI Port and Web Port are set to be automatically detected by default; normally there should be no reason to manually select the port numbers.
Changing the Server Ports subsection configuration will not alter which ports the server itself listens on.
Default access to the server can be achieved by typing the address http://localhost:8080 into your Internet browser address bar.
Refer to the Manage JBoss AS from JBoss Developer Studio chapter of the Getting Started with JBoss Developer Studio guide for further details.
Though the JBoss Developer Studio may come with a pre-configured application server, you can still add your own servers. This section details how to add additional servers for use with the JBoss Developer Studio.
To add a new server runtime follow these steps:
In the Eclipse interface click on → → →
Click on the button
Select the type of runtime environment your application server is from the list provided
Tick the box for Create a new local server
Click on the button
Name your server runtime and then click on the button next to the Home Directory location space
Navigate to the directory where the server you wish to add is installed and click on the button
Select the Java Runtime Environment (JRE) you wish to use for this server from the drop-down menu. If the required JRE is not listed, click on the button beside the list and then select the button in the Preferences dialog box and follow the prompts to install the correct JRE
The Configuration section should automatically list the available profiles available for your server. Select the server configuration you wish to use by clicking on its name in the list
If the profile you wish to use is not listed click on the button, navigate to the profile location and click the button
Click the button to display the Runtime Information for the server you are about to add. If all the information is correct click the button.
If you need to change any information click the button until you reach the screen with the information that needs to be altered and then navigate back to the Runtime Information screen and click the button.
Once the new sever has been added, you can select it for use by clicking on its name in the Server Runtime Environment list and then clicking the button that will then take you back to the main Eclipse interface.
To start your new server, select it from those available through the view and click the white arrow in a green circle.
If the view is not displayed at the bottom of your Workbench, you can activate it through → → → → and then click the button.
