Petals Getting started - day 2 - Petals ESB and its Web console

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

Any question, any problem? Find the solution on the WSDL and Administration discussion.

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 JAVA_HOME environment variable (Get help for Windows or for Linux)
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 directory ./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. Nothing is deployed yet.

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-platform-xxx/install/ ; The component is already started. (To uninstall, remove the .zip file from ./petals-platform-xxx/installed/ ) 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 just one server for now. One of Petals unique feature is to support multiple servers all connected at the same time.

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

   Those operation change components state : 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 with Webconsole:

1. Install Petals-SE-RMI in Petals ESB.
2. Click Manage connections on the top of Webconsole page.
3. Click on your server (should be localhost)
4. Check petals-se-rmi component enabled and click Submit.
5. Click Refresh Domain on the left panel, to take endpoints into account.
6. Go to Test Panel in the Webconsole. You have an interface with:
   • Endpoint: The endpoint to reach in Petals ESB.
   • Interface: The interface name implemented by the service of the endpoint
   • Service: The service exposed by the endpoint
   • Operation: The list of accessible operation for the given service
   • Content: Message content. A sample message is generated automatically when a WSDL is provided.
   • MEP: Different message exchange patterns. InOnly and InOut are the most common as they are the MEP supported in WSDL 1.1.
   • Timeout: Timeout of the invocation, as the Web console use synchronous invocations.
   • Send a DONE: Acknowledgment to send back for a potential response, to match according to the MEP in use.
7. You can try to send a test message. You will get a timeout error since services are abstract, without implementation. Be patient, we will use real services tomorrow.
8. Type "q" or "stop" in Petals ESB command line, once you have finished, to stop it. (Or 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.