×
 
 
  •  
$helper.renderConfluenceMacro('{bmc-global-announcement:$space.key}')
TrueSight Orchestration Content 20.18.01 ... Runbooks BMC MyIT Service Broker module

Configuring TrueSight Orchestration Content

This topic describes the configuration settings for configuring the TrueSight Orchestration Content. As a TrueSight Orchestration user/administrator, you must configure the following adapters and modules.  

Web Services adapter

The Web Services adapter is used internally to call ORCA Web Services by the BMC MyIT Service Broker module. 

To configure the Web Services adapter:

  1. Log on to Grid Manager with administrative privileges.
  2. Select Manage > Adapters.

  3. From the Adapters in Repository section, select the ro-adapter-ws adapter and click Add to the Grid.

  4. Click Configure to configure the Web Services adapter.

For more information, see Configuring the Web Services adapter.

BMC MyIT Service Broker module

The BMC MyIT Service Broker module is required for integrating with BMC MyIT Service Broker - BAO Connector. 

To view the module configuration:

  1. Using TrueSight Orchestration Development Studio Project Navigator, open the BMC MyIT Service Broker Integration module.
  2. Double-click configuration.

Consult the following table to view the configuration details.

Configuration groupConfiguration itemDescription
Service
Broker
Integration		ServiceMapping

Specifies the list of services to be made available from MyIT Service Broker

<service-list>
  <service>
    <service-name>Unlock Account</service-name>
    <path>:BMC-SA-SDA_Fulfillment_Cases:
Fulfillment:Account:Unlock:Do Unlock</path>
  </service>
  <service>
    <service-name>Onboard Employee</service-name>
    <path>:BMC-SA-SDA_Fulfillment_Cases:
Fulfillment:Onboarding:Do Onboarding</path>
  </service>
  <service>
    <service-name>Extend Mailbox Size</service-name>
    <path>:BMC-SA-SDA_Fulfillment_Cases:
Fulfillment:Mailbox:Extend:Do Extend</path>
  </service>
</service-list>

<service-name>: Specifies the name of the service that is being fulfilled

<path>: Specifies the path to the TrueSight Orchestration workflow
to be invoked for fulfilling the service

Note: Each time you add a new workflow to be supported in BMC MyIT Service Broker to be
fulfilled by using TrueSight Orchestration, ensure that the service name and the
corresponding path to the workflow is updated in the Service Mapping configuration item.

Only after a service is specified in the module configuration, it will be exposed in BMC MyIT Service Broker.

Connection
Properties		URL

Specifies the URL for the ORCA Web service that points to the peer
where the Web Services adapter is up and running and the modules are activated

Valid value: https://hostname:port/baocdp/orca

 UserName

Specifies the user name to log on to TrueSight Orchestration peer specified in the connection properties

Note: The user must have the Grid Management, Development Studio,
and workflow execution permissions for the required modules.

 PasswordSpecifies the password for the user name
 GridName

Specifies the name of the Grid where the modules are installed

Default value: MyGrid

 UseSSL
Certificate

Specifies whether to use an SSL certificate to establish a secure connection 

Valid values: true, false (default)

 InstallSSL
Certificate

Set the value of this element to true, if you prefer to have security
certificates installed automatically (a common practice). 

Default value: false

 AllowUnsigned
Certificate

Specifies whether to allow unsigned certificates from trusted zones

Valid values: true, false (default)

 PassphraseSpecifies the Java Standard Trust Keystore passphrase 

Default value: changeit
 WebService
AdapterName

Specifies the name of the adapter as configured on the Grid

Default value: SOAPAdapter

 TransportDefault value: https-rpc

BMC SDA Fulfillment Cases module

The BMC Service Desk Automation module is required for the out-of-the-box services exposed to BMC MyIT Service Broker. You can add workflows for more services that match your requirement either in the BMC SDA Fulfillment Cases module or choose to develop a new module. 

