The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
Cisco Prime Service Catalog software is a self-service portal for you to order and manage any type of IT services, from the data center to desktop. You can also order infrastructure as a service such as virtual machines, fenced containers, and VACS (if UCSD is integrated), and use service catalog for lifecycle management of these entities. For details on how to place and manage these orders, see Placing Order for Services and Managing Order.
Using Service Catalog is much like shopping on a typical web site where you browse through a catalog, add items to your shopping cart, and then check out.
In Service Catalog, your shopping cart is referred to as a requisition or order. When you submit a requisition, Service Catalog provides you with a requisition number you can use to track the progress and status of your order.
For the most part, what happens to your requisition after you submit it is transparent to you. For example, your requisition may require several levels of approval. But from your perspective, there is nothing more you need to do.
Navigate through a catalog of services. See Browsing Services
Order a service for yourself. See Ordering Services.
Order a service on behalf of someone else. See Ordering For Others.
Track your requisitions. See Tracking Order.
Cancel a requisition or a service. See Cancelling an Order.
View Service Items and associated services. See Viewing My Stuff.
Update your Profile information. See Setting Up Your Profile.
You can also perform these operations from the Service Catalog module. By default, Service Catalog module is enabled as the home module for end users, from Administration > Setting > Service Catalog module. For more information on how to use Service Catalog module, see Placing Order for Services.
The Service Catalog module is an end-user module that provides users with a shopping cart experience similar to an e-Commerce website. This module can be enabled to replace the My Services module. For more information about replacing the My Services module with Service Catalog, see the Common Settings table in Prime Service Catalog 12.0 Administration and Operation Guide. When you enable Service Catalog, My Services is replaced by Order Management, Service Catalog, and My Products & Services modules.
Note | If you have upgraded to Cisco Prime Service Catalog11.0, you will find Service Catalog replaces My Services. |
You can choose to enable the Service Catalog module by changing the Settings on the Administration module. When you enable the Service Catalog module and login in again, My Services module is disabled. However the following modules are enabled:
Service Catalog: The Service Catalog module provides a shopping cart experience to a user. The user can navigate through Service Items and Order On Behalf in this module.
Order Management: Order Management module enables the remaining features of My Services module such as Requisitions, Copy Requisitions, and Authorizations.
If you are logging in to the Service Catalog Module for the first time, you may see an empty home page with just the Manage Your Stuff tab in the heros band, unless the home page is configured in the Service Designer module. Most customers may see the Order On Behalf content starting with the virtual appliance. A service designer designs the home page that includes the display of categories and their hierarchy, search options, and so on.
The attributes that you configure in the Service Designer > Extensions component is automatically displayed in the Extensions tab of the Services component for all services. You can further define values for each extension and then save the configuration. For more information, see Cisco Prime Service Catalog Designer Guide.
Service Catalog page may allow you to order a service for another user, if the admin has given you the permission. For more information on how to order for others, see Ordering For Others.
If you do not see the login page while logging in, that implies that the administrator might have set up single sign-on and have given you direct access to the service catalog, once you have logged into the corporate SSO server.
Note | Cookies must be enabled on your web browser in order to use this product. |
To log on to Service Catalog:
Note | You can change your default login module when you set up your profile. For more information on setting up your profile, see Setting Up Your Profile. |
On the login page, you have two options to update your password - the Change Password, and Forgot Password options. The new password is effective from the subsequent login onwards. If you forget the password, click Forgot Password and the change password link is sent to your registered email id. You can create your own password or automatically generate password using the Generate Password option.
Note | If you are unable to reset your password, contact your system administrator. |
To reset your password on the application login page
Step 1 | Click Change Password. |
Step 2 | Enter your current password in the Current Password text box. |
Step 3 | Click Generate Password to create a system generated password. The New password and Confirm password fields are automatically populated with the new credentials. |
Step 4 | Alternatively, enter a new password in the New Password text box that adheres to the password policies. |
Step 5 | Reenter the new password in Confirm Password text box. |
Step 6 | Click
Save.
Make a note of the username and password that you create. You will need these to log in. |
Your user profile contains your user information, preferences, calendar information, and access privileges across the application. You can change your user profile at any time.
You must provide information for every field marked as required (*).
Your user information is used by the system, and by the service performers who provide services to you, to ensure that you receive requested services as efficiently as possible.
You can create your own password or opt for a system generated password:-
Click Generate Password to create a system generated password. The New password and Confirm password fields are automatically populated with the new credentials.
Create your own password; enter a password in both the New Password and Confirm Password text boxes.
Note | If you change your password, you are automatically logged out from the system. A popup window appears, prompting you to log in using the new password. |
Make a note of the username and password that you create. You will need these to log in.
Enter your credentials against first name and last name.
Enter your preferred time zone.
Information such as work phone, work fax, personal address, city, country, building or cubicle are optional and provides detailed description for a user.
By default, only US English is available in the Preferred Language drop-down list. Other languages can be made available by adding them to the Language List in the Administration module. See the Cisco Prime Service Catalog 12.0 Designer Guide for more information. In Prime Service Catalog 12.0, the admin can enter translations and enable additional languages for end users.
The Privileges option displays the currently granted privileges for your user account.
Note | You cannot modify the privileges assigned to you. |
Only site administrators have access to all the roles and the privileges. For more information on the roles and privileges that a user can have, see Roles section of Cisco Prime Service Catalog 12.0 Administration and Operations Guide.
Users who have purchased services can rate and post feedback for the services on My Products & Services, and also edit the submitted feedbacks.
Note | A user can rate the purchased service only once. |
All users can:
An inactive and non-orderable service cannot be rated.
Note | Only users with a site administrator role can delete the submitted feedbacks. |
When you log into Prime Service Catalog, it displays the Summary of the Cloud applications and resources on the dashboard. Dashboards display at-a-glance information about the most important data in your cloud network— status and alerts, performance and reporting information. A quick scan of a dashboard lets you know if anything needs attention.
Dashlets are the sub-areas that provide metrics using graphs and text. Prime Service Catalog provides a variety of dashlets that can provide you with information about active deployments, active servers, hours of use, cost, recent orders, and performance reports.
Note | The dashlets Active Deployments, Active servers, Total Cost, and Total hours are hidden for the Site Admin and Service Admin. |
The main menu is available on the service catalog module which allows you to navigate to other areas and modules within Prime Service Catalog GUI. Click the icon at the top-right corner to view options to order services, view the team information and pending approvals, and perform actions on the deployed applications, servers and VDCs, generate reports and view order history. You can also navigate to other modules from the Advanced Configurations tab.
Click the + plus icon to expand My Products & Services menu that contains the following options:
The table below table lists and defines the key terms used in this document.
Term | Definition |
---|---|
Customer |
Person receiving a service. You can be the customer of services you order for yourself, and for services that others order for you. |
Initiator |
Person who places the order for a service. You are the initiator of orders you place for yourself, and orders you place for others. |
Expected Duration |
Duration of time within which a task should be completed. |
Standard Duration |
Duration of time, usually in business days, within which the service team has committed to deliver this service after any required authorizations have been completed. |
Performer |
An individual or user or queue assigned to complete the task. |
Service Group | A folder containing similar services, grouped to facilitate and organize the service design process. Service Groups are not visible to customers. |
Available Work | The area in Service Manager where a Service Team member can access tasks that have been assigned to a Queue. (The team member must have been assigned rights to draw work from that Queue.) |
My Work | The area in Prime Service Catalog where service team members access all tasks assigned to them. |
My Late Work | A Service Manager view that displays Ongoing tasks assigned to you that have not been completed by the due date. |
Work Forecasts | A Service Manager view that displays new tasks assigned to you. These tasks have not yet started-they are not yet Ongoing. |
Personalized View | Collection of search filters and other settings you choose using filter and search, and then save to be reused any time you return to Service Manager. |
Task | An activity performed to support the delivery of a service. |
Requisition | A template for service orders. A person submitting a requisition can request multiple services at the same time, such as a new computer, a software upgrade, and access to the company's financial software-or just a single service. A requisition is usually generated from Service Catalog or My Services module. |
Historical Requisition | This requisition provides overall application performance improvement as a result of reducing the amount of data in the current transaction tables. It is controlled by the system setting 'Enable Historical Requisitions Scheduler' in the Administration module. When it is enabled, requisitions that have been completed for more than 365 days are migrated by a background process to the historical transaction tables. |
Unsubmitted Requisition | Requisition that is still in preparation. You can add or delete services, edit service order forms, or entirely cancel an unsubmitted requisition. |
Authorization | Process performed by a designated individual of evaluating, and then approving or rejecting a service request. Lack of authorization stops the service delivery process. |
Permissions | Rights (as assigned) at the site and organizational unit level
to perform
Request Center tasks. Rights can be assigned to people,
functional positions, or organizational Units to edit data and perform various
functions in Prime Service Catalog.
For example, a user could have permission to access Service Manager and Service Catalog, but might not have permission to access Service Designer and Organization Designer. |
Service Manager |
A Prime Service Catalog module which is used by the service teams to find and manage their Service Catalog tasks. |
Review | Process of making sure that a request for service or product is feasible. Normally, a service team member or manager completes reviews. |
Delivery Plan | The workflow process established by Prime Service Catalog administrators to complete a service order after it has passed through the authorization and/or review stages. |
Standard Duration | Amount of time, usually in business days, within which the service team has committed to deliver this service after any required authorizations have been completed. |
Business Unit | Group in your organization, such as a department. Business Units are one type of Organizational Unit (OU) in Prime Service Catalog. |
Service Order | Request for a service, supply, or equipment. |
The Browse Services page appears when you click a service category in Service Catalog module, and it displays the subcategories and services within that category.
To browse services:
Step 1 | On your Service Catalog home page, select a category name or its icon from the Browse Categories drop-down. Service Catalog displays the subcategories and services in that category in the Browse Services page. |
Step 2 | If there are additional subcategories within a category, continue to click through each subcategory until you locate the service you want. |
Step 3 | When you have located the service you want: |
The first step in the service order process is to locate the particular service you need. You search for a service that you wish to order using Service Catalog.
To search for services:
Step 1 | On the Service
Catalog page, click the
search icon and enter a word or phrase into the search box and
press
Enter.
| ||||||||||
Step 2 | Press Enter. Service Catalog displays an alphabetical list of services that match your search criteria. | ||||||||||
Step 3 | When you have located the service you want: |
The service details page displays all the information you need about a service to help you determine its appropriateness for your particular requirements.
To view the service details page of a service, click the service name link for a service. The service details page displays the Service Overview.
After you review the service details, you can:
Click Order to add the service to your cart.
OR
Note | If you view the details of an included service that is part of a bundle, you cannot individually order the included service. The Order button does not appear. Instead, click Return to Service Bundle to view detailed information for the parent service. |
The service overview provides a description of the service, along with summary information about pricing and service delivery.
Standard Duration | Duration of time, usually in business days, within which the service team has committed to deliver this service, after any required authorizations have been completed. |
Service Level Description |
Description of the service. |
Price |
Price, if any, for this service. |
Price Type |
Type of pricing-such as Fixed pricing or Time & Materials-for this service. |
Price Description |
Brief description or explanation of the pricing for the service. |
Once you have located the service you want to order:
Click Order.
The next step in the service order process is to complete the order form.
Complete the Order Form.
Mandatory fields on the Order Form are indicated by a red asterisk (*).
The information that you provide in the order form is used by reviewers, authorizers, and service performers during the services delivery process. It is important that you provide complete and accurate information. Whenever possible, Service Catalog will prefill information about you from your profile. For more information on setting up your profile, see Setting Up Your Profile.
Once you complete the order form, click Add to Cart.
If you are only ordering one service, click Place Order in the My Cart page to order the service immediately and conclude the order process.
You can add additional services to the requisition now, or at a later time, and then place order when you have added all the services you need. To track your ordered service, see Tracking Order.
Using the Prime Service Catalog web interface, you can order VMs and infrastructure resources in private and hybrid cloud after integrating with UCS Director. You can also order Cisco Virtual Application Container Services (VACS) to automate the provisioning of virtual private data centers and deploy applications faster with compliant, highly secure containers.
Depending on the type of infrastructure resources ordered, Prime Service Catalog routes the provisioning of these entities to UCSD or VACS, for example: the private VM operations are routed to UCS Director.
Prime Service Catalog creates service item entries for each of these imported entities from VACS and UCSD. When the provisioning is completed, Prime Service Catalog updates the attributes for these entities and their statuses in the My Products & Services > Service Items page. After these entities are available in the My Products & Services page, you can perform lifecycle operations on these entities from this page. All the active virtual machines from VACS and UCSD can also be managed in My Products & Services > My Servers page. For more details on these lifecycle operations, see Post-Provisioning Operations of UCSD and on managing active servers, see Managing Servers. After these services are ordered, you can track the status of provisioning and also the status of the post-provisioning operations for these entities in My Products & Services > Orders > Order History page.
Prime Service Catalog provides the following capabilities for the UCSD entities:
When the tenant, VDC, virtual machine, or load balancer creation process fails on the UCS Director, you can request for the latest data from the UCS Director using the refresh functionality.
New Refresh Functionalities |
Prime Service Catalog Web Interface Pages |
Synchronizes |
---|---|---|
Tenant Refresh |
Tenant Management > Tenant Dashboard |
Status |
VDC Refresh |
Service Catalog > My Products & Services > Virtual Data Centers |
Status and Entities like VMs, Load Balancer |
VM Refresh |
Status |
|
Load Balancer Service Refresh |
Service Catalog > My Products & Services > Virtual Data Centers |
Status |
If the Prime Service Catalog request fails on the UCSD, the Refresh icon gets enabled on the above pages. After the refresh, the current status from UCSD is reflected in Prime Service Catalog.
Note | APIC-Container VM refresh is possible only when a VM is in FAILED status. Refresh request fails with an error message "Refresh Failed:VM needs to be in Failed Status" when any one of the VM in a container is in any other status such as: Inactive, Being Provisioned, Being Deleted etc. |
For more information on creating Tenants, see Creating Organizations and Users.
For more information on creating VDCs, see Adding Virtual Data Center.
For more information on VACS virtual machines, see Managing Virtual Data Center.
As a service designer, you can attach a sych task plugin workflow type to an Advance Catalog Service to synchronize virtual machine detail from UCSD. This workflow type can be used if an Advance Catalog is used to provision a virtual machine.
After these services are defined, a user can order these services to provision a virtual machine from an Advance Catalog and can also track the VM details on Prime Service Catalog My Products & Services web interface.
Replenish the quota for a tenant using the UCSD Tenant Error Remediation service. This service is available out of the box.
As a System Administrator, when you create a Tenant, you can update the Quota details. If the process of creating a tenant fails and the tenant quota is not available, you can call UCSD Tenant Error Remediation service. The request goes to UCSD and syncs back all the data to Prime Service Catalog. The Quota values are overwritten to zero.
The Restoring VDC and UCSD Container Information functionality allows you to sync the VDC information from UCS Director to Prime Service Catalog and replenish the container details. If the VDC creation process fails, you can restore the VDC by using the UCSD Container Error Remediation service. Order this remediation service to retrieve the data services that were lost during the VDC creation process.
The Sync Tenant Information functionality syncs the tenant resource limit details from the UCS Director to the Prime Service Catalog. This service is used to replenish the Tenant Quota resource (used, available and reserved) limits. When you order a UCSD Refresh Tenant Resource Limit services, it automatically syncs the tenant resource limit details from the UCS Director to the Prime Service Catalog and only the Quota detail is refreshed.
Prime Service Catalog when integrated with UCS Director can be used for private cloud management. The lifecycle operations on a private VM are routed to UCS Director. These operations on the VMs are available from the My Products & Services page in the Service Catalog module. Role-based access permissions to perform these operations are assigned at the group level by an administrator.
Note | For a Fenced Containers, you cannot delete application templates from My Products & Services. To remove an application template, remove the application template entry from the Service Item Manager and then delete the corresponding application template from the Stack Designer web interface. |
Prime Service Catalog supports the below listed out-of-the-box operations. Some of these operations that can be invoked on these virtual machines are a 1-click operation. 1-click operation do not require any input data from the user, for example, “Power Off Virtual Machine”.
Note | Out-of-box operations marked with asterisk(*) does not support one-click operations. |
For VMs (Private Cloud):
For UCSD Fenced container:
For VACS-bound VMs (CSR, VSG, or ASAv):
Note | These options are available only for VACS Container service item type. Navigate to Service Catalog > My Products & Services > Service Items > VACS Containers. These operations can be performed under Actions listed for a VACS Container Service Item type. |
Note | Configure Static NAT enables static NAT on the virtual machines in a VACS container. When static NAT is enabled, public IP is generated by VACS environment and you can use the IP address assigned to a VM. Click on this option to display a list of VMs under the selected container and from the Static NAT drop down to enable the NAT for the selected virtual machine in the container. To view the VMs inside VACS containers with Static NAT, navigate to My Products & Services > Service Items > VACS Containers. Select a VACS container and click on the VACS Container display name. The details of NAT will be displayed under the Static NAT tab. |
Virtual Data Center:
Note | For more information on the VDC operations, see Virtual Data Centers. |
Physical Server
Create/Delete VM Disk operation is supported on Prime Service Catalog and UCSD 5.5.0.1 onwards.
Step 1 | Create VDC from Prime Service Catalog. |
Step 2 | Add a VM on VDC using the appropriate template. For more information see Managing Virtual Data Center. |
Step 3 | Create VM disk.
|
Add vNIC to VM option is supported only for Standard Catalog VM and APIC-container VM. For APIC-container VM, Add vNIC operation works only with isolated network. As a pre-requisite, the tenant administrator must manually configure isolated network for the APIC container in UCSD before creating VM.
Note | Add vNIC operation is supported on Prime Service Catalog and UCSD 5.5.0.1 onwards. |
Configure isolated network for the Create VDC advanced catalog in UCSD. To add isolated network in UCSD do the following:
Caution | The below steps are applicable for UCSD 5.5.0.1, refer to the latest Cisco UCS Director Administration Guide for updated accurate procedure. |
Log in to UCSD and choose Policies > Application Containers.
Select the Container on which the Isolated Network must be added.
Click Add Tier/Network.
In the Add Container Tier/Network window, enter the required fields and check the Isolate Network option.
Select the tier on which the isolated network must be configured from the Parent Tier drop-down list.
Click Submit.
Step 1 | Create VDC from Prime Service Catalog. |
Step 2 | Add a VM on VDC to the corresponding tier for which the isolated network has been configured in UCSD using the appropriate template. For more information see Managing Virtual Data Center. |
Step 3 | Add vNIC to the
VM.
|
As a User you can deploy the application services from My Products & Services. Go to Deployments > New Deployment.. Only those applications for which you have been granted permission to deploy are available in this page.
After these services are ordered, you can track the status of deployment of the application in My Products & Services > Order page. When the provisioning is completed, Prime Service Catalog updates the attributes for these applications and their statuses can be viewed in the My Products & Services > Deployments page.
Much like a "shopping cart" on a typical web site, you can place service orders in a requisition to be submitted at a later time.
When you click Add to Cart during the service order process, Service Catalog creates an unsubmitted requisition.
You can add or delete services, edit Service Order forms, or entirely cancel an unsubmitted requisition.
This requisition remains unsubmitted until you either place the order or cancel it.
You may not have more than one unsubmitted requisition. Therefore, Service Catalog places your service requests in an unsubmitted requisition before creating a new requisition.
Note | If you are designated to order services on behalf of others or even if you order for yourself, only one unsubmitted requisition is allowed at any point of time. |
Note | You can only make changes to an unsubmitted requisition. Once submitted, an order can only be cancelled. |
Use the up-down arrow to select the quantity of the service or product ordered. Cost per unit for each service is displayed next to the service selection and the total cost for order is displayed in the Order Confirmation area.
Once you successfully order a service, My Cart page displays your services and products you have ordered.
If you want to edit the services before placing on order, see Editing an Unsubmitted Requisition. Once you finish making your changes, click Place Order.
If you do not wish to submit the order, click Update Cart and Service Catalog saves your work that you can edit and submit at a later time.
Note | If Order For Others does not appear in Service Catalog, you are not authorized to order services for others. |
The process you use for ordering services on behalf of another person is very similar to the process you use when ordering services for yourself. After you choose the person for whom you are ordering and the business unit to which it should be billed, the process steps are identical.
When you order a service on behalf of another, you are the Initiator of that requisition or order.
The person for whom you order the service is the Customer.
Note | You can also use the Copy on Behalf feature to order services for others. |
To order a service on behalf of another person:
Step 1 | From Service Catalog, navigate to the service using the Browse Categories tab or the Search icon on the home page. |
Step 2 | Select the required service and click Order For Others. |
Step 3 | In the Search for Recipient pop up window, enter all or part of the person's name for whom you are ordering, and click the Search icon. |
Step 4 | Choose the person's name from the list, and then click Add Selected Recipient. |
Step 5 | Enter the required details in the Service Designer module, if you get a service form depending on the ordering mode you configured or click Add to Cart. |
Step 6 | In the My Cart page, review the details of the selected service and click Place Order. |
Managing orders involve viewing service items and order status, tracking and cancelling orders, and so on.
Use the Service Items tab to view your service items and associated services. My Products & Services page displays a service item view that enables you to see the service items that have been provisioned for you and to request further changes and additions to these items.
To view all the service items provisioned for you:
Step 1 | Go to
Service
Catalog > My Products & Services > Service Items.
| ||||||||||||
Step 2 | Choose the
desired service item and view its associated information by clicking the
Additional Information, History, Requested With, and Ownership tabs:
|
You can quickly sort the information on the My Products & Services page to help you locate a particular service item. You can also export the Service Item results to a Microsoft® Excel® file.
You can filter data using advanced filter available in the All Service Items page (navigate to Service Catalog > My Products & Services > Service Items). The application allows you to search for Service Items using the wildcard character asterisk (*).
For example, you can search for Service Item names beginning with the letters "Cis" - Specify Cis* in the value field and click Go). Similarly, you can also search for Service Item names containing the letters Cis - Specify *Cis*.
Move your mouse between two columns until the column resize cursor appears (). Click and drag it to the desired position.
Click a column to sort in ascending order (). Click the same column again to sort in descending order (). Alternatively, move your mouse over a column until the column sort button appears (). Click the column sort button and then choose Sort Ascending or Sort Descending.
Click the Edit Columns drop-down and then select the check boxes to choose the columns to display in the My Products & Services pane. You can choose only four columns at a time. To hide a column, uncheck the check box.
You can create a new filter view or edit an existing filter for the service items in My Products & Services. For more information on how to do this, see Saving and Retrieving filter in My Products & Services
You can click the Export to Excel button to save the Service Item results in the My Products & Services pane to a Microsoft Excel file.
To create a view filter:
Step 1 | Select a
filter or search criteria that you have applied.
| ||
Step 2 | Click the
save
icon and save it in the default view or by any other view name in the
Save
View pop up window.
To delete a saved view, select the view from the Display view drop-down and click the delete icon. The delete icon will not appear for a view that has been chosen as a Site default view by the administrator for all the users who navigate to My Products & Services. To edit a filter, enter the new filter or search criteria and click Save in the Save View pop up window. |
You can track orders you have submitted for which you are either the customer or the initiator.
From the Service Catalog home page click either on the My Products & Services pane or click the plus icon to expand My Products & Services from the main menu and click on Orders. This page lists all the services you have ordered and displays its status.
Click order number to view the details of the order:
Requisition Details section
Services section
This section displays the quantity and cost for each service, along with its Standard Duration.
Note | If you ordered a bundled service, the page lists all child services included in the parent service (bundle), such as Telephone [Included in New Hire] and Voicemail [Included in New Hire]. If you want to cancel a bundle, you must cancel the complete order; you cannot cancel individual child services included with the bundle. |
Delivery Process section
The Delivery Process section lists the milestones-the major tasks of reviewers, approvers, and service performers-in the service delivery process, along with the due date for each milestone and its current status.
Status | Description |
---|---|
Preparation | Requisition status pertaining to the time period when the requisition is being created, up until it has actually been submitted. |
Ordered | Status assigned to a requisition after submission if the "Submit, Approve and Review Asynchronously" setting is turned on in the Administration module. If this setting is enabled, after requisition submission, the status becomes "Ordered" until it is processed by the Business Engine. Afterwards, the status becomes "Ongoing". See Asynchronous Submission or Last Approval. |
Ongoing | Requisition status pertaining to the entire time period after the requisition has been submitted up until it has either been completely fulfilled, or has been cancelled. |
Closed | Requisition status pertaining to a requisition that has been completely fulfilled. |
Cancelled | Requisition status pertaining to a requisition that has been cancelled--either by its initiator or its customer. |
Rejected | Requisition status pertaining to a requisition that has been rejected by an authorizer. |
The Requisition Status page displays details about the status of a single requisition, along with all the services in the requisition. You can also create and view comments, as well as attach and view documents.
To view order status details:Step 1 | Go to Service Catalog > My Products & Services from main page pane or from main menu and click on Orders. | ||||||
Step 2 | Click on the
requisition number to view the order details.
|
You can use an unsubmitted requisition to create a new requisition for you or on behalf of others using the Order Management module.
Copy on Behalf
If you order services on behalf of others, click Copy on Behalf to copy the service. Then follow the steps for Ordering For Others.
Note | When you copy a requisition to order on behalf of another person, Order Management creates a new requisition for that person, even if you already have an unsubmitted requisition for that person. |
A requisition, or a service within a requisition, can be cancelled by the customer or the initiator within the time frame established by the service team. This is usually a point before significant work has been done or significant cost has been incurred.
You can cancel an entire requisition or one or more services in a requisition.
Note | You cannot individually cancel child services that are part of a parent (bundled) service. |
Note | If the Cancel button is not available, then you may not cancel the requisition. |
You can view all the services you ordered from the Service Catalog module which are already processed.
Step 1 | Choose Service Catalog > My Products & Services from main page pane or from main menu and click on Orders. | ||||||||
Step 2 | To view the
details of the order click on the order number.
For more details of each service, see Viewing Order Status Details. |
This Servers tab available under
provides information about all of your active servers. Using this tab, you can monitor status, manage snapshots, verify that a server you that ordered has been delivered, and manage power, modify configuration, take snapshots, decommission, and extend an existing lease. These server details are displayed in a table, which includes details such as the server’s operating system, organization, and the server owner. You can choose to display more information about these servers in the table by adding more columns to the table. These servers can be filtered by name, user, type, and OS details. The various operations available for these server appears only if the servers provisioning process is completed.Suspend VM: Using this options all the processes are stopped and even the VMs are temporarily turned off.
As a tenant administrator, you can create Virtual Data Centers (VDCs) for a tenant and add VMs to VDCs. The VDC creation will result in an APIC container, using which you can add VMs.
Each tenant has an agreement tied to it and the creation of VDC is governed by this agreement. For more information on creating a VDC, see the section Adding Virtual Data Centers. After the VDC is created, you can update or delete the VDC. For more information on updating and deleting a VDC, see the section Modifying Virtual Data Center.
A tenant user can view and manage all of the VDCs that the user is associated to (or has access to) from the My Products & Services > Virtual Data Centers. The user can also perform any supported operation on a VDC that is in Active state. For more information on managing the VDCs, see the section Managing Virtual Data Centers.
Step 1 | As a tenant user, click . |
Step 2 | Click the (+) icon to add a new VDC to your account. |
Step 3 | In the General tab, enter the display name and description of the VDC. |
Step 4 | In the
Topology
tab, do the following:
|
Step 5 | In the
Resource
Specification tab, do the following:
|
Step 6 | Click Submit to save the new VDC details. |
Step 1 | As a tenant user, click . | ||
Step 2 | Click the edit icon on the existing VDC and modify the attributes for that VDC. | ||
Step 3 | Modify the
details such as the description for the selected VDC in the
General tab,
or modify the resource allocations under the
Resource
Specification tab, or provide VDC access to one or more Organizations by
searching for an organization under the
Permission
tab.
A user with a tenant admin role associated to an Organization can view the associated VDCs in the Service Catalog module, and perform any supported operation on a VDC.
Deleting a Virtual Data Center As a tenant user, click . Click the delete icon on the existing VDC and delete the VDC. |
A tenant user can view and manage all of the VDCs that the user is associated to (or has access to) by logging into the My Products & Services page. The user can view the VDC details such as the VM's and the physical servers associated with VDC, add a VM, physical server, load balancer, or firewall rule to a VDC, and perform operations such as power off on a VM that is in the active state.
Step 1 | Login as a Tenant administrator and select a VDC from Tiers for the selected VDC are displayed. Each Tier contains a set of Virtual Machines and Physical servers. tab. | ||
Step 2 | In the
Overview tab, for a Tier, click the gear icon (on
the right) to add a virtual machine, physical server, or load balancer.
| ||
Step 3 | Click the virtual machines or physical servers for a detailed view of all the virtual machines or physical servers. An information icon 'i' is displayed in the Status column, which provides an overlay of requisition, history, comments, along with the date and timestamp. You can refresh the status. Additionally, the information icon is displayed in the Storage column, which provides information regarding the disk, provision type and provision size that is in use. | ||
Step 4 | In the
detailed view (tabular view), when you click the gear icon (on the extreme
right for each VM or physical server), you can perform supported operations
(such as Power Off, Resize VM, Delete VM, etc) for each VM that is in the
Active state.
| ||
Step 5 | To add a
firewall rule, do the following:
| ||
Step 6 | To add a load
balancer, do the following:
|
You can view available resources, associated quota information, and the usage information for the tenant under
tab. A site administrator assigns the quota to a tenant administrator while creating it.With Prime Service Catalog, UCS Director and ACI, a service provider administrator can provide infrastructure as a service (IaaS) to multiple tenants quickly and efficiently. This section is meant for tenant administrators who have been delegated administration capability over compute, network and storage resources that have been allocated to their tenant, as well as their end users.
Using the Tenant Management module, a tenant administrator (or a tenant server admin, tenant network admin and tenant storage admin) can manage tenant users, define quotas on computing resources, and virtual machines for a virtual data center, view the usage reports for virtual data centers, provision new virtual data center, as well as manage firewall and load balancers in his tenant environment. For more information on provisioning a virtual data center and viewing the usage reports for a VDC, see Virtual Data Centers and Monitoring Resource Usage for a Tenant sections in Cisco Prime Service Catalog 11.1 User Guide.
When you create an organization, you can assign users and roles to the users in that organization. The Organization, users, and Virtual Data Centers are synchronized with UCSD after they are created in the Prime Service Catalog application.
Step 1 | Log in as Tenant Administrator and go to User Management (click Tenant Admin in the Tenant Management dashboard). | ||
Step 2 | Click the Organizations dashlet and New Org. | ||
Step 3 | Enter the
necessary details in the
General tab and click
Save.
This is also applicable for System Roles, Extensions and Permissions in the Users dashlet. | ||
Step 4 | Click
Add
Users in the
Users tab and search for a user to associate with
the Organization.
Alternatively, you can click Users from the User Management on the left pane, click New User and enter the necessary information for creating a new user.
| ||
Step 5 | Click
Assign
Roles in the
Roles tab and search for a role to associate with
the Organization.
Alternatively, you can select Show Inherited Roles in the Roles tab and choose an inherited role to assign to the Organization. | ||
Step 6 | Click
Functional Position to assign users to the available
functional positions (search for a user by entering asterisk (*)).
You can add a new Functional Position through the Organizational Designer module (in the Functional Positions page). You can also edit the details for an Organization (when the status is On) or delete it from the Organizations dashlet. However, you must first change the status to Inactive before you delete it. |
Note | You can view reports specific to vDCs that you have access to. Only a site administrator can access all the reports. |
###### Reporting Data Poller Settings ################### # In non-cluster mode: this should be enabled for the Requisitions Data script to be run from the Poller # In clustered mode: this can be either enabled on all nodes in the cluster OR on a specific node in the cluster # - only 1 node in the cluster will run at any given time, even if this is enabled on multiple nodes in a cluster (which ever node starts it first) reportsData.poller.enable=true ###########################################
########################################### #Resource Reporting Data Poller ########################################### #Cron Expression wakes up poller every 40 minutes of an hour • reportsdata.poller.cron=0 0/40 * * * ? #Cron Expression wakes up health check for 13th min and 15th min thereafter of the hour ex: 13,28,43,58 minutes reportsdata.poller.health.check.cron=0 13/15 * * * ? #High Availability Health checks threshold, this should be greater than Poller cron time specified in minutes reportsdata.healthCheck.threshold=127 ###########################################
You can also configure the number of days, months, weeks and beginner of the week for which the data needs to be imported in the newscale.properties file. For more information on configuring the polling interval and data import settings, see Scheduling the Collection of Reporting Data from UCS Director section of Cisco Prime Service Catalog 12.0 Administration and Operation Guide
Integrate the corresponding UCS Director with Prime Service Catalog. For more information on Integrating UCS Director with Prime Service Catalog, see Integrating UCS Director (UCSD) with Prime Service Catalog section of Cisco Prime Service Catalog 12.0 Administration and Operation Guide.
Step 1 | From the main menu, go to . | ||
Step 2 | Click the
Usage
Details or
Cost Details
report to display usage data for all VDC's for all the tenants. These details
include the usage details for all the VDC's, such as the name of the
Organization, name of VDC, name of resource used, category of the used VDC, and
so on.
The Category field indicates the status of different resources. For VM, it can be either active or inactive. For CPU and RAM, it can be allocated, used, or reserved. Additionally, users can apply filters to narrow down search results for Usage Details or Cost Details report by Category, vDC, Resource, and Time.
| ||
Step 3 | Click Download CSV to download the usage data or cost data. |
You can view usage or cost reports for the virtual data centers (for the respective tenants), running on a UCS Director. Using the Usage Reports or Cost Reports tabs, you can view the graphical and pie-chart representation of the VDC usage details and resource usage details. These reports can be generated per tenant.
For more information on the charts and description for Usage and Cost Reports, see the sectionCharts and Description
Note | The Usage Report or Cost Report poller fetches only daily usage data from UCS Director. The aggregate data for the weekly and monthly usage is calculated on the Prime Service Catalog side. |
For more information on configuring the poller, see the Scheduling the Collection of Reporting Data from UCS Director Section in the Cisco Prime Service Catalog 12.0 Administration and Operation Guide.
Step 1 | In the Service Catalog module, go to tab. |
Step 2 | Click
Usage
Reports to display aggregate usage data with respect to all the
categories of VDCs, for all the tenants or
Cost
Reports to display the aggregate cost with respect to all the
categories of VDCs, for all the tenants. When you click the
Usage
Reports tab or
Cost
Reports tab for the first time without using filters, by default,
it shows the monthly usage (usage reports) and monthly cost (cost reports)
charts on the screen.
You can also filter the Usage Reports and Cost Reports by Time, i.e. set it to monthly, weekly, or daily, and also filter by VM name. |
Performance is a real time data and it's not stored in the Prime Service Catalog tables. Using the Performance tab, you can view the line charts representation of the performance of the resources under a vDC. Data points for performance reportes are generated in UCS Performance Manager. Prime Service Catalog imports these data points through an API call functionality. You can view the performance report for a vDC for an hour, 6 hours, and 1 week. You can also customize the time interval for which you need the performance report.
For more information on the charts and description for Performance Report, see Charts and Description
Poller connects to a UCS Performance Manager instance, ensures automatic synchronization and collection of reporting data for all VMs from the UCS Performance Manager at scheduled intervals. The polling interval can be configured in the newscale.properties file. You can edit the newscale.properties file located at RequestCenter.war/WEB-INF/classes/config directory to configure the polling interval.
###### UCSPM Data Poller Settings ################### # In non-cluster mode: this should be enabled for the Requisitions Data script to be run from the Poller # In clustered mode: this can be either enabled on all nodes in the cluster OR on a specific node in the cluster # - only 1 node in the cluster will run at any given time, even if this is enabled on multiple nodes in a cluster (which ever node starts it first) ucspmData.poller.enable=true ###########################################
In the newscale.properties file, change the interval of polling, as shown in the example below:
########################################### #Resource Reporting Data Poller ########################################### #Cron Expression wakes up poller every 40 minutes of an hour • reportsdata.poller.cron=0 0/40 * * * ? #Cron Expression wakes up health check for 13th min and 15th min thereafter of the hour ex: 13,28,43,58 minutes reportsdata.poller.health.check.cron=0 13/15 * * * ? #High Availability Health checks threshold, this should be greater than Poller cron time specified in minutes reportsdata.healthCheck.threshold=127 ###########################################
For information on UCSPM integration, see Integrating Performance Manager with Prime Service Catalog section of Cisco Prime Service Catalog 12.0 Administration and Operation Guide.
Before You Begin
Add connection for UCS PM in Manage Connections screen.
Go to Administration > Manage Connections > UCS Performance Manager tab
Step 1 | In the Service Catalog module, go to tab. | ||
Step 2 | Click a virtual machine to view the performance details of a VM. | ||
Step 3 | Click a
specific report displayed under the
Performance tab. The
Resource
Reports tab launches and displays the performance details of the
selected virtual machine for the last one hour. You can view all the other
virtual machines that you have access to. You can compare the performance of
ten virtual machines at a time .
You can also filter the performance report by vDC. |
The following charts are displayed based on the report type you choose:
Name of Chart |
Description |
---|---|
Usage Report |
|
VM Count by Status |
Displays the aggregate VM hours, based on the current status - Active or Inactive. |
VM Count by vDC |
Displays the aggregate VM hours for active status, based on vDC names. You can only select a maximum of 10 vDC names. |
CPU Count by Provision Type |
Displays the aggregate CPU hours, based on the provision type -Reserved, Allocated, or Used. |
RAM Count by Provision Type |
Displays the aggregate RAM hours based on the provision type -Reserved, Allocated, or Used. |
Storage Count by Provision Type |
Displays the aggregate storage hours for the used and unused storage space based on the provision type - Committed or Uncommitted. |
Cost Report |
|
VM Cost by Resource Type |
|
VM Cost by Resource Status |
|
VM cost by vDC |
Displays the aggregate cost of each vDC when you select the vDCs from the list of vDCs and click Refresh Chart. |
Performance Report |
|
CPU Utilization |
Displays the CPU utilization of the selected VM. |
Memory Utilization |
Displays the memory utilization of the selected VM. |
Disk Usage |
Displays the disk usage for the selected VM. |
Network Usage |
Displays the network usage for the selected VM. |
Once team management is activated by the Site Administrator, every user must belong to a team to be able to order services. When the user first navigates to Teams page from the main menu, the user is provided with two options. User can join an existing team or create a new team. In this release a user can be a member of only one team regardless of his role.
When a user creates a team, he assumes a role of Team Administrator. Users with the team administrator role can view the assets and deployments for the entire team hierarchy. Every user can view the reports, servers, usage information on the dashboard only from the deployments or servers he owns.
If a team is created without a parent team associated with it, then that team is known as root team or Project. To create a sub team, you must associate it with a parent team. In that case, the team admin of the parent team can view the members and assets of the teams in the hierarchy, but cannot manage them.
To create a team:
Step 1 | From Service Catalog hamburger menu go to Teams, and click New Team. | ||
Step 2 | Enter the
details in the create team form and select the patent team from the drop-down
list.
| ||
Step 3 | Click Submit. This triggers an approval email to the team administrator and in case of creation of a project the approval goes to the Site Administrator. The administrator then approves or rejects the request. Post approval or rejection the user is notified through an email. |
You can join an existing team from the join team option. To join a team:
Step 1 | From Service Catalog main menu go to Teams, and click Join Team. |
Step 2 | Search for the team using the Team Name. |
Step 3 | Select the team you want to join from the list and click Select Team. |
Step 4 | Click Submit on the Join team page. This triggers an approval email to the team admin. The team administrator would receive an email notification to approve the new member to join the team. The team administrator then approves or rejects the request. Post approval or rejection the user is notified through an email. |
If a Project is created, then the Site administrator would need to approve the creation of the new root team. When a user joins an existing team, or creates a sub team, the team admin approves the new member to join the team or to create the new sub-team. Email notification is sent out to the respective approver.
Approvals are triggered when:
Action |
Approver |
Creates a Project | Site Administrator |
Creates a team/sub-team | Parent Team Administrator |
Joins a team/sub-team | Team Administrator |
All the approval notification is listed in the Open Authorization tab under Notifications with options to approve or reject. The team administrator must review the details before approving.
If you desire to leave the team, from the main menu, choose Teams. Click Manage Team to view the Team Detail page, select your team and click Leave Team. A confirmation message appears, you must join a team or create a new team to proceed further.
If you are the team administrator and want to leave the team, you must first promote another member of the team as the Team Administrator. For more info see Promote as a Team Admin.
As a team Administrator, you can assign the team administrator privilege to some other team member. In that case, you lose all the team administrator privileges. A team can have only one team administrator.
If you are the team administrator and want to leave the team, you must first promote another member of the team as the team administrator. For more info see Promote as a team admin.
As a Team Administrator, if the Service Items or Deployments are not visible in your team hierarchy then, ensure that the Service Item permissions refresh flag is enabled in Administration > Settings.
If a user is unable to order any services, then ensure that the Allow Service Ordering flag is enabled in Administration > Settings. Also if Team Management is configured, then the user must belong to a Team to order any service from Prime Service Catalog.
All users can browse the service catalog, to view services which they have permission to order, and request services for themselves. They can also view any requisitions they have previously ordered. In addition, the Service Catalog home page is configurable so that designated users or groups of users can order on behalf of other users; the user can use the options like View Authorization and Perform Authorization using Order management.
The Service Portal module is a module where the administrators can design and deploy portlets to interact with services, service items, standards, offerings, and other core entities in the application. These portlets are defined using Portal Designer module and displayed in the Service Portal module. An administrator can define any number of portlets and grant permission to users to read or edit data displayed in these portlets.
The Service Portal module prior to version 10.0 contained My Workspace and System module page groups by default that are obsolete from 10.0. These pages would appear only if you have upgraded from 9.x versions.
Note | If you want to remove these page groups from end user view, please contact your administrator. |
Site Homepage
The Site Homepage is available as part of the standard implementation to display any site-wide information. All users are granted access permission to this portal page. To disable the page, you can remove the read permission of the page from the Anyone role in Organization Designer module.
Organizational Unit Homepage
In a distributed portal administration model, portal designers may prefer to set up different landing pages for different organizational units to allow end users to access the organization-specific content. Users whose home organizational units are configured with a home page in the Portal Designer settings will have that page as the default landing page in the Service Portal.
User Homepage
Users can select any portal page they have access to as their own homepage, overriding the default organizational unit default homepage.
Home Page Drop-Down
Home page: Click this tool if you want to return to the page that you have configured as home page.
Set as Homepage: The action marks the current active tab as the home page and moves it to the first page group position. When there is only one portal page in the current module, this button is disabled.
Edit Page
Add Content
The Add Content button allows users to add one or more portlets to the current page by checking the appropriate check boxes. The portlets displayed are limited to those for which the user has read permissions.
The number of portlets that can be added to a page is set on the Common Settings subtab (Portal Settings > General > Common Settings)—the “Maximum Number of Portlets on a Tab” and “Maximum Number of Grid Portlets on a Tab” settings. When an attempt is made to add a portlet to the page that has already reached one or more of these limits, an error message appears.
Edit Page Settings
The Page Settings tab allows portal users to modify the appearance of the current portal page. The initial settings displayed are inherited from the page as designed in Portal Designer. You may adjust individual settings then click Apply to see the effects of your adjustments. Click Close when you are done.
Save Page
Click Save Page to save your edits to the page. The changes are seen by all users who subscribe to the page.
Finish Editing Page
The Finish Editing Page button takes users back to View Mode. If you have made any changes, be sure to click Save Page to save your edits before you click Finish Editing Page.
Page Tools Drop-Down
Edit Passwords: External sites that require individual authentication settings can be maintained to allow automatic authentication every time the portlet is accessed. The credentials maintained here are not accessible by other users, including the Portal Designer users.
Create Portal Pages: This options opens a popup window to allow users to add an existing portal page or to create a new page. The new page is added as the last tab in the module by default. It can be moved to a different tab position by mouse drag-and-drop actions as long as it is located after the homepages for the currently chosen module.
The maximum number of tabs allowed in each module is governed by the common settings in Portal Designer > Portal Settings > Common Settings. When the user is about to exceed the page limit, an error message appears.The Open Page subtab shows a list of portal pages for which the user has read permissions. To add an existing page, highlight the page and at the bottom of the popup window, click Open.
The Create Portal Pages subtab is enabled for users who have the Service Catalog “Manage Portal Pages” capability and write permission to the corresponding portal page group for the currently chosen module.
Once a portlet is added to the page in View Mode, it is automatically saved to the page, and cannot be removed unless you enter Edit Mode by clicking on the Edit Page tool click the cancel button on the portlet.
Note | These buttons are disabled if the portlet has already been added to the current page. It is hidden if the user does not have Page Write access or appropriate RBAC permissions. |
Field | Description |
---|---|
Title | The title of the page, displayed on the tabs at the top of the portal page. |
Theme |
The color scheme and styles to be used to display the portal page contents. The drop-down box is enabled only for users who have the Service Portal “Manage Portal Page Theme” capability. |
Layout |
The number of sections and columns to be used to display the portlets that comprise the current page. |
Make this page public |
Making a portal page public makes it visible to other users. The check box is enabled only for users who have the Service Portal “Make Portal Pages Public” capability. |
Column <n>Width |
For each column in the Layout, the user can specify the percentage of the browser width that the column should take up. The percentages should not exceed 100 percent. |
Portlet Borders |
True if each portlet should have a border around it; false otherwise. |
Portlet Headers | True if the grid column headers should be displayed; false otherwise. |
See the Modifying Filtering for Reserved Portlets section of the Cisco Prime Service Catalog 12.0 Designer Guide for information on these Reserved portlets. In a Reserved portlet, click the Settings button to edit settings for that portlet. Click the Cancel button to remove the portlet from the page.
Portlets with automatic authentication enabled for external sites can be included on any portal pages.
If the included site has been defined with global authentication, the application will pass the preset credentials to the external site for authentication and display the site’s portlet on the current portal page. If the included site does not have global authentication enabled, the application will attempt to connect to the portlet with the site authentication credentials that the user has previously defined through Edit Password settings in the portal front-end.The Edit Passwords page lists all sites associated with portlets displayed on the user’s portal page that are enabled for automatic authentication but do not use global authentication. The user may enter connection information for all external sites and save the settings for use in other portal pages. The saved settings are preserved for the current session in which the portal page is displayed or until the associated site times out. If the user navigates to another page or module and returns to the portal page, automatic authentication will take place again.
Users are prompted for login or authentication exceptions by the external site if: