Custom Service Definition
Workload Manager users have the flexibility to define their own service on supported OOB Base OS Images. For instance, a user creates a Tomcat or Oracle WebLogic service on a specific hardened base OS image such as RHEL, CentOS, or Oracle Enterprise Linux. Accordingly, this user can define the scripts for different actions on each service such as starting, stopping, restarting the service and so forth.
The service types that the following screenshot shows are available when you
The following table describes the service types.
|Virtual Machine with a Management Agent (default)|
About 90% of the Workload Manager services use this type. In this case, it is nothing more than an application VM being launched with a service tied to it using a apt-get command based on the bundle script specification to install this service, and then run the required actions.
If configured, the Pre VM Start script is the first script to be executed before the VM is launched.
|Virtual Machine without a Management Agent|
Use this service type to launch VMs in agent-less mode.
While you cannot specify Agent(because of the lack of a Management Agent), you can still specify actions before the actual service is started.
If there is no IP address before the actual service is started, the post/pre-init scripts inject the IP addresses and other configured information for each phase.
|External Service |
Use this service type to configure an external service that is not launching a VM.
External service costs are not be included in the cloud costs as it is considered a component of management costs. This cost is visible in the Account Details > Usage Details page.
External Initialization section in External Service
|Use this service type to configure container services.||Lifecycle Hooks section in|
Base OS Image Versions
The out-of-boxare not tied to a specific version. Workload Manager provides an Ubuntu base OS service that maps to the supported versions for this service. You will find similar configurations for all other OS services.
One of the supported versions is specified as the default for each base OS image and users can change to any other supported version. See OOB Base OS Images for a list of supported versions for each base OS image.
Prerequisites to Define Custom Services
Verify these prerequisites before you define a custom service:
Guidelines to Define Custom Services
Define a custom service by following these simple guidelines:
Define a skeleton service definition. The scripts can be in any language or format. Ensure to adhere to the Service Administration > .
Workload Manager merely executes the command specified in the field for each phase of the Service Lifecycle Actions.
Read and understand the Service-Tier Scripts Defined in App Models explained in Deployment Lifecycle Scripts.
Upload the logo image before creating a service.
Process to Define a Custom Service
To add a custom service, (admins) follow this procedure:
Log into the Workload Manager UI as an Admin.
Access the Services tab: Admin > Services.
Click Add Service to add a new service.
In the Add New Service page, enter the details of the new service.
Add a Service Logo for this image. Click Choose File to upload the this file to the local file system:
Logo file names for ahave a size limitation of 140 characters. If the file name is longer than this limit, then the Unison synchronization process fails recursively and other image files, including logo images, cannot be synchronized.
Provide the Name for this service.
Provide a Service ID.ID that uses only alphanumeric characters and/or underscore. If you are using scripts and created a .zip file, then use the same name as the .zip file. See for additional details. For example, tomcatCentOS7 is the name used in that example when creating the service lifecycle action script.
Add an optional description for this service.
Select one relevant Category.
After you define the service, this service will be displayed in thetab.
The available categories are listed in the Category dropdown list.
For example, if you add a Tomcat service, select Web Server, if you are adding a SQL database server, select Database and so forth. If you find that your new service straddles two services or does not fit into any other category, add it to the Custom Service group.
Select one Default Image from the selected supported images for this service (VM-based services only).
Assign a Default inbound firewall rule(s) that should be used by VMs running this service, if required (VM-based services only).
Select if the protocol should be TCP or UDP.
Add a firewall rule for each default port as applicable. For example, Port 8080 is the default port for Tomcat service.
Assign the ingress and egress port information.
Assign the Service Cost to allow enterprises to optionally charge a hourly cost for the service.
When modeling applications, you will not be charged when you include a charged service in your topology.
You are charged at the hourly service rate only if you deploy an application that has a chargeable service.
This cost adds up to the other costs incurred when deploying an application.
Allows admins the flexibility to charge individual users or sub-tenants for any service that is built and added to the Marketplace or Catalog. See Cost and Fees for additional context.
Provide the applicable Lifecycle Action(s) using scripts or command to execute the service on different actions.
Lifecycle actions can be one of the following:
Scripts: This is the most common option as scripts can be in any language or format. Seefor additional details.
Commands: Workload Manager executes the command(s) specified in this field for the phase of the lifecycle
URLs: Downloadable by a get request
Services can be present in a repository that is already modeled in Workload Manager (Repositories) or hosted on any other server (Other input). If the bundle is hosted on any other server, then provide the URL of the script.
In cases where you need to run external actions, define this section – Add the External Lifecycle Actions to manage the external service lifecycle.
Script Properties The specified script is executed... Pre-init Script Before the service is launched Post-init Script After the service is launched Pre-start Script Before the service is started Post-start Script After the service is started Pre-stop Script Before the service is terminated Post-stop Script After the service is terminated
The External Actions Bundle file contains the scripts for external service lifecycle management.
You must provide the following information for this zip file depending on the resource being configured:
If you are configuring this file at the cloud region level – this file must contain a directory called cloudregion which contains all the scripts.
If you are configuring this file for a service – name this file as ServiceID.zip. For example, tomcat6.zip, where tomcat6 is the Service ID.
Add any additional parameters required by the service scripts to the Service Parameters section.
If you define any user-editable parameters in this section, those parameters are displayed in the General Settings section of the Properties pane in the Topology builder.
Click Save to save this new service.
Now that the service is defined, it will appear on the Topology Modeler's Services pane. Once created, you can share the service across your sub-tenants. By default, the service is available to all users within the tenant. Users can access the service from the Topology Modeler when modeling applications.
Using a Custom Service
To use the newly-defined service users can drag it into the Topology Modeler as explained in.
The new service is visible the Topology Modeler's Services Palette in the selected Category along with the specified Base Image. For example, if you created Tomcat for CentOS 7.x as the new Web Server service you will see the following service configuration.
If you created additional parameter(s) specific to this service, you will see it as part of the General Settings in the Application Tier Properties pane. You can enter an optional war file from a repository you have configured within Workload Manager.
Firewall rules configured as part of this service are automatically set when you configure this service.
- No labels