Red Hat Training
A Red Hat training course is available for JBoss Enterprise SOA Platform
Chapter 5. Running the JBoss Enterprise SOA Platform in a Production Environment
5.1. Server Profiles
Table 5.1. Server Profiles
Profile | Description |
---|---|
default | Use this profile for development and testing. This profile uses less memory than the production profile but clustering is not enabled in this mode. In addition, this profile provides more verbose logging than the "all" and "production" profiles. This verbose logging provides you with additional information, but adversely affects server performance. Unless you explicitly specify a different profile, this profile is used when the server is started. |
production | Use this profile on production servers. This profile provides clustering and maximizes performance by using more memory and providing less verbose logging and screen console output than the "all" or "default" profiles. Note that output (such as the message from the "Hello World" quick start) does not appear on the console screen in this mode. It is written to the log only. |
minimal | Enables the minimum features needed for a functioning system. No archives are deployed. No ESB or SOA features are enabled. The BPEL Engine is not available. |
standard | This provides standard functionality for testing. No web, ESB, or SOA features are enabled. The BPEL Engine is not available. |
web | The jbossweb.sar archives are deployed when this profile is run. No ESB, or SOA features are enabled. The BPEL Engine is not available. |
all | All of the pre-packaged ESB archives are deployed when this profile is run. This profile offers less performance and scalability than the "production" profile, but requires less memory to run. |
5.2. run.sh Optional Switches
Table 5.2. ./run.sh Optional Switches
Switch | Purpose | Example of Use |
---|---|---|
-c | Make the server use a specific profile. If none is specified, "default" is used. | ./run.sh -c production |
-b | Bind the server to a specific IP address. If none is specified, the default (127.0.0.1) is used. | ./run.sh -b 10.34.5.2 |
5.3. Start the JBoss Enterprise SOA Platform in a Production Environment
Procedure 5.1. Start the JBoss Enterprise SOA Platform in a Production Environment
Navigate to the bin Directory
Open a terminal and input this command:cd SOA_ROOT/jboss-as/bin
(orchdir SOA_Root\jboss-as\bin
in Microsoft Windows).Note
It is required that you have set up an administration username and password before proceeding.Launch the JBoss Enterprise SOA Server on Red Hat Enterprise Linux
To start the product, run this command:./run.sh -c production
Launch the JBoss Enterprise SOA Server on Microsoft Windows
To start the product, run this command:run.bat -c production
Result
The server starts. Note that this may up to around two minutes, depending on the speed of your hardware.
Note
To verify that there have been no errors, check the server log:
less SOA_ROOT/jboss-as/server/PROFILE/log/server.log
. As another check, open a web browser and go to http://localhost:8080. Make sure you can log into the admin console with the username and password you have set.
5.4. Server Installation
A server installation is a way of configuring the JBoss Enterprise SOA Platform on your system. When the software is installed in this way, it can be launched and shutdown with the host operating system. It is set up just like any other service (or daemon in Linux/Unix terminology) on your operating system.
5.5. Configure the JBoss Enterprise SOA Platform to Run as a Red Hat Enterprise Linux Daemon
Procedure 5.2. Task
- To make the JBoss Enterprise SOA Platform run as a background daemon (service), you will have to create your own shell script. Red Hat does not supply any scripts to do this.
5.6. Start a Server Installation
Prerequisites
- The JBoss Enterprise SOA Platform must be pre-configured to run as a service.
Note
This example assumes the service was installed using the name jboss_soa
Procedure 5.3. Task
- To start the JBoss Enterprise SOA Platform as a service, issue this command:
service jboss_soa start
Note
If the JBoss user was created as a system account (using the-R
switch) then a warning message is displayed. You can safely ignore this.
5.7. Stop a Server Installation
This example assumes the service was installed using the name jboss_soa
Procedure 5.4. Task
- To stop the JBoss Enterprise SOA Platform when it is running as a service, issue this command:
service jboss_soa stop