Dell Advanced Infrastructure Manager Integration Pack for Microsoft System Center 2012 Orchestrator Version 2.0.
Notes, Cautions, and Warnings NOTE: A NOTE indicates important information that helps you make better use of your computer. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. Information in this publication is subject to change without notice. © 2012 Dell Inc. All rights reserved.
Contents Notes, Cautions, and Warnings...................................................................................................2 1 Overview ......................................................................................................................................5 System Requirements ..............................................................................................................................................5 Registering and Deploying the Integration Pack ...............
Configuring the Filters Tab...............................................................................................................................36 Configuring the Remove Object Activity.................................................................................................................36 Configuring the Update Object Activity..................................................................................................................36 Configuring the Add Persona Activity..........
Overview 1 The Integration Pack for Dell Advanced Infrastructure Manager (AIM) is an add-on for Microsoft System Center 2012 Orchestrator that enables you to automate procedures and processes in the Dell AIM environment. With this integration pack, you can create workflows that interact with and transfer information to other Microsoft System Center products such as Microsoft System Center 2012 - Operations Manager.
Configuring the Integration Pack for Dell AIM Configurations A configuration establishes a reusable link between Orchestrator and a Dell AIM server. Create as many configurations as you require to specify links to multiple servers running Dell AIM. You can also create multiple connections to the same server to allow for differences in security permissions for different user accounts and to manage working with different types of Dell AIM objects.
9. In the AIM Username and AIM Password fields, type the credentials that Orchestrator should use to connect to the Dell AIM server. 10. Click OK to close the configuration dialog box, and then click Finish. Common Configuration Instructions for All Activities The following configuration instructions apply to all activities in this integration pack. Activity Properties Each activity has a set of required or optional properties that define the configuration of that activity.
Is greater than or equal to the property of the object is greater than or equal to the number specified in the filter. Contains the property of the object contains the exact text specified in the filter. Unlike the Equals behavior, other text can surround the matching text. Does not contain the property of the object does not contain the exact text specified in the filter. Unlike the Equals behavior, other text can surround the matching text.
1. Right-click the property value field, click Subscribe, and then click Returned Data. 2. Click the Object drop-down and select the activity from which you want to obtain the data. To view additional data elements common to all policies, select Show Common Returned Data. 3. Click the returned data element, and then click OK.
2 Dell Integration Pack Activities This integration pack adds the Dell AIM category to the Activity pane in the Runbook Designer.
Name Description Value Type Use SSL Specifies whether or not the SSL protocol was used to connect to the Dell AIM server True or False Get Object Activity The Get Object activity is used in a policy to retrieve objects of a specified type from the Dell AIM environment, such as retrieving all of the Networks, Hosts or VMRacks. For the procedure to configure this activity, see Configuring the Get Object Activity. The Get Object activity uses filters to determine which Dell AIM objects is returned.
Element Description Valid Values Look up Tag VMRack VRack ID The ID of the object you want to remove String No Remove Object Returned Data Name Description Value Type AIM Object Type The type of object whose maintenance mode you want to remove String AIM Server Location The location of the Dell AIM server String AIM Server Port The port used to connect to the Dell AIM server Integer AIM Username The username used to connect to the Dell AIM server.
Name Description Value Type AIM Server Port The port used to connect to the Dell AIM server Integer AIM Username The username used to connect to the Dell AIM server. String ID The ID of the object that you want to update Use SSL Specifies whether or not the SSL protocol was used to connect to the Dell AIM server True or False Add Persona Activity The Add Persona activity is used in a policy to add a new persona to the Dell AIM environment.
Element Description Valid Values Look up Health Monitor Enabled Specifies whether or not the True or False persona is monitored by the Controller Yes Health Monitor Hostname The specified host (hostname or IP address) that is checked to determine whether or not the persona is running No Net Boot Specifies whether or not the True or False persona is network booted Yes Networking Enabled Specifies whether or not the True or False persona's networking configuration is modifiable via the installed
Name Description Value Type AIM Server Port The port used to connect to the Dell AIM server Integer AIM Username The username used to connect to the Dell AIM server String AIM Object Type The type of Dell AIM object that you can add String App State The persona's current state create cloneDest cloneSrc dormant runnable retargetting goingDormat failed quarantined Assigned Server Pools The list of server pools this persona is String (CSV) assigned to Confirmations Enabled True if the persona
Name Description Value Type Networking Enabled True if the persona's networking configuration is modifiable via the installed agent; otherwise false True or False Network Mode The network mode of the persona trunk access auto OS Architecture The persona's operating system architecture x86_32 x86_64 OS Family The persona's operating system family linux windows OS Sub Type Specific type of the persona's operating system String OS Version Specified version of the persona's operating system
Element Description Filters Valid Values Is Greater than Is greater than or equal to Confirmations Enabled True if the persona will pause when starting or stopping, waiting for a confirmation to continue; otherwise false Equals Does not equal True or False Consecutive Failures The number of times this persona has failed to boot on any host Equals Does not equal Is Less than Is less than or equal to Is Greater than Is greater than or equal to Integer Copy Enabled Specifies whether or not you can
Element Description Filters Valid Values ID The ID of the persona Equals Does not equal Contains Does not contain Matches pattern Does not match pattern String Name The name of the persona Equals Does not equal Contains Does not contain Matches pattern Does not match pattern String Net Boot Specifies whether or not the Equals persona is network booted Does not equal True or False Networking Enabled Specifies whether nor not the persona's networking configuration is modifiable via the install
Element Description Filters Valid Values Release Name The release name of the persona's agent Equals Does not equal Contains Does not contain Matches pattern Does not match pattern String Routing and DNS Specifies the persona's routing and DNS mode Equals Does not equal managed manual dhcp SCN Assignment Type Specifies how the SCN IP addresses are assigned Equals Does not equal pool static Secondary SCN Address The persona's secondary SCN address Equals Does not equal Contains Does not con
Name Description Value Type runnable retargetting goingDormat failed quarantined Assigned Server Pools The list of server pools this persona is String (CSV) assigned to Build Number Build version of the persona's agent Integer Confirmations Enabled True if the persona will pause when starting or stopping, waiting for confirmations to continue; false otherwise True or False Consecutive Failures The number of consecutive times this Integer persona has failed to boot on any host Copy Enabled True
Name Description Value Type Networking Enabled True if the persona's networking configuration is modifiable via the installed agent; otherwise false True or False Network Mode The network mode of the persona trunk access auto OS Architecture The persona's operating system architecture x86_32 x86_64 OS Family The persona's operating system family linux windows OS Sub Type Specific type of the persona's operating system String OS Version Specified version of the persona's operating system
Remove Persona Required Properties Element Description Valid Values Look up ID The ID of the persona you want to remove String No Remove Persona Returned Data Name Description Value Type AIM Server Location The location of the Dell AIM server String AIM Server Port The port used to connect to the Dell AIM server Integer AIM Username The username used to connect to the Dell AIM server.
Element Description Valid Values Look up Default Gateway The persona’s default gateway String No Description The persona’s description String No DNS Search Domain DNS search domain for the persona String No Extensions Enabled Specifies whether or not persona extensions are executed for this persona True for False Yes Health Monitor Enabled Specifies whether or not the True or False persona is monitored by the Controller Yes Health Monitor Hostname The specified host (hostname or IP a
Element Description Valid Values Look up Template Specifies whether the persona is a template True or False Yes Update Persona Returned Data Name Description Value Type Agent Exists If true, then an agent is installed in the True or False persona; otherwise false AIM Object Type The type of Dell AIM object that you can add.
Name Description Value Type Health Monitor Hostname The specified host (hostname or IP String address) that is checked to determine whether or not the persona is running ID The ID of the persona String Name The name of the persona String Net Boot True if the persona is network booted; True or False otherwise false Network Connections List of network connections assigned to the persona String (CSV) Networking Enabled True if the persona's networking configuration is modifiable via the instal
For the procedure to configure this activity, see Configuring the Add Relationship Activity. Optional properties are generated based on the AIM Object Type that is specified in the Dell AIM Object Type configuration that you select when you define the activity. The activity publishes all of the data from the required and optional properties into returned data.
Get Relationship Required Properties Element Description Valid Values Look up Parent Object Type The type of Dell AIM object that the children are being retrieved from String Yes Parent Object ID The ID of the parent object that the children are being retrieved from String No Get Relationship Returned Data Name Description Value Type AIM Object Type The type of Dell AIM object you can add String AIM Server Location The location of the Dell AIM server String AIM Server Port The port use
Element Description Valid Values Look up Maintenance Description The reason for enabling maintenance mode String No Maintenance Mode Returned Data Name Description Value Type AIM Object Type The type of object whose maintenance mode you want to change String AIM Server Location The location of the Dell AIM server String AIM Server Port The port used to connect to the Dell AIM server Integer AIM Username The username used to connect to the Dell AIM server.
Element Description Valid Values Look up Parameter 3 The third parameter to pass String to the method No Parameter 4 The fourth parameter to pass to the method String No Parameter 5 The fifth parameter to pass to the method String No Parameter 6 The sixth parameter to pass String to the method No Parameter 7 The seventh parameter to pass to the method String No Parameter 8 The eighth parameter to pass to the method String No Parameter 9 The ninth parameter to pass String to the me
Start Activity The Start activity is used in a runbook to start a persona or VMRack that is currently stopped. For the procedure to configure this activity, see Configuring the Start Activity. The activity publishes all of the data from the required and optional properties into returned data.
Name Description Value Type Timeout The number of seconds to wait for the Integer persona or VMRack to start. If not specified, the activity does not wait. Use SSL Specifies whether or not the SSL protocol was used to connect to the Dell AIM server True or False Stop Activity The Stop activity is used in a runbook to stop persona or VMRack that is currently running. For the procedure to configure this activity, see Configuring the Stop Activity.
Name Description Value Type shuttingDown Timeout The number of seconds to wait for the Integer persona or VMRack to stop. If not specified, the activity does not wait.
Configuring Dell Integration Pack Activities 3 Describes the various activities configuration. Configuring the Add Object Activity To configure the Add Object activity: 1. From the Activities pane, drag an Add Object activity to the active policy. 2. Double-click the Add Object activity. The Properties dialog box is displayed. 3. Configure the Properties tab. For more information, see Configure the Properties tab. 4.
4. To make changes to a filter, click the filter and then click Edit. Make the changes, and then click OK. To remove a filter, click the filter and then click Remove. 5. For information about the settings on the General and Run Behavior tabs, see Common Configuration Instructions for All Activities . 6. Click Finish. Configuring the Filters Tab 1. In the Configuration section, click the ellipsis button (...), and select the Dell AIM Object configuration that you want to use for this activity.
4. For information about the settings on the General and Run Behavior tabs, see Common Configuration Instructions for All Activities . 5. Click Finish. Configuring the Add Persona Activity To configure the Add Persona activity: 1. From the Activities pane, drag an Add Persona activity to the active policy. 2. Double-click the Add Persona activity. The Properties dialog box is displayed. 3. Configure the Properties tab, for more information, see Configure the Properties tab. 4.
3. Configure the Properties tab, for more information see Configure the Properties tab. 4. For information about the settings on the General and Run Behavior tabs, see Common Configuration Instructions for All Activities . 5. Click Finish. Configuring the Add Relationship Activity To configure the Add Relationship activity: 1. From the Activities pane, drag an Add Relationship activity to the active policy. 2. Double-click the Add Object activity. The Properties dialog box is displayed. 3.
4. Configure the settings in the Filters tab, for more information. 5. To make changes to a filter, click the filter and then click Edit. Make the changes, and then click OK. 6. To remove a filter, click the filter and then click Remove. For information about the settings on the General and Run Behavior tabs, see Common Configuration Instructions for All Activities . 7. Click Finish. Configuring the Properties tab Get Relationship Activity 1.
Configuring the Maintenance Mode Activity To configure the Maintenance Mode activity: 1. From the Activities pane, drag a Maintenance Mode activity to the active runbook. 2. Double-click the Maintenance Mode activity. The Properties dialog box is displayed. 3. Configure the Properties tab, for more information, see Configure the Properties tab. 4. For information about the settings on the General and Run Behavior tabs, see Common Configuration Instructions for All Activities . 5. Click Finish.
Configuring the Stop Activity To configure the Stop activity: NOTE: If you do not include the optional Timeout property the activity does not wait for the specified persona or VMRack to stop. Since persona booting takes some time, you can choose to poll the state if you are not using the timeout property. 1. From the Activities pane, drag a Stop activity to the active runbook. 2. Double-click the Stop activity. The Properties dialog box is displayed. 3.
Related Reference 4 For more information about Dell AIM, see the related product brochure, whitepaper, and product demo available on the Dell Infrastructure Management website at dell.com/dell-aim. For more information on virtual integrated systems, see the Dell Virtual Integrated System website at content.dell.com/us/en/enterprise/converged-infrastructure.aspx. For more information on Orchestrator, its installation, or features and functionalities. See the Microsoft TechNet site at technet.microsoft.