Important

Install and configure the BMC SDA Fulfillment Cases module only if you want to run the out-of-the-box use cases such as unlock account, extend mailbox size, and onboard a new employee supported by the BMC MyIT Service Broker integration module.  

To configure BMC SDA Fulfillment Cases module: 

  1. Using TrueSight Orchestration Development Studio Project Navigator, open the BMC Service Desk Automation module, and double-click configuration.
  2. You can add or update the configuration to match your requirements. 

 Consult the following table to view the configuration details.

Configuration groupConfiguration itemDescription
ActiveDirectory  
 Connection detailsContains the integrations settings for the Microsoft Active Directory server
 DefaultAdapterName

Specifies the name of the adapter

Default value: WindowsCommandAdapter

Exchange  
 Adapter

Specifies the name of the adapter

Default value: MicrosoftExchangeActorAdapter

ServiceTypeUnlock Account

Contains the configuration settings for the unlock account service

 

Default_WorkInfo_Failure_Details_Text

Specifies the text to be displayed in case the use case fails

Default value: There was a problem unlocking the requested account.

 Default_WorkInfo_Complete_Details_Text

Specifies the text to be displayed when the use case is executed successfully

Default value: Requested account unlocked successfully.

 UnlockCommand

Specifies the command to be sent to the adapter

Default value:

<unlock-account>
  <command>net user</command>
  <options>
    <option>
      <key>/Active:</key>
      <value>yes</value>
    </option>
  </options>
</unlock-account>
 Onboarding

Contains the configuration settings for the onboarding a new employee service

 Database

Specifies the database to which the user is added

Default value: DEFAULT

 Distribution

Specifies the name of the distribution group to which the new user is added

Default value: DEFAULT

 EmailDomain

Specifies the domain on which you create a new user account

Default value: default.com

 Mailbox Size

Specifies the size of the mailbox to be created for the new user

Default value: 1000MB 

 Default_Password 

Specifies the password for the new user account

Default value: P@ssw0rd

 Extend Mailbox Size

Contains the configuration settings for extending a mailbox size service

 

MaxAllowedMailboxSizeinMB

Specifies the size of the mailbox that can be expanded

The default unit of measurement is megabytes.

Default value: 500MB

 QuotaTypeDefault value: ProhibitSendReceiveQuota
 Default_WorkInfo_Failure_Details_Text

Specifies the text to be added to the work info when the workflow fails

Default value: There was a problem extending the mailbox size.

 Default_WorkInfo_Complete_Details_Text

Specifies the text to be added to the work info when the workflow is executed successfully

Default value: Mailbox Size extended successfully.

 WorkInfo_Failure_Details_Text_GetMailbox

Default value: Failed to get the existing mailbox size.

 WorkInfo_Failure_Details_Text
_ExtensionNotAllowed		Default value: The mailbox is already at the maximum size allowed, 
please talk to your manager if you want to ask for an exception.
 Default_WorkInfo_Partial_Extension
_Complete_Details_Text		Default value: Requested extension was beyond the maximum size allowed. 
Mailbox size extended to the maximum value. 

Where to go from here

After configuring the TrueSight Orchestration adapters and modules, you can now configure BMC MyIT Service Broker.

Was this page helpful? Yes No Submitting... Thank you
Last modified by Shweta Hardikar on May 12, 2018

Comments

Log in or register to comment.

Installing BMC MyIT Service Broker module
Configuring connector in BMC MyIT Service Broker
© Copyright 1996 - 2018 Bladelogic, Inc. © 2014-2018 BMC Software, Inc.
Legal notices

Powered by Atlassian Confluence and Scroll Viewport

© Copyright 2005-2024 BMC Software, Inc. Use of this site signifies your acceptance of BMC’s Terms of Use . BMC, the BMC logo, and other BMC marks are assets of BMC Software, Inc. These trademarks are registered and may be registered in the U.S. and in other countries.