From jbosstools-commits at lists.jboss.org Tue Jul 3 12:21:42 2012 Content-Type: multipart/mixed; boundary="===============2132151017606102019==" MIME-Version: 1.0 From: jbosstools-commits at lists.jboss.org To: jbosstools-commits at lists.jboss.org Subject: [jbosstools-commits] JBoss Tools SVN: r42349 - in trunk/documentation/guides/Beginners_Guide/en-US: images and 1 other directory. Date: Tue, 03 Jul 2012 12:21:41 -0400 Message-ID: <201207031621.q63GLf5M010976@svn01.web.mwc.hst.phx2.redhat.com> --===============2132151017606102019== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: irooskov(a)redhat.com Date: 2012-07-03 12:21:41 -0400 (Tue, 03 Jul 2012) New Revision: 42349 Modified: trunk/documentation/guides/Beginners_Guide/en-US/Book_Info.xml trunk/documentation/guides/Beginners_Guide/en-US/The_interface.xml trunk/documentation/guides/Beginners_Guide/en-US/images/Eclipse_welcome_= screen.png trunk/documentation/guides/Beginners_Guide/en-US/images/JBoss_AS_Overvie= w.png trunk/documentation/guides/Beginners_Guide/en-US/images/JBoss_AS_localho= st.png trunk/documentation/guides/Beginners_Guide/en-US/images/Server_Started.p= ng trunk/documentation/guides/Beginners_Guide/en-US/images/Start_Stop_Serve= r.png Log: updated for TOOLSDOC-135 Modified: trunk/documentation/guides/Beginners_Guide/en-US/Book_Info.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- trunk/documentation/guides/Beginners_Guide/en-US/Book_Info.xml 2012-07-= 03 16:20:37 UTC (rev 42348) +++ trunk/documentation/guides/Beginners_Guide/en-US/Book_Info.xml 2012-07-= 03 16:21:41 UTC (rev 42349) @@ -11,9 +11,9 @@ = 5.0 = - 5.0.0 + 5.0.1 = - 2 + 3 = Modified: trunk/documentation/guides/Beginners_Guide/en-US/The_interface.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- trunk/documentation/guides/Beginners_Guide/en-US/The_interface.xml 2012= -07-03 16:20:37 UTC (rev 42348) +++ trunk/documentation/guides/Beginners_Guide/en-US/The_interface.xml 2012= -07-03 16:21:41 UTC (rev 42349) @@ -6,18 +6,18 @@ This chapter discusses the interface to the JBoss Developer= Studio IDE.
- Eclipse + JBoss Developer Studio - Eclipse provides a container for all development work performed with JBoss Developer Studio. It provides control over t= he application server, the applications on it and provides an interface thr= ough which you can develop your own applications. + Providing a container for all development work performed with JBoss Developer Studio allows for control over the applic= ation server, the applications on it and the interface through which you ca= n develop your own applications. - Eclipse is started by double-clicking on the jbdevstudio executable in your installation directory. + Start JBoss Developer Studio by double-clicking on the jbdevs= tudio executable 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 relating to your Eclipse pr= ojects be stored. If you wish to change your workspace location after this = step you can do so by selecting File= Switch WorkspaceOther.... + Following this you will be asked to specify a workspace. A workspace is= the location on your computer where your project files will be stored. If = you wish to change your workspace location after this step you can do so by= selecting FileSwitch W= orkspaceOther....
- Eclipse Workspace launcher + Workspace launcher @@ -25,17 +25,17 @@
- After selecting the location of the workspace, you will be greeted with= the Welcome screen. This screen provides a few pathwa= y options, including the Getting Started link, which w= ill take you to a page that provides some JBDS documentation, an option to = create a new project with the Create New... option and= an option to skip straight to your Workbench. + After selecting the location of the workspace, you will be greeted with= the Welcome screen and a button that will take you to= JBoss Central and your workbench.
- Eclipse welcome screen + Welcome screen
- +
JBoss Central - When starting the JBoss Developer Studio you will see JBoss C= entral in the workspace. From JBoss Central= you can quickly Create Projects, run Projec= t Examples, view Documentation, read the la= test News and Blogs, and change <= guilabel>JBoss Central + When starting JBoss Developer Studio you will see JBoss Centr= al in the workspace. From JBoss Central you= can quickly Create Projects, run Project Ex= amples, view Documentation, read the latest= News and Blogs, and change JBoss Central Settings.
@@ -83,14 +83,95 @@
- JBoss Application Server + Setting up a JBoss server - The JBoss Application Server Server provides the full range of Java EE = 5 features as well as extended enterprise services including clustering, ca= ching, and persistence. + The JBoss Enterprise Application Server provides the full range of Java= EE 5 features as well as extended enterprise services including clustering= , caching, and persistence. +
+ Adding a new application server for use with the JBoss Developer= Studio + + To add a new server runtime follow these steps: + + + + + From your workbench, click on + Window + Preferences + Server + Runtime Environments + . + + + + + Click on the Add... button. + + + + + Select the runtime environment type of your application server from t= he list provided. + + + + + Tick the box for the Create a new local server o= ption. + + + + + Click on the Next > button. + + + + + Provide a name for your server runtime and then click on the Browse... button, next to the Home Directory location space. + + + + + Navigate to the directory where the server you wish to add is install= ed and click on the OK button. + + + + + Select the Java Runtime Environment (JRE) you wish to use for this se= rver from the drop-down menu. If the required JRE is not listed, click on t= he JRE button beside the list, click the = Add... button in the Installed JREs + Preferences dialog box, and follow the prompts t= o install the correct JRE. + + + + + The Configuration section should automatically l= ist the 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 = Browse... button, navigate to the profile location and click th= e OK button. + + + + + If all the information is correct click the Finish button. + + + If you need to change any information click the < Back<= /guibutton> button until you reach the screen with the information that nee= ds to be altered and then navigate back to the JBoss RunTime screen and click the Finish button. + + + + + Once the new sever has been added, you can select it for use by clickin= g on its name in the Server Runtime Environment list a= nd then clicking the OK button, which will then take= you back to the main interface. + + + To start your new server, select it from those available in the Servers view and click the button displaying a white arrow in a= green circle. + + + + If the Servers view is not displayed at the bottom= of your Workbench, you can activate it through Wi= ndowShow ViewOtherServerJBoss Server View<= /guimenuitem> and then click the OK but= ton. + + +
- Using the Application Server shipped with the JBoss Developer St= udio + Using the JBoss application server with the JBoss Developer Stud= io - This section discusses the use of the JBoss Application Server through= Eclipse. Once you have started the Eclipse interface for the = JBoss Developer Studio, the JBoss Application Server can be s= tarted by selecting it in the Servers view, which can be found in the lower= part of the window, and then clicking the green arrow to the right. + The JBoss Application Server can be started by selecting it in the Ser= vers view, which can be found in the lower part of the window, and then cli= cking the green arrow to the right.
Starting and stopping the server @@ -100,11 +181,6 @@
- - - If the Servers view is not displayed at the bottom= of your Workbench, you can activate it through Wi= ndowShow ViewOtherServerServers and then clicking the OK button. - - After the server has been successfully started the status field next t= o the server name will change from Stopped to Started, Synchronized. @@ -117,7 +193,7 @@ - Once Eclipse and the server are started, double click on the server na= me in Eclipse to see an Overview screen in the center. + Once the server has started, double click on the server name to see an= Overview screen.
JBoss Application Server overview @@ -128,24 +204,30 @@
- The Overview section contains six subsections: General Information, Login Credentials, Publishing, Timeouts, Server Polling and Server Ports. + The Overview section contains the subsections: General Information, Management Login Credenti= als, Server Behaviour, Publishing= , Timeouts, Application Reload Be= havior, Server State Detectors and Server Ports. The General Information subsection allows you to = change the value for the Server name and Hos= t name. By clicking on the Runtime Environment label a dialog box will be shown with options to change the name of the= server runtime, the home directory, the Java Runtime and the server config= uration that will be used when running the application server. The Open launch configuration button displays a dialog box that = allows you to configure the technical details of the application server ins= tance. - Below the General Information subsection is the <= guilabel>Login Credentials subsection. Here you can set the User Name and Password that will be u= sed to provide secure access to your server. + Below the General Information subsection is the <= guilabel>Management Login Credentials subsection. Here you can s= et the User Name and Password tha= t will be used to provide secure access to your server. + The last subsection on the left is dedicated to Server Behav= iour. This section allows you to specify how JBoss Developer Stu= dio should interact with the server and whether it is local or remote. + + The Publishing subsection at the top right of the= Overview section allows you to specify when applicati= ons will be published to the location specified (whether the applications w= ill be made available through the application server depends on the server = running and if it is configured to recognize dynamic changes). You can sele= ct 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 i= nterval. The Timeouts subsection below the Publi= shing subsections allows you to set the start and stop times (in= seconds) in which the server should complete all of its operations. This s= etting is made available in order to decrease the chance of the server free= zing or hanging. - Below the Timeouts subsection is the Se= rver Polling subsection. A server poller gathers information abo= ut the server at certain points in time, capturing information about proces= ses and applications. This section allows you to select between either the = JMX Poller or Timeout Poller for star= tup and the Process Terminated Poller or Timeou= t Poller for shutdown. + The Application Reload Behavior subsection allows= you to specify how and when applications associated with the server, are r= eloaded. + Below the Application Reload Behavior subsection = is the Server State Detectors subsection. A server pol= ler gathers information about the server at certain points in time, capturi= ng information about processes and applications. This section allows you to= select the pollers to be used during server startup and shutdown. + + The final subsection is called Server Ports, belo= w the Server Polling subsection. This section allows y= ou to alter the port numbers that the server pollers gather their informati= on from. The two settings JNDI Port and Web = Port are set to be automatically detected by default; normally t= here should be no reason to manually select the port numbers. @@ -165,90 +247,9 @@ - Refer to the Mana= ge JBoss AS from JBoss Developer Studio chapter of the Getting Started with JBoss Developer Studio gui= de for further details. + Refer to the JBoss Server Manager guide for further details. -
- = -
- Adding a new application server for use with the JBoss Developer= Studio - - Though the JBoss Developer Studio may come with a preconfigured applic= ation 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 WindowPreferencesServerRuntime Environments. - - - - - Click on the Add... button. - - - - - Select the runtime environment type of your application server from = the list provided. - - - - - Tick the box for the Create a new local server = option. - - - - - Click on the Next > button. - - - - - Provide a name for your server runtime and then click on the Browse... button, next to the Home Directory location space. - - - - - Navigate to the directory where the server you wish to add is instal= led and click on the OK button. - - - - - Select the Java Runtime Environment (JRE) you wish to use for this s= erver from the drop-down menu. If the required JRE is not listed, click on = the JRE button beside the list, click the Add... button in the Installed JREs - Preferences dialog box, and follow the prompts = to install the correct JRE. - - - - - The Configuration section should automatically = list the profiles available for your server. Select the server configuratio= n 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 Browse... button, navigate to the profile location and click t= he OK button. - - - - - If all the information is correct click the Finish button. - - - If you need to change any information click the < Back= button until you reach the screen with the information that ne= eds to be altered and then navigate back to the JBoss RunTime screen and click the Finish button. - - - - - Once the new sever has been added, you can select it for use by clicki= ng on its name in the Server Runtime Environment list = and then clicking the OK button, which will then tak= e you back to the main Eclipse interface. - - - To start your new server, select it from those available in the Servers view and click the button displaying a white arrow in = a green circle. - - - - If the Servers view is not displayed at the bottom= of your Workbench, you can activate it through Wi= ndowShow ViewOtherServerJBoss Server View<= /guimenuitem> and then click the OK but= ton. - - -
- = +
= = Modified: trunk/documentation/guides/Beginners_Guide/en-US/images/Eclipse_w= elcome_screen.png =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D (Binary files differ) Modified: trunk/documentation/guides/Beginners_Guide/en-US/images/JBoss_AS_= Overview.png =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D (Binary files differ) Modified: trunk/documentation/guides/Beginners_Guide/en-US/images/JBoss_AS_= localhost.png =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D (Binary files differ) Modified: trunk/documentation/guides/Beginners_Guide/en-US/images/Server_St= arted.png =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D (Binary files differ) Modified: trunk/documentation/guides/Beginners_Guide/en-US/images/Start_Sto= p_Server.png =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D (Binary files differ) --===============2132151017606102019==--