Integration Guides

Clouds

Deployment

ITSM

Service Now

Add Service Now Integration

  1. Navigate to Administration -> Integrations

  2. Select + NEW INTEGRATION

  3. Select ServiceNow from the TYPE dropdown.

  4. Add the following:

    NAME

    Name of the Integration in Morpheus.

    ENABLED

    Leave checked to enable the Integration.

    HOST

    Url of the ServiceNow Instance ex: https://your.instance.service-now.com

    USER

    A user in ServiceNow that is able to access the REST interface and create/update/delete incidents, requests, requested items, item options, catalog items, workflows, etc.

    PASSWORD

    Above ServiceNow user’s password

  5. Save Changes

ServiceNow Approval Policies

Add ServiceNow Provision Approval Policy to a Cloud

Note

Any Instance provisioned into a Cloud with an Approval Policy enabled will require approval.

To add a ServiceNow Approval policy to a Cloud:

  1. Navigate to Infrastructure -> Clouds

  2. Select a Cloud by clicking on the Cloud Name link

  3. Select the POLICIES tab

  4. Select + ADD POLICY

  5. Select Provision Approval

  6. Optionally enter a description for the Policy

  7. Configure the following:

    APPROVAL INTEGRATION

    Select the ServiceNow Integration already configured in Administration -> Integrations to use for the Approval Policy.

    WORKFLOW

    Select the ServiceNow workflow for the Approval workflow in ServiceNow. Note these workflows are configured and synced in from the ServiceNow Integration.

    TENANTS (if applicable)

    Only required for multi-tenant permission scoping. For the policy to apply to a sub-tenant, type the name of the tenant(s) and select the Tenant(s) from the list.

  8. Save Changes

Add ServiceNow Provision Approval Policy to a Group

Note

Any Instance provisioned into a Group with an Approval Policy enabled will require approval.

To add a ServiceNow Approval policy to a Group:

  1. Navigate to Infrastructure -> Groups

  2. Select a Group by clicking on the Group Name link

  3. Select the POLICIES tab

  4. Select + ADD POLICY

  5. Select Provision Approval

  6. Optionally enter a description for the Policy

  7. Configure the following:

    APPROVAL INTEGRATION

    Select the ServiceNow Integration already configured in Administration -> Integrations to use for the Approval Policy.

    WORKFLOW

    Select the ServiceNow workflow for the Approval workflow in ServiceNow. Note these workflows are configured and synced in from the ServiceNow Integration.

    TENANTS (if applicable)

    Only required for multi-tenant permission scoping. For the policy to apply to a sub-tenant, type the name of the tenant(s) and select the Tenant(s) from the list.

  8. Save Changes

Using ServiceNow Approval Policies

Any Instance provisioned into a Cloud or Group with an Approval Policy enabled will be in a PENDING state until the request in Approved.

Instances pending a ServiceNow approval will show “Waiting for Approval” with the Requested Item number and Request number, ex: Waiting for Approval [RITM0010002 - REQ0010002].

ServiceNow Approval requests are displayed in Operations -> Approvals. Instances pending a ServiceNow approval must be Approved in ServiceNow for provisioning to initiate. Approval requests from a ServiceNow Approval Policy cannot be approved in Morpheus, only Internal Approvals.

ServiceNow Approval requests are displayed in Morpheus under Operations -> Approvals. Pending ServiceNow Approval requests can be cancelled in Morpheus by selecting the request and then selecting ACTIONS -> Cancel.

Once a pending ServiceNow Approval request is Approved in ServiceNow, the Instance(s) will begin to provision in Morpheus within 5 minutes of being approved in ServiceNow.

ServiceNow Service Catalog Integration

The following is a guide to installing the Morpheus ServiceNow application.

Important

A valid SSL Certificate is required on the Morpheus Appliance for the ServiceNow plugin to be able to communicate with the appliance.

ServiceNow Configuration
  1. Install the Morpheus Application from the ServiceNow store

  2. Navigate to Morpheus Catalog -> Properties

  3. Set the following properties:

    Morpheus Appliance Endpoint

    The full url to your Morpheus appliance

    Password

    Password of the Morpheus Administrator

    Username

    Username of the Morpheus Administrator

  4. Create a new User

  5. Assign the following roles to the user:

    • x_moda_morpheus_ca.integration
    • catalog_admin
    • itil
    • rest_service
