A Service Group is a convenient way of deploying multiple services in one service archive file. There is a logical relationship between the services at runtime. The only difference in the
services.xml for a service group and a single service is its root element. For a service group, the root element is <
serviceGroup>, and we have multiple <
service> elements inside the <
The following sections describe how to manage service groups:
Accessing Service Groups
Follow the instructions below to manage the parameters of a service group.
- Click the Main tab on Management Console and then go to Manage -> Services and click List. The Deployed Services screen appears.
- Click the deployed service group(s) link to access the deployed service groups.
- In the Deployed Service Groups screen that appears, click the required service group to see the relevant Service Group Dashboard screen.
Managing the Parameters of the Service Group
1. In the "Actions" panel, select "Parameters."
2. Parameters can be defined inside the
services XML as an immediate child element of the service element. These parameters can be accessed using the message context (at the runtime) or
AxisOperation. A parameter has two attributes:
- name - The mandatory attribute which specifies the name of a parameter.
- locked - The optional attribute. The idea of a "
locked" attribute is to express whether we allow the parameter value to be overridden by a child node in the hierarchy.
For example, if a parameter was added in the
axis2.xml file setting the "
locked" attribute to "True," then if a service tries to add another parameter with the same name, it will give an exception.
The WSO2 Carbon provides an easy method to generate the Service Group parameters.
Click on the "Add New..." button to generate a new service parameter.
3. The "WSO2 Carbon" window appears. Enter the parameter's name and click "OK" to add the parameter to the list.
4. Enter the parameter's value.
5. Click on the "Update" button to save new parameters in the service group.
6. If you want to delete a parameter, click on the "Delete" button.
7. Confirm your request by clicking "Yes" in the "WSO2 Carbon" window.
Managing the Module Engagements
There may be some instances where it's impossible to run the service without engaging the WS-Security module into the service. Engaging a module is just a matter of adding a module tag into the
services XML. If the module is available, then the engaging will take place, else it will be a faulty service.
1. In the "Actions" panel, select "Modules."
2. Choose a module to add. The WSO2 Carbon provides the following modules, which you can engage into your service group:
- rampart-1.61-wso2v14 - Provides the
WS-SecureConversationfunctionalities for Axis2, based on
- relay-184.108.40.206 - Unwraps the binary messages coming from the Message Relay for Admin Services.
- rahas-1.61-wso2v14 - Is used to STS enable a service, where it adds the
RequestSecurityTokenoperation to a service that the module is engaged to.
3. Click Engage to add a module to the list.
See more information about modules in Working with Modules.
Creating the Archive File
Click "Create Service Archive" on the "Service Group Dashboard" page for your service, and it will create the service archive file. You will be prompted to save the file somewhere else in your machine.