From jbosstools-commits at lists.jboss.org Thu Jan 17 12:08:11 2008 Content-Type: multipart/mixed; boundary="===============4824286627687828299==" MIME-Version: 1.0 From: jbosstools-commits at lists.jboss.org To: jbosstools-commits at lists.jboss.org Subject: [jbosstools-commits] JBoss Tools SVN: r5774 - trunk/as/docs/reference/en/modules. Date: Thu, 17 Jan 2008 12:08:11 -0500 Message-ID: --===============4824286627687828299== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: ochikvina Date: 2008-01-17 12:08:11 -0500 (Thu, 17 Jan 2008) New Revision: 5774 Modified: trunk/as/docs/reference/en/modules/runtimes_servers.xml Log: http://jira.jboss.com/jira/browse/JBDS-199 - adding a table and rearranging= a bit some data Modified: trunk/as/docs/reference/en/modules/runtimes_servers.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/as/docs/reference/en/modules/runtimes_servers.xml 2008-01-17 17:0= 7:00 UTC (rev 5773) +++ trunk/as/docs/reference/en/modules/runtimes_servers.xml 2008-01-17 17:0= 8:11 UTC (rev 5774) @@ -26,7 +26,7 @@ with creating our runtime and server instances. =
- WTP Runtimes + Runtimes In JBoss Tools, the main purpose of Server Runtimes is to point = to a server installation somewhere on disk. In our case, this will be a JBoss installation, a= nd it can than be used for two primary purposes: @@ -55,10 +55,8 @@ - From this preference page you can see declared runtimes and th= eir types as well. In the - image shown above, there are two declared runtimes, including a JB= oss 4.2 instance. - - Here, it's possible to edit or remove existing runtimes a= s well as add a new + From this preference page you can see all declared runtimes an= d their types as well. + Figure above shows two declared runtimes that include a JBoss 4.2 = instance. Here, it's possible to edit or remove existing runtimes as w= ell as add a new one. = To create a JBoss runtime click @@ -94,10 +92,79 @@ = - All you need here is to name chosen runtime (or you can leave = offered name), browse to + The following table describe all the available options of the = wizard. + + Server Runtime Wizard Parameters + + + + + + + + Name + + + + Description + + + + + + + + Name + + + The name of a new Runtime for chosen server. We sugg= est that you + don't leave a default value. It's better to gi= ve descriptive + names that will help to distinguish one runtime from ano= ther. + + + + + + Home directory + + + The path to a directory where the runtime is install= ed. + + + + + + jRE + + + The proper Java Runtime Environment. Because of the = open-source nature of + JBoss, a user is likely to want to modify and repackage = some of the + configuration-specific jboss jars and create their own c= onfiguration. Thus, ruthe + than forcing the user to copy his entire JBoss installat= ion, the structure of the + wizard allows to create only a new configuration instead= . + + + + + + Configuration + + + The lists of configurations that is updated as soon = as you browse to a valid + runtime installation folder. After the runtime is create= d the configuration + becomes an unchanging property of that runtime. + + + + + +
+ + + = = = @@ -109,15 +176,10 @@ compile against a different configuration's jars, you will need to= create a new runtime from that configuration. = - - - - - Also, because of the open-source nature of JBoss, it is likely= that a user may want to + = As a result of having each runtime represent a specific config= uration rather than the server installation as a whole, it is very likely you'll create se= veral different runtimes @@ -125,6 +187,7 @@ your servers, are given descriptive names that help you remember w= hich is which. It will do no good to try to remember if "JBoss-runtime 5" is the 4.0 install= with ejb3? Or the 4.2 install's custom configuration you decided to create. + Press Finish to see your new runtime in the list. @@ -144,10 +207,9 @@ Creating a New Server There are many ways to get to the new server wizard. One way i= s to use the old standard File > New > Other... - wizard, and type in + and then Server - . This should show the screen below, which does not loo= k that different from the - initial screen when creating a new runtime. + . This should show the wizard like below.
Adding a JBoss Server @@ -156,18 +218,22 @@
- Because the server object is what keeps track of things like c= ommand line arguments when - starting or stopping, and runtimes keep track of the location of t= he installation, each - server instance must be backed by an appropriate runtime. - Because there may be many runtimes of each type declared, the = wizard allows you to + A server object is that keeps track of things like command lin= e arguments when starting + or stopping, and runtimes keep track of the location of the instal= lation. Thus, each server + instance must be backed by an appropriate runtime. + + The combo box below the view lets you select which runtime to = use from the list of + already declared. If there is no runtime that match your needs jus= t press + Installed Runtimes... + to bring up the familiar preference page. + Here, it becomes possible to edit already existing runtime or add = a new one with necessary + configuration. + + + =
Installed Server Runtime Environments --===============4824286627687828299==--