Morpheus Configuration
  1. Navigate to Administration -> Integrations
  2. Click + NEW INTEGRATION
  3. Select ‘ServiceNow’ in the Type field
  4. Fill in the Host, User and Password fields (using the User and Password created in the previous section)

ServiceNow Monitoring Integration Settings

Note

A ServiceNow Integration must be already configured in Administration -> Integrations to enable the ServiceNow Monitoring Integration.

Enabled
Enables the ServiceNow Monitoring Integration
Integration
Select from a ServiceNow Integration added in Administration -> Integrations
New Incident Action
The Service Now action to take when a Morpheus incident is created.
Close Incident Action
The Service Now action to take when a Morpheus incident is closed.

Incident Severity Mapping

Morpheus Severity ServiceNow Impact
Info Low/Medium/High
Warning Low/Medium/High
Critical Low/Medium/High

Keys and Certificates

Venafi

Overview

Morpheus integrates with Venafi to sync and request SSL certificates

Add Venafi

  1. Navigate to Administration > Integrations

  2. Select + NEW INTEGRATION

  3. Enter in the following:

    • Name
    • Venafi Host
    • Username
    • Password
  4. Click SAVE CHANGES

Service Discovery

Consul

Morpheus can integrate with Consul to automatically install the Consul Agent in Client Mode on Instances and configure communication with the Consul host.

Add Consul Integration

  1. Navigate to Administration -> Integrations and select + New Integration

  2. Select Integration Type Consul Service Registry

  3. Populate the following fields:

    Name

    Name of the Consul Integration in Morpheus

    Enabled

    Enabled by default

    Consul Host

    IP or Url of the Consul Host

    Consul Http Port

    Http port of the Consul Host

    Username

    Consul Host User

    Password

    Consul Host User Password

    Datacenter ID

    Validator key for the organization

  4. Save Changes

The added Consul Integration is now available for use in Morpheus , but must be scoped to a Cloud or Group to automatically install the Consul Agent while provisioning.

Scope Consul Integration to a Cloud

  1. Navigate to Infrastructure -> Clouds
  2. Edit the target Cloud
  3. Expand the Advanced Options section
  4. In the Service Registry dropdown, select the Consul Integration.
  5. Save Changes

Scope Consul Integration to a Group

  1. Navigate to Infrastructure -> Groups
  2. Edit the target Group
  3. Expand the Advanced Options section
  4. In the Service Registry dropdown, select the Consul Integration.
  5. Save Changes

And that’s it. After your integration is set up, all containers deployed within the Group or Cloud integrated will provision with the Consul Agent in Client Mode, gossiping to your Consul Server!

Supported Integration Versions

Morpheus supports an extensive range of software integrations and versions past and present. Current iterations of Amazon AWS, Microsoft Azure, Google Cloud Platform, Digital Ocean, HPE OneView, MacStadium, OpenTelekom Cloud, IBM Bluemix, Softlayer and UpCloud are all supported.

In addition below to those we also support versioned software listed below.

Technology Version
Private Cloud  
Azure Stack GA
Microsoft Hyper-V 2012R2, 2016
Nutanix Acropolis 5.0 - 5.6 (Prism Central is not currently supported)
Openstack Juno, Kilo, Liberty, Mitaka, Newton, Ocata, Pike, Queens
vCloud Director 8.20, 9.1
VMware vCenter 5.5, 6.0, 6.5, 6.7
VMware ESXi 5.5, 6.0, 6.5, 6.7
VMware Fusion 8, 9, 10
XenServer 7.0
Monitoring
App Dynamics 4.5.1
Networking
Cisco ACI 3.10
VMware NSX -V
Backups  
Veeam 9.5
Containers
Docker 1.12.6
Kubernetes 1.11
Jenkins 1.64
ITSM
ServiceNow Istanbul, Jakarta, Kingston
Logging
Splunk 7.10

If you have any specific requirements please contact support@morpheusdata.com