You can define a process automation workflow for Network Configuration Management that can be used to create new rules, compliances, or policies. See Network Configuration Management page for details.

This tutorial walks you through creating a simple remediation process for network configuration management. You can then use this process in Configuration Management > Network Configuration for Remediation Workflow to create a new rule, compliance, or policy.

The following image shows the simple network configuration process definition you will create in this tutorial. Task and event names are for illustration purpose only, you can modify them to suit your specific requirements.


A network configuration process allows you to do the following types of tasks:

TaskDescription
Get Running ConfigRetrieves the pre-defined remediation configurations associated with detected network configuration.
Get Remediation ConfigApproves patches based on filters.
Send to GatewayTransmits the configuration changes you've made to execute on a network device to OpsRamp Gateway.
Get Baseline ConfigRetrieves the baseline configuration for a network device.


Step 1: Create the Process Definition

To add a new process definition,

  1. Click + ADD. The ADD PROCESS DEFINITION page is displayed.
  2. In the BASIC DETAILS tab, enter the required details and select Category as Network Configuration.
  3. Click Next. The WORKFLOW tab is displayed.

Step 2: Add the Start Event

The first step of any process is to define the start condition.

  1. Click the Create StartEvent symbol from the component tools menu, and place it on the canvas with a click.
  2. Click the Start Event symbol to display the start event properties.
  3. In the Properties section, enter Start for Name.
    The ID property is automatically populated.
  4. For the Input Type, select Resource.

Step 3: Configure the Get Remediation Task

After adding the start event, add tasks to complete the process. The first task is to receive the remediation request.

  1. Click the Start Event, and click Append Task.
  2. Select the task, click the Change type (wrench) icon, and select Service Task.
  3. Click the task on the canvas to display the task properties.
  4. Enter Name, for example: GetRemediation. This name will appear on the task symbol in the workflow. The task ID is generated automatically.
  5. Select Network Service for the Service.
  6. Select Run Remediation Config for the Task.
  7. The Remediation config Id field is context sensitive to the objects in the process definition. Enter a value in the Remediation config Id field, for example: $remediationConfigId.

Step 4: Configure the User Approval Task

After you receive the remediation request, you need to seek user approval to run the network configuration management task.

  1. Click the Get Remediation task, and click Append Task.
  2. Select the task, click the Change type (wrench) icon and select User Task.
  3. Click the task on the canvas to display the task properties.
  4. Enter Name, for example: UserApproval. The task ID is automatically populated.
  5. Enter values for Subject and Description fields.
  6. Click the Priority drop-down and select a priority value.

Step 5: Add the Check Approval Gateway

After you have received user’s response, you can make the decision whether to send the remediation request to the gateway.

  1. Click the User Approval task, click the Change type (wrench) icon and select Append Gateway.
  2. Click the task on the canvas to display the task properties.
  3. Enter Enter Name, for example: checkApproval. The task ID is automatically populated.
  4. (Optional) Select the Enable Loop Count checkbox and then select the loop count number from the drop-down.

Step 6: Configure the Send to Gateway Task

After Step 5, you decide whether to send the remediation request to the gateway based on user approval. If user approval is received, next task is executed, else, the workflow ends.

  1. Click the check Approval gateway, and click Append Task.
  2. Select the task, click the Change type (wrench) icon and select Service Task.
  3. Click the task on the canvas to display the task properties.
  4. Enter Name, for example: SendToGateway. The task ID is automatically populated.
  5. Select Network Service for Service.
  6. Select Run Remediation Config for Task.
  7. Enter Resource Id in the format $Start.resource.uuid.
  8. Enter Config Id in the format remediationConfigId.
  9. Enter Config Details in the format $GetRemediation.remediationConfig.

Step 7: Add the Response Gateway

After the user response is sent to the gateway, you can decide whether to send a success alert or a failure alert. This is achieved by using another gateway. Follow Step 5 to append another gateway with name GatewayResponse.

Step 8: Configure the Alert Task

The next step is to define task for success and failure alerts. The following are the steps to create success alert. You can follow the same steps to create a failure alert.

  1. Click the GatewayResponse gateway, and click Append Task.
  2. Select the task, click the Change type (wrench) icon and select Service Task.
  3. Click the task on the canvas to display the task properties.
  4. Enter Name, for example:SuccessAlert. The task ID is automatically populated.
  5. Select Platform Service for Service.
  6. Select Creat/Update Alert for Task.
  7. Enter Resource Name in the format $Start.resource.uuid.
  8. Enter values for rest of the optional fields.

Step 9: Add the End Event, Save, and Deploy

When you are finished defining the network configuration process, add an end event and save and deploy the process definition.

  1. Click the Alert task, and click Append EndEvent.
  2. Click the task on the canvas to display the task properties.
  3. Enter Name, for example: End.
  4. Click Save & Deploy. The displays in the Process Definitions list.