Welcome to 2nd day starting guide! Today you will learn to deploy and administrate services in Petals ESB.

Installation

Downloads

1. Download a JDK 6
2. Download Apache TomCat
3. Download Petals binaries : Petals ESB, Petals Webconsole, Petals-SE-RMI  & Petals-BC-SOAP.

Install required software

1. Install the JDK, if it is not already installed. Configure the JAVA_HOME path.
2. Install Tomcat (see Tomcat documentation).

Install Petals ESB

1. Install Petals ESB: Unzip the package.
   Under windows, put the petals folder at a disk root C:/petals-platform-xxx (otherwise, you may encounter well-known issues with too long file paths).

Install the Petals Web console

1. Copy petals-webconsole-ui-xxx.war into apache-tomcat-xxx/webapps
2. Start Tomcat to deploy.

Get Petals ESB running

Start Petals ESB (command line for the first time):

1. Open a terminal (under Windows, open the Start menu, select Execute and type in cmd).
2. Go to ./petals-platform-xxx/bin/
3. Execute startup.bat -C (Windows) or startup.sh -C (Linux)

   "-C" option activates Petals ESB command line. This is for pedagogic reasons, don't use this options next time, unless you love command line.

4. Once Petals started, type: help. Try whatever command you want. But for now, nothing is deployed.

Install BC-SOAP with Autoloader:

1. Copy-Paste petals-bc-soap-xxx.zip in ./petals-platform-xxx/install/
2. Go back to Petals ESB terminal, and check from traces that the SOAP BC was successfully started.
3. Type "c". You should see BC-SOAP is deployed.

   There are several ways to install Components and Service Assemblies: Drop the zip in petals/install/_ ; The component is already started. (To uninstall, remove the .zio from petals/installed/ folder) Install from Webconsole. We will see it at next step. Install from command line. Mostly for scripts, or if you prefer command-line. Install via JMX (with the JConsole) or with ANT tasks.

Get into the Webconsole

Yesterday you generated .zip packages with Petals Studio. Let's deploy them in Petals ESB, with the Webconsole...

Start Petals Webconsole:

1. Start Tomcat (if not already started)
2. In your web browser, go to: http://localhost:8080/petals-webconsole-ui-x.x.x/ ("x" representing version digits of petals-webconsole ; Check the /webapps/ folder in Tomcat directory if you are not sure)
   Welcome to the Petals administration console! From here you will deploy, test and monitor components and services.

Install Services-Assemblies with Webconsole:

1. Click "Server: 0" , on the left.

   There is one server now, but one of the Petals unique feature is to support multiple servers all connected at the same time.

2. Go to: Administration > Service-Assemblies.
3. Install the four .ZIP Service-Assemblies your generated with Petals Studio.
4. Start all Service-Assemblies.

   There are several operation to change the state of a component : Start: Component is running. Stop: Component stops receiving messages. Shutdown: Clean-up and release all ressources used by components. Uninstall: Removes the component. Force undeploy: Stop, Shutdown and Undeploy. If one operation has an error, it is ignored and go to next step. This should be used only in case of service crash, or if you really need to fast undeploy.

Test Service-Units in Webconsole:

1. Install Petals-SE-RMI in Petals ESB. (This activates the Test panel in the Web console)
2. Go to "Test" Panel in the Webconsole.
3. Try calling some random operations. Have fun with it. (As endpoints are not implemented, this is silly, but you are a bit aren't you ?)
4. Type "q" or "stop" in Petals ESB command line, once you have finished. (Just press Ctrl+C without command line)

DONE. Bravo !
Now you know how to:

• Set-up your Petals working environment.
• Deploy components and Service-Assemblies in Petals ESB.
• Administer services in Webconsole, and send them messages via the bus.

Tomorrow you will connect a FTP server using BC-FTP, and proxify FTP operations over SOAP.