Cisco TEO Adapter Guide for Cisco Server
Provisioner
Release 2.3
April 2012
Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883
Text Part Number: OL-24578-02
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL
STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT
WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT
SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE
OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public
domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH
ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF
DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING,
WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO
OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this
URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership
relationship between Cisco and any other company. (1110R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display
output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in
illustrative content is unintentional and coincidental.
Cisco TEO Adapter Guide for Cisco Server Provisioner
© 2011–2012 Cisco Systems, Inc. All rights reserved.
CONTENTS
New and Changed Information
Latest Release
v
Previous Releases
Preface
v
vi
vii
Organization
vii
Conventions
viii
Product Documentation ix
Documentation Formats ix
Guides and Release Notes ix
Online Help ix
Open Source License Acknowledgements
ix
Obtaining Documentation and Submitting a Service Request
CHAPTER
1
Understanding the Cisco Server Provisioner Adapter Objects
Accessing the Cisco Server Provisioner Adapter Properties
CHAPTER
2
ix
Viewing Cisco Server Provisioner Adapter Properties
Viewing General Information 1-3
Viewing Adapter-Supported Objects 1-4
Viewing Adapter History 1-5
1-3
Managing Cisco Server Provisioner Runtime Users
2-1
Accessing Runtime Users View
1-1
1-2
2-1
Creating a Cisco Server Provisioner User
Obtaining Authorization APID 2-3
2-2
Managing Cisco Server Provisioner Users 2-4
Modifying a Cisco Server Provisioner User 2-4
Viewing Used By Properties 2-5
Viewing Cisco Server Provisioner User History 2-6
Deleting a Cisco Server Provisioner User 2-8
CHAPTER
3
Managing Cisco Server Provisioner Targets
Accessing Targets View
3-1
3-1
Creating Cisco Server Provisioner Targets
3-3
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
iii
Contents
Managing Cisco Server Provisioner Targets 3-5
Enabling a Cisco Server Provisioner Target 3-5
Disabling a Cisco Server Provisioner Target 3-6
Deleting a Cisco Server Provisioner Target 3-6
Modifying Cisco Server Provisioner Targets 3-7
Modifying Display Name and Description 3-7
Modifying Connection Information 3-8
Viewing Member Of Properties 3-10
Viewing Extended Properties 3-11
Viewing Used By Properties 3-12
Viewing Target History 3-13
CHAPTER
4
Using the Cisco Server Provisioner Activities
Cisco Server Provisioner Activities
4-1
4-1
Defining Cisco Server Provisioner Activities 4-2
Defining Create MAC-Specific Imaging Profile Activity 4-5
Viewing Create MAC-Specific Imaging Profile Activity Results 4-7
Defining Create MAC-Specific Provisioning Role Activity 4-9
Selecting Cisco Server Provisioner Object Names 4-12
Viewing Create MAC-Specific Provisioning Role Activity Results 4-13
Defining Delete MAC-Specific Imaging Profile Activity 4-14
Viewing Delete MAC-Specific Imaging Profile Activity Results 4-15
Defining Delete MAC-Specific Provisioning Role Activity 4-17
Viewing Delete MAC-Specific Provisioning Role Activity Results 4-19
Defining Find MAC-Specific Imaging Profiles Activity 4-20
Viewing Find MAC-Specific Imaging Profiles Activity Results 4-22
Defining Find MAC-Specific Provisioning Roles Activity 4-23
Viewing Find MAC-Specific Provisioning Roles Activity Results 4-25
Defining Find Provisioning Role Templates Activity 4-27
Viewing Find Provisioning Role Templates Activity Results 4-28
Defining Update MAC-Specific Imaging Profile Activity 4-30
Viewing Update MAC-Specific Imaging Profile Activity Results 4-33
Defining Update MAC-Specific Provisioning Role Activity 4-34
Viewing Update MAC-Specific Provisioning Role Activity Results 4-36
INDEX
Cisco TEO Adapter Guide for Cisco Server Provisioner
iv
OL-24578-02
New and Changed Information
New and changed information for the most recent releases of the Cisco TEO Adapter for Cisco Server
Provisioner is as follows:
•
Latest Release
•
Previous Releases
Latest Release
Table 1
April 2012—Cisco TEO Adapter Guide for Cisco Server Provisioner 2.3 Changes
Feature
Location
Renamed adapter and guide to Cisco Server
Provisioner
All
Revised Text Part Number (-01 to -02).
Front cover, footers
Updated Trademark and Copyright date
Inside cover page
Revised section heading to “Managing Cisco
Server Provisioner Users”
Page 2-4
Updated “Defining Cisco Server Provisioner
Activities”
Chapter 4, “Using the Cisco Server Provisioner
Activities”
Added new activity—Find Provisioning Role
Templates
Chapter 4, “Using the Cisco Server Provisioner
Activities”
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
v
New and Changed Information
Previous Releases
Table 2
September—2011 Cisco TEO Adapter for Tidal Server Provisioner 2.2 Changes
Feature
Location
Updated guide name, adapter name and added Text All
Part Number to document.
Added information about viewing Extended Target Chapter 3, “Managing Tidal Server Provisioner
Properties
Targets”
Added Imaging Profile Activities
Chapter 4, “Using the Tidal Server Provisioner
Activities”
Cisco TEO Adapter Guide for Cisco Server Provisioner
vi
OL-24578-02
Preface
The Cisco TEO Adapter for Cisco Server Provisioner provides the functionality in Tidal Enterprise
Orchestrator (TEO) to support automation of tasks on Cisco Server Provisioner servers. The adapter
provides activities to create and edit provisioning roles and imaging profiles that can be used for
provisioning operating systems and VMWare ESX/ESXi Hypervisor. It also provides a Cisco Server
Provisioner target and runtime user.
This guide provides information on the objects supported by the Cisco Server Provisioner adapter.
Organization
This guide includes the following sections:
Chapter 1
Understanding the Cisco Server
Provisioner Adapter Objects
Provides information on accessing and viewing the
objects provided by the adapter.
Chapter 2
Managing Cisco Server
Provisioner Runtime Users
Provides information on accessing, creating and
managing Cisco Server Provisioner runtime users.
Chapter 3
Managing Cisco Server
Provisioner Targets
Provides information on accessing, creating and
managing Cisco Server Provisioner targets.
Chapter 4
Using the Cisco Server
Provisioner Activities
Provides information on defining the activities that
are used in processes that run against your Cisco
Server Provisioner servers.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
vii
Preface
Conventions
This guide uses the following conventions:
Convention
Indication
bold font
Commands and keywords and user-entered text appear in bold font.
italic font
Document titles, new or emphasized terms, and arguments for which you supply
values are in italic font.
[ ]
Elements in square brackets are optional.
{x | y | z }
Required alternative keywords are grouped in braces and separated by
vertical bars.
[x|y|z]
Optional alternative keywords are grouped in brackets and separated by
vertical bars.
string
A nonquoted set of characters. Do not use quotation marks around the string or
the string will include the quotation marks.
courier
font
Terminal sessions and information the system displays appear in courier font.
< >
Nonprinting characters such as passwords are in angle brackets.
[ ]
Default responses to system prompts are in square brackets.
!, #
An exclamation point (!) or a pound sign (#) at the beginning of a line of code
indicates a comment line.
Note
Means reader take note.
Tip
Means the following information will help you solve a problem.
Caution
Timesaver
Warning
Means reader be careful. In this situation, you might perform an action that could result in equipment
damage or loss of data.
Means the described action saves time. You can save time by performing the action described in
the paragraph.
Means reader be warned. In this situation, you might perform an action that could result in
bodily injury.
Cisco TEO Adapter Guide for Cisco Server Provisioner
viii
OL-24578-02
Preface
Product Documentation
Documentation Formats
Documentation is provided in the following electronic formats:
•
Adobe® Acrobat® PDF files
•
Online help
You must have Adobe® Reader® installed to read the PDF files. Adobe Reader installation programs
for common operating systems are available for free download from the Adobe Web site at
www.adobe.com.
Guides and Release Notes
You can download the TEO product documentation from Cisco.com. Release Notes can be found on
Cisco.com and the product CD.
Online Help
Online help is available and can be accessed using the following methods:
•
Click the Help button on any dialog in the application to open the help topic in a pane to the right
of the dialog.
•
In the Tidal Enterprise Orchestrator console:
– Click the Help Pane
tool on the toolbar to open the help topic in a pane to the right of the
console results pane.
– Click Help on the menu bar.
Open Source License Acknowledgements
Licenses and notices for open source software used in Cisco Tidal Enterprise Orchestrator can be found
in the Open Source License Acknowledgements found on Cisco.com. If you have any questions about
the open source contained in this product, please email external-opensource-requests@cisco.com.
Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, submitting a service request, and gathering additional
information, see the monthly What’s New in Cisco Product Documentation, which also lists all new and
revised Cisco technical documentation, at:
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html
Subscribe to the What’s New in Cisco Product Documentation as a RSS feed and set content to be delivered
directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently
supports RSS Version 2.0.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
ix
Preface
Cisco TEO Adapter Guide for Cisco Server Provisioner
x
OL-24578-02
CH A P T E R
1
Understanding the Cisco Server Provisioner
Adapter Objects
The Cisco Server Provisioner adapter provides the functionality in Tidal Enterprise Orchestrator (TEO)
to support task automation on Cisco Server Provisioner servers. The adapter provides a target, runtime
user, and activities to create and edit provisioning roles and imaging profiles used for operating system
or VMWare ESX/ESXi Hypervisor provisioning.
This chapter provides information on accessing and viewing the objects provided by the Cisco Server
Provisioner adapter. It contains the following sections:
•
Accessing the Cisco Server Provisioner Adapter Properties, page 1-2
•
Viewing Cisco Server Provisioner Adapter Properties, page 1-3
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
1-1
Chapter 1
Understanding the Cisco Server Provisioner Adapter Objects
Accessing the Cisco Server Provisioner Adapter Properties
Accessing the Cisco Server Provisioner Adapter Properties
You can view the Cisco Server Provisioner adapter properties from the Administration—Adapters view
in the Console. This view displays general information about the functionality provided by the adapter,
version number, release date and install date.
Step 1
On the Administration workspace, click Adapters to display the installed adapters in the Adapters pane.
Figure 1-1
Step 2
Administration—Adapters View
Select Cisco Server Provisioner Adapter and use one of the following methods to open the Cisco
Server Provisioner Adapter Properties dialog box:
•
Right-click and choose Properties.
•
In the Details pane, click any of the hyperlinks on the General tab.
Cisco TEO Adapter Guide for Cisco Server Provisioner
1-2
OL-24578-02
Chapter 1
Understanding the Cisco Server Provisioner Adapter Objects
Viewing Cisco Server Provisioner Adapter Properties
Viewing Cisco Server Provisioner Adapter Properties
You use the Cisco Server Provisioner Adapter Properties dialog box to view the functionality provided
by the adapter.
Viewing General Information
Use the General tab on the Cisco Server Provisioner Adapter Properties dialog box to view general
information about the adapter.
Figure 1-2
Cisco Server Provisioner Adapter Properties—General Tab
The fields on the General tab are display only and provide the following information about the adapter:
Field
Description
Display name
Name of the adapter that displays in the Adapters pane.
Type
Object type.
Description
Text description of the adapter.
Company
Name of company that created or supplied the adapter
(Cisco).
Version
Version number of the adapter.
Release date
Date and time the adapter was available in the product.
Install date
Date and time the adapter was installed.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
1-3
Chapter 1
Understanding the Cisco Server Provisioner Adapter Objects
Viewing Cisco Server Provisioner Adapter Properties
Viewing Adapter-Supported Objects
Use the Provides tab to view the name and type of object provided by the adapter.
Step 1
On the Cisco Server Provisioner Adapter Properties dialog box, click the Provides tab.
Figure 1-3
Step 2
Cisco Server Provisioner Adapter Properties—Provides Tab
Review the following information about the objects provided by the adapter:
Column
Description
Name
Name of the activities, processes and objects that the
adapter supports.
Type
Object type (Target, Activity, Runtime User).
Cisco TEO Adapter Guide for Cisco Server Provisioner
1-4
OL-24578-02
Chapter 1
Understanding the Cisco Server Provisioner Adapter Objects
Viewing Cisco Server Provisioner Adapter Properties
Viewing Adapter History
Use the History tab to view a history of changes that have been made to the adapter.
Step 1
On the Cisco Server Provisioner Adapter Properties dialog box, click the History tab.
Figure 1-4
Step 2
Cisco Server Provisioner Adapter Properties—History Tab
View the following information:
Field
Description
Created by
Display only. User name of the person who created the
object.
Created time
Display only. Date and time the object was created.
Time
Date and time the action occurred.
Change Type
Action that occurred.
User
User name of the person that performed the action.
Description
Information about the action that was performed.
Step 3
To view the audit history for a specific action, select the item, right-click and choose Properties.
Step 4
Click OK to close the dialog box.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
1-5
Chapter 1
Understanding the Cisco Server Provisioner Adapter Objects
Viewing Cisco Server Provisioner Adapter Properties
Cisco TEO Adapter Guide for Cisco Server Provisioner
1-6
OL-24578-02
CH A P T E R
2
Managing Cisco Server Provisioner Runtime
Users
The Runtime Users feature is used to create a runtime user record to store the information about the user
security context. You assign runtime users to a process or activities within a process to specify the proper
security context to be used to execute the process or activity.
The Cisco Server Provisioner adapter provides the Cisco Server Provisioner User account for connecting
to the Cisco Server Provisioner servers that are configured in Tidal Enterprise Orchestrator (TEO). You
can create the runtime user accounts prior to configuring the targets or during the configuration.
This chapter guides you through accessing the Runtime Users view, creating a Cisco Server Provisioner
User, and managing the user account. It includes the following sections:
•
Accessing Runtime Users View, page 2-1
•
Creating a Cisco Server Provisioner User, page 2-2
•
Managing Cisco Server Provisioner Users, page 2-4
Accessing Runtime Users View
Use the Definitions—Runtime Users view to display the credentials of the runtime users and to specify
new runtime user credentials, update the credentials of users, or delete users.
Figure 2-1
Definitions—Runtime Users View
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
2-1
Chapter 2
Managing Cisco Server Provisioner Runtime Users
Creating a Cisco Server Provisioner User
Creating a Cisco Server Provisioner User
The Cisco Server Provisioner User is the account that will be used to connect to a Cisco Server
Provisioner target. You can create the Cisco Server Provisioner Users prior to defining the Cisco Server
Provisioner targets or during the target definition process.
Step 1
On the Definitions workspace, right-click Runtime User and choose New > Cisco Server Provisioner
User to display the New Cisco Server Provisioner User Properties dialog box.
Figure 2-2
Note
Step 2
New Cisco Server Provisioner User Properties—General Tab
The Required Value
icon displayed on a tab or page indicates that the field is required and
is either missing a value or contains an invalid value.
Specify the information in the following text fields:
Field
Description
Display name
Enter the name to be assigned to the user account. This
is the name that will display in the Runtime Users view.
Type
Display only. Type of object.
Owner
Name of the user who owns the object. Click the
Browse
tool to change the owner.
User name
Enter the user name for the account that connects to the
Cisco Server Provisioner server.
Password
Enter the password that is assigned to the Cisco Server
Provisioner user account.
Cisco TEO Adapter Guide for Cisco Server Provisioner
2-2
OL-24578-02
Chapter 2
Managing Cisco Server Provisioner Runtime Users
Creating a Cisco Server Provisioner User
Field
Description
Authorization APID
Enter the authorization APID assigned to the user
account.
Note
Description
Note
For information on obtaining an authorization
APID, see Obtaining Authorization APID,
page 2-3.
Optional. Enter a description of the runtime user
account.
The Used By tab displays objects used by the runtime user and will remain blank until used by
an object.
The History tab displays the history of actions taken against the runtime user and will remain
blank until after the initial creation.
Step 3
Click OK to close the dialog box.
Obtaining Authorization APID
Cisco Server Provisioner API access is restricted to known IP addresses and requires authorization
tokens called APIDs. Authorization APIDs are created and managed via a script available only to the
root user on the Cisco Server Provisioner server. After providing a user name, password and the IP
address of the server running your application that interacts with the Cisco Server Provisioner API, you
will be issued an Authorization APID.
When you create a Cisco Server Provisioner User runtime account, you must provide the Authorization
APID for the user account that is accessing the Cisco Server Provisioner server.
Step 1
Log in as root on the Cisco Server Provisioner host machine, and run the following commands on the
command line:
cd /home/tftpboot/bin
sh lbmp-API_APID_management.sh
Step 2
To add an Authorization APID, use the following example:
Select APID Action:
----> type response and press enter, "q" will quit the process
add, change, delete, quit; a/c/d/q: a
----> type response and press enter, "q" will quit the process
Calling IP address: 192.168.0.106
Choose a User name for this server
----> type response and press enter, "q" will quit the process
Calling user name: cloud_manager
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
2-3
Chapter 2
Managing Cisco Server Provisioner Runtime Users
Managing Cisco Server Provisioner Users
Choose a User password for this server
Avoid special characters, more than 8 letters and numbers work best
----> type response and press enter, "q" will quit the process
Calling user password: cQ4w9tSb
IP APIDs list:
key: 1 IP: 192.168.0.106 APID: 203073805ccd0c6f700d3246955bcb34
LAST AUTH: not_activated USER: cloud_manager:cQ4w9tSb
Managing Cisco Server Provisioner Users
Use the Definitions—Runtime Users view to manage the Cisco Server Provisioner User records. You use
the Cisco Server Provisioner User Properties dialog box to modify the Cisco Server Provisioner User
record, view the objects in the product that use the Cisco Server Provisioner User record, and view a
history of changes made to the record.
Modifying a Cisco Server Provisioner User
Step 1
In the Definitions view, click Runtime Users to display the defined runtime users in the Runtime Users
pane.
Step 2
Double-click the Cisco Server Provisioner User record, or right-click and choose Properties.
Figure 2-3
Cisco Server Provisioner User Properties—General Tab
Cisco TEO Adapter Guide for Cisco Server Provisioner
2-4
OL-24578-02
Chapter 2
Managing Cisco Server Provisioner Runtime Users
Managing Cisco Server Provisioner Users
Step 3
Step 4
Use the General tab to view and modify the following information:
Field
Description
Display name
Name assigned to the user account that will display in the
Runtime Users pane.
Type
Display only. Type of object.
Owner
Owner of the object. Click the Browse
the owner.
User name
Enter the user name for the account that connects to the
Cisco Server Provisioner server.
Password
Check the check box and enter a new password for the user
account.
Authorization APID
Enter the authorization APID assigned to the user account.
Description
Optional. Enter a text description of the runtime user
account.
tool to change
Confirm the changes, and then click OK to close the dialog box.
Viewing Used By Properties
Use the Used By tab to view the objects that are directly associated with the Cisco Server Provisioner
User record.
Step 1
In the Definitions view, click Runtime Users to display the defined runtime users in the Runtime Users
pane.
Step 2
Double-click the Cisco Server Provisioner User record, or right-click and choose Properties.
Step 3
Click the Used By tab to view the objects used by the runtime user.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
2-5
Chapter 2
Managing Cisco Server Provisioner Runtime Users
Managing Cisco Server Provisioner Users
Figure 2-4
Cisco Server Provisioner User Properties—Used By Tab
Step 4
To view the properties for a specific object, right-click the object and choose Properties.
Step 5
Click OK to close the dialog box.
Viewing Cisco Server Provisioner User History
Use the History tab to view a history of changes that have been made to the Cisco Server Provisioner
User account.
Step 1
In the Definitions view, click Runtime Users to display defined runtime users in the Runtime Users
pane.
Step 2
Double-click the Cisco Server Provisioner User record, or right-click and choose Properties.
Step 3
Click the History tab to view the changes made to the runtime user.
Cisco TEO Adapter Guide for Cisco Server Provisioner
2-6
OL-24578-02
Chapter 2
Managing Cisco Server Provisioner Runtime Users
Managing Cisco Server Provisioner Users
Figure 2-5
Cisco Server Provisioner User Properties—History Tab
The following information about the history of the Cisco Server Provisioner User displays:
Field
Description
Created by
Display only. User name of the person who created the
object.
Created time
Display only. Date and time the object was created.
Time
Date and time the action occurred.
User
User name of the person that performed the action.
Type
Action that occurred.
Description
Information about the action that was performed.
Step 4
To view the audit history for the object, right-click the item in the list box and choose Properties.
Step 5
Click OK to close the dialog box.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
2-7
Chapter 2
Managing Cisco Server Provisioner Runtime Users
Managing Cisco Server Provisioner Users
Deleting a Cisco Server Provisioner User
Use the Definitions—Runtime Users view to delete a Cisco Server Provisioner User record.
Step 1
In the Definitions view, click Runtime Users to display the defined runtime users in the Runtime Users
pane.
Step 2
Right-click the Cisco Server Provisioner User record and choose Delete.
Figure 2-6
Step 3
Confirm Cisco Server Provisioner User Delete
Click Yes to confirm the deletion and complete the procedure.
Cisco TEO Adapter Guide for Cisco Server Provisioner
2-8
OL-24578-02
CH A P T E R
3
Managing Cisco Server Provisioner Targets
The Cisco Server Provisioner target enables you to run a process or activity on a specific Cisco Server
Provisioner server. The targets can be defined once and reused in several processes.
This chapter guides you through accessing, creating and managing Cisco Server Provisioner targets. It
includes the following sections:
•
Accessing Targets View, page 3-1
•
Creating Cisco Server Provisioner Targets, page 3-3
•
Managing Cisco Server Provisioner Targets, page 3-5
Accessing Targets View
You use the Definitions—Targets view to create, manage and delete targets. Information about the
configured targets display in the Targets pane, including the type of target, its status, the automation pack
it is associated with, and the date and time modifications were made to it.
Figure 3-1
Definitions—Targets View
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
3-1
Chapter 3
Managing Cisco Server Provisioner Targets
Accessing Targets View
Information about the targets can be displayed in the following columns:
Note
Column
Description
Display name
Name assigned to the target.
Enabled
Indicates whether the target is enabled (True) or
disabled (False). A disabled target is unavailable for
execution.
Type
Type of target based on the associated adapter.
Status
Indicates the status of the target. The status is used to
determine whether the target is available or is
unavailable for process or activity execution.
•
Unknown—Status of the target is unknown.
•
Normal—No known problems with this target.
•
Unreachable—No known problems with this
target.
•
Disabled—Target is disabled and is unavailable for
activity execution.
Status Information
Detailed information regarding the target status and the
reasons for target being unreachable.
Automation Pack
Name of the automation pack associated with the
target.
Owner
User name of the person who created the target.
Last Modified Time
Date and time the target was last modified.
Last Modified By
User name of the person who last modified the target.
Id
Unique identification number of the target definition.
Description
Text description of the target.
Type Description
Text description of the target type.
Created Time
Date and time the target was created.
Created By
User name of the person who created the target.
For information on adding, removing or sorting column headings on the display, see the Tidal Enterprise
Orchestrator Reference Guide.
Cisco TEO Adapter Guide for Cisco Server Provisioner
3-2
OL-24578-02
Chapter 3
Managing Cisco Server Provisioner Targets
Creating Cisco Server Provisioner Targets
Creating Cisco Server Provisioner Targets
Before you can create or run processes on your Cisco Server Provisioner servers, you must create the
targets on which the processes will run. You use the Connection tab on the New Cisco Server Provisioner
Properties dialog box to create Cisco Server Provisioner targets.
Use the Definitions—Targets view to create the Cisco Server Provisioner targets.
Step 1
In the Definitions view, right-click Targets and choose New > Cisco Server Provisioner from the
submenus to open the New Cisco Server Provisioner Properties dialog box.
Figure 3-2
Step 2
New Cisco Server Provisioner Properties—General Tab
On the General tab, enter the following general information about the target:
Field
Description
Display name
Name of the target that displays in the Targets pane.
Type
Display only. Type of target.
Owner
User name of the owner of the target. This is typically the
person who created the target.
Click the Browse
tool to change the owner.
Status
Display only. Indicates the status of the target. The status
determines whether the target is available or unavailable
for process or activity execution.
Status Information
Display only. Detailed information regarding the target
status and the reasons for the target being unreachable.
Organization
Name of the company that supports the target.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
3-3
Chapter 3
Managing Cisco Server Provisioner Targets
Creating Cisco Server Provisioner Targets
Field
Description
Description
Text description of the target.
Enabled
Check or uncheck the check box to enable or disable the
target. The check box is checked by default which makes
it available immediately upon creation.
If you uncheck the check box, the target is disabled and
will be unavailable for execution.
Step 3
Click the Connection tab to specify the connection information for the Cisco Server Provisioner target.
Note
The Required Value
icon displayed on a tab or page indicates that the field is required and
is either missing a value or contains an invalid value.
Figure 3-3
Step 4
New Cisco Server Provisioner Properties—Connection Tab
On the Connection tab, specify the following information:
Field
Description
Host name or IP address
Enter the IP address or name of the server that hosts
Cisco Server Provisioner.
Port
Port number for connecting to the Cisco Server
Provisioner target. By default, port 80 is used for http
connection.
Cisco TEO Adapter Guide for Cisco Server Provisioner
3-4
OL-24578-02
Chapter 3
Managing Cisco Server Provisioner Targets
Managing Cisco Server Provisioner Targets
Field
Description
Default runtime user
Runtime user account to be used to connect to the
target. Choose the default runtime user from the
drop-down list.
To view the properties for the runtime user, click the
Properties
tool.
To create a new runtime user, click New > Cisco Server
Provisioner User.
Step 5
Click OK to complete the procedure and close the dialog box.
Managing Cisco Server Provisioner Targets
Use the Definitions—Targets view to manage the Cisco Server Provisioner targets. From this view, you
can enable and disable the target, delete the target, and view and modify the target properties.
Enabling a Cisco Server Provisioner Target
A target is enabled by default after it is created. If a target is manually disabled, it must be enabled before
it is available for execution.
Step 1
Step 2
On the Definitions—Targets view, use one of the following methods to enable the target:
•
In the Targets pane, right-click the Cisco Server Provisioner target and choose Enable.
•
In the Targets pane, select the Cisco Server Provisioner target and then click the Click here link
in the Details pane.
Verify that the status in the Enabled column in the Targets pane is True. If necessary, click the Refresh
tool to update the view.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
3-5
Chapter 3
Managing Cisco Server Provisioner Targets
Managing Cisco Server Provisioner Targets
Disabling a Cisco Server Provisioner Target
Disabling a target prevents it from being available for execution. However, a disabled target is not
removed from the list of targets in the Targets pane.
Step 1
Step 2
On the Definitions—Targets view, use one of the following methods to disable the target:
•
In the Targets pane, right-click the Cisco Server Provisioner target and choose Disable.
•
In the Targets pane, select the Cisco Server Provisioner target and then click the Click here link
in the Details pane.
Verify that the status in the Enabled column in the Targets pane is False. If necessary, click the Refresh
tool to update the view.
Deleting a Cisco Server Provisioner Target
Before deleting a target, open the Cisco Server Provisioner Properties dialog box and click the Used By
tab to view where objects are being used by the target. This ensures that deleting the target does not affect
any processes or activities.
Step 1
In the Definitions—Targets view, right-click the Cisco Server Provisioner target and choose Delete.
Figure 3-4
Step 2
Confirm Cisco Server Provisioner Delete
Click Yes to confirm the deletion. The target will be removed from the product.
Cisco TEO Adapter Guide for Cisco Server Provisioner
3-6
OL-24578-02
Chapter 3
Managing Cisco Server Provisioner Targets
Managing Cisco Server Provisioner Targets
Modifying Cisco Server Provisioner Targets
Use the Definitions—Targets view to display and modify the Cisco Server Provisioner target properties.
Modifying Display Name and Description
Step 1
In the Definitions view, click Targets to display the defined targets in the Targets pane.
Step 2
Double-click the Cisco Server Provisioner target, or right-click and choose Properties.
Figure 3-5
Step 3
Cisco Server Provisioner Properties—General Tab
Use the General tab to view or modify the following information:
Field
Description
Display name
Name of the Cisco Server Provisioner target that displays
in the Targets pane.
Type
Display only. Type of target.
Owner
User name of the owner of the target. This is typically the
person who created the target.
Click the Browse
tool to change the owner.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
3-7
Chapter 3
Managing Cisco Server Provisioner Targets
Managing Cisco Server Provisioner Targets
Step 4
Field
Description
Status
Display only. Indicates the status of the target. The status
determines whether the target is available or unavailable
for process or activity execution.
•
Unknown—Status of the target cannot be identified.
•
Normal—No known problems with this target.
•
Unreachable—Target cannot currently be reached.
•
Disabled—Target is disabled and in unvailable for
activity execution.
Status information
Display only. Detailed information regarding the target
status and the reasons for the target being unreachable.
Organization
Name of the organization that supports the target.
Description
Text description of the target.
Enabled
Check or uncheck the check box to enable or disable the
target. The check box is checked by default to indicate the
target is enabled.
Click OK to save your changes and close the dialog box.
Modifying Connection Information
You can modify the Cisco Server Provisioner host or change the default runtime user record that
connects to the host server using the Connection tab on the Cisco Server Provisioner Properties dialog
box.
Step 1
In the Definitions view, click Targets to display the defined targets in the Targets pane.
Step 2
Double-click the Cisco Server Provisioner target or right-click and choose Properties.
Step 3
On the Cisco Server Provisioner Properties dialog box, click the Connection tab.
Cisco TEO Adapter Guide for Cisco Server Provisioner
3-8
OL-24578-02
Chapter 3
Managing Cisco Server Provisioner Targets
Managing Cisco Server Provisioner Targets
Figure 3-6
Step 4
Cisco Server Provisioner Properties—Connection Tab
Use the Connection tab to view or modify the following information:
Field
Description
Host name or IP address
Enter the IP address or name of the server that hosts Cisco
Server Provisioner.
Port
Port number for connecting to the Cisco Server Provisioner
target. By default, port 80 is used for http connection.
Default runtime user
Runtime user account to be used to connect to the target.
Choose the default runtime user from the drop-down list.
To view the properties for the runtime user, click the
Properties
tool.
To create a new runtime user, click New > Cisco Server
Provisioner User.
Step 5
Click OK to save your changes and close the dialog box.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
3-9
Chapter 3
Managing Cisco Server Provisioner Targets
Managing Cisco Server Provisioner Targets
Viewing Member Of Properties
You can view the target groups to which a target belongs using the Member Of tab on the Cisco Server
Provisioner Properties dialog box.
Step 1
In the Definitions view, click Targets to display the defined targets in the Targets pane.
Step 2
Double-click the Cisco Server Provisioner target, or right-click and choose Properties.
Step 3
On the Cisco Server Provisioner Properties dialog box, click the Member Of tab.
Figure 3-7
Cisco Server Provisioner Properties—Member Of Tab
Step 4
In the list box, view the target groups that the target is a member.
Step 5
To view the properties of a specific target group, right-click the target group and choose Properties.
Step 6
Click OK to close the dialog box.
Cisco TEO Adapter Guide for Cisco Server Provisioner
3-10
OL-24578-02
Chapter 3
Managing Cisco Server Provisioner Targets
Managing Cisco Server Provisioner Targets
Viewing Extended Properties
You can view the extended properties that have been defined for the target using the Extended Properties
tab on the Cisco Server Provisioner Properties dialog box.
Note
For additional information about Extended Target Properties, see the Tidal Enterprise Orchestrator
Reference Guide.
Step 1
In the Definitions view, click Targets to display the defined targets in the Targets pane.
Step 2
Double-click the Cisco Server Provisioner target, or right-click and choose Properties.
Step 3
On the Cisco Server Provisioner Properties dialog box, click the Extended Properties tab.
Figure 3-8
Cisco Server Provisioner Properties—Extended Properties Tab
Step 4
In the list box, view the extended target properties.
Step 5
To modify the extended property, select it and then click Edit.
Step 6
Click OK to close the dialog box.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
3-11
Chapter 3
Managing Cisco Server Provisioner Targets
Managing Cisco Server Provisioner Targets
Viewing Used By Properties
You can view the objects that are directly associated with the selected target (for example, a process or
activity) using the Used By tab on the Cisco Server Provisioner Properties dialog box.
Step 1
In the Definitions view, click Targets to display the defined targets in the Targets pane.
Step 2
Double-click the Cisco Server Provisioner target, or right-click and choose Properties.
Step 3
On the Cisco Server Provisioner Properties dialog box, click the Used By tab.
Figure 3-9
Cisco Server Provisioner Properties—Used By Tab
Step 4
In the list box, view the objects that are used by the target.
Step 5
To view the properties of a specific object, right-click the object and choose Properties.
Step 6
Click OK to close the dialog box.
Cisco TEO Adapter Guide for Cisco Server Provisioner
3-12
OL-24578-02
Chapter 3
Managing Cisco Server Provisioner Targets
Managing Cisco Server Provisioner Targets
Viewing Target History
You can view the history of changes that have been made to the target using the History tab on the Cisco
Server Provisioner Properties dialog box.
Step 1
In the Definitions view, click Targets to display the defined targets in the Targets pane.
Step 2
Double-click the Cisco Server Provisioner target, or right-click and choose Properties.
Step 3
On the Cisco Server Provisioner Properties dialog box, click the History tab.
Figure 3-10
Cisco Server Provisioner Properties—History Tab
Step 4
In the list box, view the changes that have been made to the target.
Step 5
To view the audit history for a specific action in the list box, right-click the item and choose Properties.
Step 6
Click OK to close the dialog box.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
3-13
Chapter 3
Managing Cisco Server Provisioner Targets
Managing Cisco Server Provisioner Targets
Cisco TEO Adapter Guide for Cisco Server Provisioner
3-14
OL-24578-02
CH A P T E R
4
Using the Cisco Server Provisioner Activities
The Cisco Server Provisioner activities enable you to create processes that automate tasks on the Cisco
Server Provisioner servers. When defining an activity in the process workflow, the properties pane
contains property pages that are specific to the selected activity.
This chapter provides instructions for defining an activity using the Cisco Server Provisioner activities,
instructions for completing the property pages for each specific Cisco Server Provisioner activity, and
instructions on viewing the activity results. It includes the following sections:
•
Cisco Server Provisioner Activities, page 4-1
•
Defining Cisco Server Provisioner Activities, page 4-2
Cisco Server Provisioner Activities
The Cisco Server Provisioner adapter provides activities for automating tasks on the Cisco Server
Provisioner instances. The following table displays the activities that are available in the product.
Activity Name
Description
Create MAC-Specific Imaging Profile
Use this activity to create the properties of an imaging
profile. See Defining Create MAC-Specific Imaging
Profile Activity, page 4-5.
Create MAC-Specific Provisioning Role
Use this activity to create a provisioning role. See Defining
Create MAC-Specific Provisioning Role Activity,
page 4-9.
Delete MAC-Specific Imaging Profile
Use this activity to delete the properties of an imaging
profile. See Defining Delete MAC-Specific Imaging
Profile Activity, page 4-14.
Delete MAC-Specific Provisioning Role
Use this activity to delete a provisioning role. See Defining
Delete MAC-Specific Provisioning Role Activity,
page 4-17.
Find MAC-Specific Imaging Profiles
Use this activity to retrieve a list of imaging profiles. See
Defining Find MAC-Specific Imaging Profiles Activity,
page 4-20.
Find MAC-Specific Provisioning Roles
Use this activity to retrieve a list of provisioning roles. See
Defining Find MAC-Specific Imaging Profiles Activity,
page 4-20.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
4-1
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Activity Name
Description
Find Provisioning Role Templates
Use this activity to find the provisioning role templates.
See Defining Find Provisioning Role Templates Activity,
page 4-27.
Update MAC-Specific Imaging Profile
Use this activity to modify the properties of an imaging
profile. See Defining Update MAC-Specific Imaging
Profile Activity, page 4-30.
Update MAC-Specific Provisioning Role Use this activity to modify the properties of a provisioning
role. See Defining Update MAC-Specific Provisioning
Role Activity, page 4-34.
Defining Cisco Server Provisioner Activities
Use the following steps to define a Cisco Server Provisioner activity in the Process Editor. The property
pages that display depend on the activity. Refer to the appropriate section for instructions on completing
the activity property pages.
Step 1
On the Toolbox pane, navigate to the Cisco Server Provisioner section, click the activity and drag it onto
the Workflow pane.
The Activity Properties dialog box displays.
Note
The Required Value
icon displayed on a tab or page indicates that the field is required and
is either missing a value or contains an invalid value.
The Insert Wildcard
tool displayed next to a text field indicates that you can select a
wildcard to include in the field.
The Reference
tool displayed next to a text field indicates that you can select a defined
variable or reference an object within the process. For additional information, see the Tidal
Enterprise Orchestrator Reference Guide.
Step 2
Step 3
On the General tab, enter the following information:
Field
Description
Display name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Click the Activity-specific tab and enter the required information. See the appropriate section in this
chapter for instructions on completing the fields on the activity-specific tab.
Cisco TEO Adapter Guide for Cisco Server Provisioner
4-2
OL-24578-02
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Step 4
Click the Target tab to specify the process target. You can use the process target or override it and
specify a different target for the specific activity.
Field
Description
Execute on the process target
Click this radio button to use the same target that was
specified for the process.
Execute on activity target
Click this radio button to indicate that the activity should
execute against a target selected in an activity within the
process. Choose the activity from the drop-down list.
Execute on this target
Click this radio button and then click the Browse
tool
to launch the Select Target dialog box and choose a
specific target on which to execute the activity.
The targets that display in the Select Target dialog box are
targets already defined in TEO.
To view the properties for the selected target, click the
Properties
tool.
Execute on this target reference
Click this radio button and then click the Reference
tool to select the target reference property on which to
execute the activity.
You can also click the click the Browse
tool to launch
the Select Target dialog box and choose a specific target on
which to execute the activity.
Execute on this target group
Click this radio button and then click the Browse
tool
to launch the Select Target Group dialog box and choose a
specific target on which to execute the activity.
The target groups that display in the Select Target Group
dialog box are target groups already defined in TEO.
To view the properties for the selected target group, click
the Properties
tool.
From the Choose a target using this algorithm drop-down
list, select the algorithm which will determine the target to
execute from the eligible target group.
Note
The available algorithms that display depend on
the selected activity.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
4-3
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Step 5
Click the Credentials tab to specify the runtime user whose credentials should be used for process
execution:
Field
Description
Use target's default runtime user
Click this radio button to use the default runtime user
for the target that is specified in the activity.
Use process runtime user
Click this radio button to use the credentials for the
runtime user that was specified for the process.
Override process runtime user
Click this radio button to specify different credentials
than what are used for the process. The selected
runtime user overrides the runtime user that was
specified for the process.
•
To view the properties for the selected runtime
user, click the Properties
tool.
•
To create a runtime user record for the process,
click New.
For additional information on creating a runtime users,
see the Tidal Enterprise Orchestrator Reference Guide.
Step 6
Click the Knowledge Base tab to specify a knowledge base article for the activity. The following
information displays:
Field
Description
Knowledge base
Knowledge base article associated with the activity.
Summary
Brief description of the issue.
Possible Cause
Explanation of the condition that may be causing the issue.
Possible resolution
List of actions that can be performed to attempt to resolve
the issue.
Related information
Additional information related to the issue.
a.
If the knowledge base article is not displayed by default, click the Browse
Base field.
b.
On the Select Knowledge Base dialog box, select the appropriate knowledge base article in the list
and click OK.
Note
tool in the Knowledge
Click New to create a new knowledge base article. For additional information on knowledge base
articles, see the Tidal Enterprise Orchestrator Reference Guide.
Cisco TEO Adapter Guide for Cisco Server Provisioner
4-4
OL-24578-02
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Step 7
Step 8
Click the Result Handlers tab to specify condition branches for the activity.
Button
Description
Add
Adds a condition branch.
Remove
Removes the condition branch from the activity.
Move Up
Moves the condition up one position in the list of
conditions.
Move Down
Moves the condition down one position in the list of
conditions.
Click the Save
tool to save the activity definition.
Defining Create MAC-Specific Imaging Profile Activity
Use the Create MAC-Specific Imaging Profile activity to create the properties of an imaging profile.
Step 1
On the Toolbox, click the Create MAC-Specific Imaging Profile activity and drag it onto the Workflow
pane.
Figure 4-1
Step 2
Step 3
Create MAC-Specific Imaging Profile Properties—General Tab
On the General tab, enter the following information:
Field
Description
Display name
Name of the activity.
Type
Display only. Type of activity generated.
Description
Text description of the activity.
Click the Profile tab.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
4-5
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Figure 4-2
Step 4
Create MAC-Specific Imaging Profile Properties—Profile Tab
Complete the fields on the Profile tab with the following information:
Field
Description
Unique profile name
Specify a unique profile name for the imaging profile.
MAC address
Specify the MAC address of the server to which the
imaging profile will be assigned.
Disk image snapshot directory
Specify the backup or restore directory name in
/home/tftpboot/images/ on the Cisco Server Provisioner
server.
Disk type and letter(s)
Specify the type of disk drive where your master boot
record is located (for example, sda, sdb, sdc for SATA,
HDS, HDB, HDC).
Note
For Windows file systems C:\, choose SDA disk
type.
Backup parameters
Specify the parameters to be used for backing up the
imaging profile.
Restore parameters
Specify the parameters to be used for restoring the
image profile.
Imaging action upon network boot
Choose one of the following options to indicate the
action to take when the network is rebooted:
•
Backup—Create a backup of the image.
•
Restore—Restore the image.
•
No imaging action—No action should be taken.
Cisco TEO Adapter Guide for Cisco Server Provisioner
4-6
OL-24578-02
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Note
Step 5
Step 6
For the Backup and Restore parameters, the following notes apply:
•
Backup Parameter -q2 invokes part-clone overriding the default part-image; part-clone is required
for ESX and other file system types e.g. Ext4 and ReiserFS.
•
Backup and Restore Parameters -j1 and -j2 handle MBR processing to support restore to disks not
preformatted to match the backup file type. These may be required for Windows 2008 Server, ESX,
Ubuntu, and Debian.
•
Backup Parameter -sc Skip file system type checking, use for ESX, ESXi or whenever the message
"Broken partition images" appears on the client due to "dd" type partitions being backed up and
checked. The image checking after saving is turned on by default.
Complete the appropriate information in the following tabs:
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the process.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
Viewing Create MAC-Specific Imaging Profile Activity Results
When the Create MAC-Specific Imaging Profile activity is executed, results are displayed in the
Operations workspace activity instance view.
Step 1
In the Operations workspace, expand the Activity Views folder and then click the view that represents
how the process was executed (for example, View Adhoc if the process was manually executed).
Step 2
In the View Results pane, expand the process, and double-click the activity instance or right-click and
choose Properties.
On the Create MAC-Specific Imaging Profile Instance Properties dialog box, the General tab displays
whether the imaging profile was successfully created.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
4-7
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Figure 4-3
Step 3
Step 4
Create MAC-Specific Imaging Profile Instance Properties—General Tab
On the General tab, review the display-only information about the activity:
Field
Description
Display name
Name of the activity.
Type
Type of object.
Description
Text description of the activity.
Owner
User name of the person who owns the activity.
State
Current state of the activity (Succeeded or Failed)
Error
Description of the error that has occurred if the State
field displays Failed-Not Completed.
Start time
Date and time the activity started running.
End time
Date and time the activity completed.
Click Close to close the dialog box.
Cisco TEO Adapter Guide for Cisco Server Provisioner
4-8
OL-24578-02
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Defining Create MAC-Specific Provisioning Role Activity
Use the Create MAC-Specific Provisioning Role activity to create a provisioning role that includes
operating system, network and other configuration parameters.
Step 1
On the Toolbox, click the Create MAC-Specific Provisioning Role activity and drag it onto the
Workflow pane.
Figure 4-4
Step 2
Step 3
Create MAC-Specific Provisioning Role Properties—General Tab
On the General tab, enter the following information:
Field
Description
Display name
Name of the activity.
Type
Display only. Type of activity generated.
Description
Text description of the activity.
Click the Role Configuration tab.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
4-9
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Figure 4-5
Step 4
Create MAC-Specific Provisioning Role Properties—Role Configuration Tab
Complete the fields on the Role Configuration tab with the following information:
Field
Description
Unique system nickname
Specify a unique nickname for the new server to be
provisioned.
Provisioning role template
Specify the provisioning role template to be used.
Click the Browse
tool to select the template. See
Selecting Cisco Server Provisioner Object Names,
page 4-12.
You can also enter the template name in the text field or
use the reference tool.
Step 5
MAC address
Specify the MAC address of the new server to be
provisioned.
Enable provisioning upon network boot
Choose one of the following options to indicate the
action to be taken when the server is rebooted:
•
Ignore and boot from local disk
•
Live ubuntu
•
Provision on next boot then ignore
Click the Role Parameters tab.
Cisco TEO Adapter Guide for Cisco Server Provisioner
4-10
OL-24578-02
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Figure 4-6
Step 6
Create MAC-Specific Provisioning Role Properties—Role Parameters Tab
Complete the fields on the Role Parameters tab with the following information:
Field
Description
Host name
Specify the host name for the new server.
Domain name
Specify the name of the domain where the new server will
reside.
IP address
Specify the IP address for the new server.
Net mask
Specify the net mask for the new server.
Domain name server
Specify the name server of the domain where the new
server will reside.
Gateway
Specify the gateway address for the network.
Root password
Set the root password on the new server.
Confirm root password
Re-enter the password to confirm it.
Select time zone
Click this radio button and then choose the time zone
where the new server will reside from the drop-down list.
Time zone
Click this radio button and then enter or reference the time
zone where the new server will reside.
Force free the PXE event IP
Check the check box to force the release of the IP address
for the PXE event.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
4-11
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Step 7
Step 8
Complete the appropriate information in the following tabs:
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the process.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
Selecting Cisco Server Provisioner Object Names
Use the Select Cisco Server Provisioner Object Name dialog box to browse to the object and populate
the fields on the Cisco Server Provisioner activity properties.
Step 1
On the activity-specific property page, click the Browse
Figure 4-7
Step 2
Select Cisco Server Provisioner Object Name
On the Select Cisco Server Provisioner Object Name dialog box, choose the Cisco Server Provisioner
target from the drop-down list.
Note
Step 3
tool.
Click New > Cisco Server Provisioner to create a new target and choose it in the drop-down
list. See Creating Cisco Server Provisioner Targets, page 3-3 for instructions on creating targets.
In the Cisco Server Provisioner Object Names list box, select the object and click OK.
Cisco TEO Adapter Guide for Cisco Server Provisioner
4-12
OL-24578-02
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Viewing Create MAC-Specific Provisioning Role Activity Results
When the Create MAC-Specific Provisioning Role activity is executed, results are displayed in the
Operations workspace activity instance view.
Step 1
In the Operations workspace, expand the Activity Views folder and then click the view that represents
how the process was executed (for example, View Adhoc if the process was manually executed).
Step 2
In the View Results pane, expand the process, and double-click the activity instance or right-click and
choose Properties.
On the Create MAC-Specific Provisioning Role Instance Properties dialog box, the General tab displays
whether the provisioning role was successfully created.
Figure 4-8
Step 3
Create MAC-Specific Provisioning Role Instance Properties—General Tab
On the General tab, review the display-only information about the activity:
Field
Description
Display name
Name of the activity.
Type
Type of object.
Description
Text description of the activity.
Owner
User name of the person who owns the activity.
State
Current state of the activity (Succeeded or Failed)
Error
Description of the error that has occurred if the State field
displays Failed-Not Completed.
Start time
Date and time the activity started running.
End time
Date and time the activity completed.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
4-13
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Defining Delete MAC-Specific Imaging Profile Activity
Use the Delete MAC-Specific Imaging Profile activity to delete the properties in an imaging profile.
Step 1
On the Toolbox, click the Delete MAC-Specific Imaging Profile activity and drag it onto the Workflow
pane.
Figure 4-9
Step 2
Step 3
Delete MAC-Specific Imaging Profile Properties—General Tab
On the General tab, enter the following information:
Field
Description
Display name
Name of the activity.
Type
Display only. Type of activity generated.
Description
Text description of the activity.
Click the Profile tab.
Figure 4-10
Delete MAC-Specific Imaging Profile Properties—Profile Tab
Cisco TEO Adapter Guide for Cisco Server Provisioner
4-14
OL-24578-02
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Step 4
Click one of the following methods to specify the image profile to be deleted:
Field
Description
Unique profile name
Click this radio button to specify the profile name for the
imaging profile to be deleted.
Click the Browse
tool to specify the profile name. See
Selecting Cisco Server Provisioner Object Names,
page 4-12.
You can also enter the name in the text field or use the
reference tool.
MAC address
Click this radio button to specify the MAC address of the
server where the imaging profile is assigned.
Enter the MAC address or use the reference tool.
Step 5
Step 6
Complete the appropriate information in the following tabs:
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the process.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
Viewing Delete MAC-Specific Imaging Profile Activity Results
When the Delete MAC-Specific Imaging Profile activity is executed, results are displayed in the
Operations workspace activity instance view.
Step 1
In the Operations workspace, expand the Activity Views folder and then click the view that represents
how the process was executed (for example, View Adhoc if the process was manually executed).
Step 2
In the View Results pane, expand the process, and double-click the activity instance or right-click and
choose Properties.
On the Delete MAC-Specific Imaging Profile Properties dialog box, the General tab displays whether
the imaging profile was successfully deleted.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
4-15
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Figure 4-11
Step 3
Delete MAC-Specific Imaging Profile Instance Properties—General Tab
On the General tab, review the display-only information about the activity:
Field
Description
Display name
Name of the activity.
Type
Type of object.
Description
Text description of the activity.
Owner
User name of the person who owns the activity.
State
Current state of the activity (Succeeded or Failed)
Error
Description of the error that has occurred if the State
field displays Failed-Not Completed.
Start time
Date and time the activity started running.
End time
Date and time the activity completed.
Step 4
Click the Profile tab to view the activity definition. The fields on this page are display only.
Step 5
Click Close to close the dialog box.
Cisco TEO Adapter Guide for Cisco Server Provisioner
4-16
OL-24578-02
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Defining Delete MAC-Specific Provisioning Role Activity
Use the Delete MAC-Specific Provisioning Role activity to delete a provisioning role.
Step 1
On the Toolbox, click the Delete MAC-Specific Provisioning Role activity and drag it onto the
Workflow pane.
Figure 4-12
Step 2
Step 3
Delete MAC-Specific Provisioning Role Properties—General Tab
On the General tab, enter the following information:
Field
Description
Display name
Name of the activity.
Type
Display only. Type of activity generated.
Description
Text description of the activity.
Click the Role Configuration tab.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
4-17
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Figure 4-13
Step 4
Delete MAC-Specific Provisioning Role Properties—Role Configuration Tab
Click one of the following options to specify how to retrieve the provisioning role to be deleted:
Field
Description
Unique system nickname
Click this radio button to specify the system nickname
for the provisioning role to be deleted.
Click the Browse
tool to specify the system
nickname. See Selecting Cisco Server Provisioner
Object Names, page 4-12.
You can also enter the name in the text field or use the
reference tool.
MAC address
Click this radio button to specify the MAC address of
the provisioning role to be deleted.
Enter the MAC address or use the reference tool.
Step 5
Step 6
Complete the appropriate information in the following tabs:
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the process.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
Cisco TEO Adapter Guide for Cisco Server Provisioner
4-18
OL-24578-02
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Viewing Delete MAC-Specific Provisioning Role Activity Results
When the Delete MAC-Specific Provisioning Role activity is executed, results are displayed in the
Operations workspace activity instance view.
Step 1
In the Operations workspace, expand the Activity Views folder and then click the view that represents
how the process was executed (for example, View Adhoc if the process was manually executed).
Step 2
In the View Results pane, expand the process, and double-click the activity instance or right-click and
choose Properties.
On the Delete MAC-Specific Provisioning Role Properties dialog box, the General tab displays whether
the provisioning role was successfully deleted.
Figure 4-14
Step 3
Step 4
Delete MAC-Specific Provisioning Role Instance Properties—General Tab
On the General tab, review the display-only information about the activity:
Field
Description
Display name
Name of the activity.
Type
Type of object.
Description
Text description of the activity.
Owner
User name of the person who owns the activity.
State
Current state of the activity (Succeeded or Failed)
Error
Description of the error that has occurred if the State field
displays Failed-Not Completed.
Start time
Date and time the activity started running.
End time
Date and time the activity completed.
Click the Role Configuration tab to view the activity definition. The fields on this page are display only.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
4-19
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Step 5
Click Close to close the dialog box.
Defining Find MAC-Specific Imaging Profiles Activity
Use the Find MAC-Specific Imaging Profiles activity to retrieve a list of imaging profiles.
Step 1
On the Toolbox, click the Find MAC-Specific Imaging Profiles activity and drag it onto the Workflow
pane.
Figure 4-15
Step 2
Step 3
Find MAC-Specific Imaging Profiles Properties—General Tab
On the General tab, enter the following information:
Field
Description
Display name
Name of the activity.
Type
Display only. Type of activity generated.
Description
Text description of the activity.
Click the Profile tab.
Cisco TEO Adapter Guide for Cisco Server Provisioner
4-20
OL-24578-02
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Figure 4-16
Step 4
Find MAC-Specific Imaging Profiles Properties—Profile Tab
Click one of the following methods to specify the provisioning role to be deleted:
Field
Description
Unique profile name
Click this radio button to specify the profile name for the
imaging profile.
Click the Browse
tool to specify the profile name. See
Selecting Cisco Server Provisioner Object Names,
page 4-12.
You can also enter the name in the text field or use the
reference tool.
MAC address
Click this radio button to specify the MAC address of the
server where the imaging profile is assigned.
Enter the MAC address or use the reference tool.
Step 5
Step 6
Complete the appropriate information in the following tabs:
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the process.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
4-21
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Viewing Find MAC-Specific Imaging Profiles Activity Results
When the Find MAC-Specific Imaging Profiles activity is executed, results are displayed in the
Operations workspace activity instance view.
Step 1
In the Operations workspace, expand the Activity Views folder and then click the view that represents
how the process was executed (for example, View Adhoc if the process was manually executed).
Step 2
In the View Results pane, expand the process, and double-click the activity instance or right-click and
choose Properties.
On the Find MAC-Specific Imaging Profile Properties dialog box, the General tab displays whether the
activity successfully ran.
Figure 4-17
Step 3
Find MAC-Specific Imaging Profiles Instance Properties—General Tab
On the General tab, review the display-only information about the activity:
Field
Description
Display name
Name of the activity.
Type
Type of object.
Description
Text description of the activity.
Owner
User name of the person who owns the activity.
State
Current state of the activity (Succeeded or Failed)
Error
Description of the error that has occurred if the State
field displays Failed-Not Completed.
Start time
Date and time the activity started running.
End time
Date and time the activity completed.
Step 4
Click the Profile tab to view the activity definition. The fields on this page are display only.
Step 5
Click the Result Table tab to view a list of retrieved imaging profiles.
Cisco TEO Adapter Guide for Cisco Server Provisioner
4-22
OL-24578-02
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Figure 4-18
Step 6
Find MAC-Specific Imaging Profile Instance Properties—Result Table Tab
Click Close to close the dialog box.
Defining Find MAC-Specific Provisioning Roles Activity
Use the Find MAC-Specific Provisioning Roles activity to retrieve a list of provisioning roles.
Step 1
On the Toolbox, click the Find MAC-Specific Provisioning Roles activity and drag it onto the
Workflow pane.
Figure 4-19
Find MAC-Specific Provisioning Roles Properties—General Tab
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
4-23
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Step 2
Step 3
On the General tab, enter the following information:
Field
Description
Display name
Name of the activity.
Type
Display only. Type of activity generated.
Description
Text description of the activity.
Click the Role Configuration tab.
Figure 4-20
Step 4
Find MAC-Specific Provisioning Roles Properties—Role Configuration Tab
Click one of the following options to indicate how to retrieve the properties of the provisioning roles:
Field
Description
Unique system nickname
Click this radio button to retrieve the properties of a
provisioning role by specifying the system nickname.
Click the Browse
tool to specify the system
nickname. See Selecting Cisco Server Provisioner
Object Names, page 4-12.
Click the Insert Wildcard
wildcard.
tool to choose a
You can also enter the name in the text field or use the
reference tool.
MAC address
Click this radio button to retrieve the properties of a
provisioning role by specifying the MAC address.
Enter the MAC address or use the reference tool.
Click the Insert Wildcard
wildcard.
tool to choose a
Cisco TEO Adapter Guide for Cisco Server Provisioner
4-24
OL-24578-02
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Step 5
Step 6
Complete the appropriate information in the following tabs:
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the process.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
Viewing Find MAC-Specific Provisioning Roles Activity Results
When the Find MAC-Specific Provisioning Roles activity is executed, results are displayed in the
Operations workspace activity instance view.
Step 1
In the Operations workspace, expand the Activity Views folder and then click the view that represents
how the process was executed (for example, View Adhoc if the process was manually executed).
Step 2
In the View Results pane, expand the process, and double-click the activity instance or right-click and
choose Properties.
On the Find MAC-Specific Provisioning Roles Properties dialog box, the General tab displays whether
the activity successfully ran.
Figure 4-21
Find MAC-Specific Provisioning Roles Instance Properties—General Tab
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
4-25
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Step 3
On the General tab, review the display-only information about the activity:
Field
Description
Display name
Name of the activity.
Type
Type of object.
Description
Text description of the activity.
Owner
User name of the person who owns the activity.
State
Current state of the activity (Succeeded or Failed)
Error
Description of the error that has occurred if the State
field displays Failed-Not Completed.
Start time
Date and time the activity started running.
End time
Date and time the activity completed.
Step 4
Click the Role Configuration tab to view the activity definition. The fields on this page are display only.
Step 5
Click the Result Table tab to view a list of retrieved provisioning roles.
Figure 4-22
Step 6
Find MAC-Specific Provisioning Roles Instance Properties—Result Table Tab
Click Close to close the dialog box.
Cisco TEO Adapter Guide for Cisco Server Provisioner
4-26
OL-24578-02
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Defining Find Provisioning Role Templates Activity
Use the Find Provisioning Role Templates activity to retrieve a list of provisioning role templates.
Step 1
On the Toolbox, click the Find Provisioning Role Templates activity and drag it onto the Workflow
pane.
Figure 4-23
Step 2
Step 3
Find Provisioning Role Templates Properties—General Tab
On the General tab, enter the following information:
Field
Description
Display name
Name of the activity.
Type
Display only. Type of activity generated.
Description
Text description of the activity.
Click the Template tab.
Figure 4-24
Find Provisioning Role Templates Properties—Template Tab
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
4-27
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Step 4
Specify the template name for the template to be retrieved. Enter the name or use the reference tool to
reference another property in the process. You can also click the Insert Wildcard
tool to choose a
wildcard.
Step 5
Complete the appropriate information in the following tabs:
Step 6
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the process.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
Viewing Find Provisioning Role Templates Activity Results
When the Find Provisioning Role Templates activity is executed, results are displayed in the Operations
workspace activity instance view.
Step 1
In the Operations workspace, expand the Activity Views folder and then click the view that represents
how the process was executed (for example, View Adhoc if the process was manually executed).
Step 2
In the View Results pane, expand the process, and double-click the activity instance or right-click and
choose Properties.
On the Find Provisioning Role Templates Properties dialog box, the General tab displays whether the
activity successfully ran.
Figure 4-25
Find Provisioning Role Templates Instance Properties—General Tab
Cisco TEO Adapter Guide for Cisco Server Provisioner
4-28
OL-24578-02
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Step 3
On the General tab, review the display-only information about the activity:
Field
Description
Display name
Name of the activity.
Type
Type of object.
Description
Text description of the activity.
Owner
User name of the person who owns the activity.
State
Current state of the activity (Succeeded or Failed)
Error
Description of the error that has occurred if the State field
displays Failed-Not Completed.
Start time
Date and time the activity started running.
End time
Date and time the activity completed.
Step 4
Click the Template tab to view the activity definition. The fields on this page are display only.
Step 5
Click the Result Table tab to view a list of retrieved provisioning role templates.
Figure 4-26
Step 6
Find Provisioning Role Templates Instance Properties—Result Table Tab
Click Close to close the dialog box.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
4-29
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Defining Update MAC-Specific Imaging Profile Activity
Use the Update MAC-Specific Imaging Profile activity to change the properties in an imaging profile.
Step 1
On the Toolbox, click the Update MAC-Specific Imaging Profile activity and drag it onto the Workflow
pane.
Figure 4-27
Step 2
Step 3
Update MAC-Specific Imaging Profile Properties—General Tab
On the General tab, enter the following information:
Field
Description
Display name
Name of the activity.
Type
Display only. Type of activity generated.
Description
Text description of the activity.
Click the Profile tab.
Cisco TEO Adapter Guide for Cisco Server Provisioner
4-30
OL-24578-02
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Figure 4-28
Step 4
Update MAC-Specific Imaging Profile Properties—Profile Tab
Specify the following information for the imaging profile to be updated:
Field
Description
Imaging profile criteria:
Click one of the following options to specify how to
retrieve the imaging profile:
Unique profile name
Click this radio button to specify the profile name for the
imaging profile.
Click the Browse
tool to specify the profile name. See
Selecting Cisco Server Provisioner Object Names,
page 4-12.
You can also enter the name in the text field or use the
reference tool.
MAC address
Click this radio button to specify the MAC address of the
server where the imaging profile is assigned.
Enter the MAC address or use the reference tool.
New unique profile name
Specify a new unique profile name for the imaging profile.
New MAC address
Specify the new MAC address of the server where the
image will be assigned.
Disk image snapshot directory name
Specify the directory name where the disk image is to be
created.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
4-31
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Field
Description
Drive type and letter(s)
Specify the type of disk drive where your master boot
record is located (for example, sda, sdb, sdc for SATA,
HDS, HDB, HDC).
Note
Backup parameters
Specify the parameters to be used for backing up the
imaging profile.
Restore parameters
Specify the parameters to be used for restoring the image
profile.
Imaging action upon network boot
Choose one of the following options to indicate the
imaging action to be taken when the network is rebooted:
Force free the PXE event IP
Note
Step 5
Step 6
For Windows file systems C:\, choose SDA disk
type.
•
Backup
•
Restore
•
No imaging action
Check the check box to force the release of the IP address
for the PXE event.
For the Backup and Restore parameters, the following notes apply:
•
Backup Parameter -q2 invokes part-clone overriding the default part-image; part-clone is required
for ESX and other file system types e.g. Ext4 and ReiserFS.
•
Backup and Restore Parameters -j1 and -j2 handle MBR processing to support restore to disks not
preformatted to match the backup file type. These may be required for Windows 2008 Server, ESX,
Ubuntu, and Debian.
•
Backup Parameter -sc Skip file system type checking, use for ESX, ESXi or whenever the message
"Broken partition images" appears on the client due to "dd" type partitions being backed up and
checked. The image checking after saving is turned on by default.
Complete the appropriate information in the following tabs:
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the process.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
Cisco TEO Adapter Guide for Cisco Server Provisioner
4-32
OL-24578-02
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Viewing Update MAC-Specific Imaging Profile Activity Results
When the Update MAC-Specific Imaging Profile activity is executed, results are displayed in the
Operations workspace activity instance view.
Step 1
In the Operations workspace, expand the Activity Views folder and then click the view that represents
how the process was executed (for example, View Adhoc if the process was manually executed).
Step 2
In the View Results pane, expand the process, and double-click the activity instance or right-click and
choose Properties.
On the Update MAC-Specific Imaging Profile Properties dialog box, the General tab displays whether
the imaging profile was successfully updated.
Figure 4-29
Step 3
Update MAC-Specific Imaging Profile Instance Properties—General Tab
On the General tab, review the display-only information about the activity:
Field
Description
Display name
Name of the activity.
Type
Type of object.
Description
Text description of the activity.
Owner
User name of the person who owns the activity.
State
Current state of the activity (Succeeded or Failed)
Error
Description of the error that has occurred if the State field
displays Failed-Not Completed.
Start time
Date and time the activity started running.
End time
Date and time the activity completed.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
4-33
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Step 4
Click the Profile tab to view the activity definition. The fields on this page are display only.
Step 5
Click Close to close the dialog box.
Defining Update MAC-Specific Provisioning Role Activity
Use the Update MAC-Specific Provisioning Role activity to change the properties of a provisioning role.
Step 1
On the Toolbox, click the Update MAC-Specific Provisioning Role activity and drag it onto the
Workflow pane.
Figure 4-30
Step 2
Step 3
Update MAC-Specific Provisioning Role Properties—General Tab
On the General tab, enter the following information:
Field
Description
Display name
Name of the activity.
Type
Display only. Type of activity generated.
Description
Text description of the activity.
Click the Role Configuration tab.
Cisco TEO Adapter Guide for Cisco Server Provisioner
4-34
OL-24578-02
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Figure 4-31
Step 4
Update MAC-Specific Provisioning Role Properties—Role Configuration Tab
Specify the following information for the provisioning role to be updated:
Field
Description
Provisioning role criteria:
Click one of the following options to specify how to
retrieve the provisioning role:
Unique system nickname
Click this radio button to specify the system nickname of
the provisioning role to be updated.
Click the Browse
tool to browse a list of system
nicknames available from a specific target. See Selecting
Cisco Server Provisioner Object Names, page 4-12.
You can also enter the name in the text field or use the
reference tool.
MAC address
Click this radio button to specify the MAC address of the
provisioning role to be updated.
Enter the MAC address or use the reference tool.
Properties to update
List of properties to be modified.
1.
Choose the name of the property to be modified from
the Property name drop-down list.
2.
Specify the new value for the property in the Property
value text field.
3.
Click Add to List.
If you want to remove a property that has been added to the
list, select it and click Remove.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
4-35
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Step 5
Step 6
Complete the appropriate information in the following tabs:
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the process.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
Viewing Update MAC-Specific Provisioning Role Activity Results
When the Update MAC-Specific Provisioning Role activity is executed, results are displayed in the
Operations workspace activity instance view.
Step 1
In the Operations workspace, expand the Activity Views folder and then click the view that represents
how the process was executed (for example, View Adhoc if the process was manually executed).
Step 2
In the View Results pane, expand the process, and double-click the activity instance or right-click and
choose Properties.
On the Update MAC-Specific Provisioning Role Properties dialog box, the General tab displays whether
the activity successfully ran.
Figure 4-32
Update MAC-Specific Provisioning Role Instance Properties—General Tab
Cisco TEO Adapter Guide for Cisco Server Provisioner
4-36
OL-24578-02
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Step 3
On the General tab, review the display-only information about the activity:
Field
Description
Display name
Name of the activity.
Type
Type of object.
Description
Text description of the activity.
Owner
User name of the person who owns the activity.
State
Current state of the activity (Succeeded or Failed)
Error
Description of the error that has occurred if the State field
displays Failed-Not Completed.
Start time
Date and time the activity started running.
End time
Date and time the activity completed.
Step 4
Click the Role Configuration tab to view the activity definition. The fields on this page are display only.
Step 5
Click Close to close the dialog box.
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
4-37
Chapter 4
Using the Cisco Server Provisioner Activities
Defining Cisco Server Provisioner Activities
Cisco TEO Adapter Guide for Cisco Server Provisioner
4-38
OL-24578-02
INDEX
deleting
A
history
about
Cisco Server Provisioner activities
4-1
accessing
Runtime Users view
Targets view
1-2
2-1
2-4
properties
2-2
2-5
Create MAC-Specific Imaging Profile properties
4-5
Create MAC-Specific Provisioning Role properties
4-9
3-1
activities
Cisco Server Provisioner
D
4-1
adapter
defining
accessing Cisco Server Provisioner Adapter
properties 1-2
adapter-supported objects
history
2-6
managing
Used by
Cisco Server Provisioner Adapter properties
2-8
Create MAC-Specific Imaging Profile activity
4-5
Create MAC-Specific Provisioning Role activity
1-4
Delete MAC-Specific Imaging Profile activity
1-5
4-9
4-14
Delete MAC-Specific Provisioning Role activity
Find MAC-Specific Imaging Profile activity
4-20
Find MAC-Specific Provisioning Role activity
C
Find Provisioning Role Templates activity
Cisco Server Provisioner activities
4-5
Create MAC-Specific Provisioning Role
Delete MAC-Specific Imaging Profile
4-27
4-14
Find MAC-Specific Imaging Profile
4-17
4-20
Find MAC-Specific Provisioning Role
Delete MAC-Specific Imaging Profile properties
Delete MAC-Specific Imaging Profile results
Update MAC-Specific Provisioning Role
4-17
deleting
4-27
Update MAC-Specific Imaging Profile
4-14
4-15
Delete MAC-Specific Provisioning Role properties
4-23
4-30
Update MAC-Specific Provisioning Role
activity 4-34
4-9
Delete MAC-Specific Provisioning Role
Find Provisioning Role Templates
4-23
Update MAC-Specific Imaging Profile activity
Create MAC-Specific Imaging Profile
4-17
Cisco Server Provisioner targets
4-30
Cisco Server Provisioner User
3-6
2-8
4-34
Cisco Server Provisioner targets
accessing
enabling
managing
3-1
3-5, 3-6
E
enabling Cisco Server Provisioner target
3-5, 3-6
3-5
Cisco Server Provisioner User
Cisco TEO Adapter Guide for Cisco Server Provisioner
OL-24578-02
IN-1
Index
F
S
Find MAC-Specific Imaging Profile properties
Find MAC-Specific Imaging Profile results
4-20
managed objects
4-22
Find MAC-Specific Provisioning Role properties
Find MAC-Specific Provisioning Role results
Find Provisioning Role Tempate results
selecting
4-24
4-25
4-28
Find Provisioning Role Templates properties
4-27
T
targets
M
deleting
3-6
history
3-13
Used by
managed objects, selecting
3-11, 3-12
4-12
managing
Cisco Server Provisioner targets
U
3-5
Cisco Server Provisioner Users
modify definition
4-12
Update MAC-Specific Imaging Profile properties
2-4
Update MAC-Specific Imaging Profile results
Cisco Server Provisioner Users, about
2-4
Cisco Server Provisioner Users, deleting
2-8
Update MAC-Specific Provisioning Role results
V
properties
viewing
Cisco Server Provisioner User
3-8
adapter history
2-2
4-5
Create MAC-Specific Provisioning Role
Delete MAC-Specific Imaging Profile
4-14
Delete MAC-Specific Provisioning Role
Find MAC-Specific Imaging Profile
4-20
Find MAC-Specific Provisioning Role
Find Provisioning Role Templates
4-17
4-27
Update MAC-Specific Provisioning Role
objects using target
3-11, 3-12
3-13
Create MAC-Specific Imaging Profile results
Create MAC-Specific Provisioning Role results
4-30
4-34
Delete MAC-Specific Imaging Profile
R
4-13
4-15
4-22
Find MAC-Specific Provisioning Role
2-1
4-7
Delete MAC-Specific Provisioning Delete
MAC-Specific Provisioning Role results 4-19
Find MAC-Specific Imaging Profile
Runtime Users view, accessing
2-5
viewing activity results
4-24
Update MAC-Specific Imaging Profile
2-6
objects using Cisco Server Provisioner User
target history
4-36
1-4
Cisco Server Provisioner User history
4-9
4-34
1-5
adapter-supported objects
Create MAC-Specific Imaging Profile
4-33
Update MAC-Specific Provisioning Role properties
P
Cisco Server Provisioner target
4-30
Find Provisioning Role Templates
4-25
4-28
Update MAC-Specific Imaging Profile
Update MAC-Specific Provisioning Role
4-33
4-36
Cisco TEO Adapter Guide for Cisco Server Provisioner
IN-2
OL-24578-02