Cisco Prime Service Catalog 12.0.1 Release Notes

Available Languages

Updated:April 13, 2017

Bias-Free Language

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


First Published: April 13, 2017


Cisco Prime Service Catalog

Cisco Prime Service Catalog is a key component of Service Management package of the Cisco ONE Enterprise Cloud Suite, the solution for a software defined data center.

Cisco Prime Service Catalog provides out-of-box integration with Cisco UCS Director (UCSD), CloudCenter, and Process Orchestrator to offer a user-friendly IT service storefront for private cloud infrastructure as a service.

In addition, Cisco Prime Service Catalog is an IT service catalog that enterprises can use to implement traditional IT workplace services, such as employee onboarding, laptop refresh and other IT services.

Cisco ONE Data Center Foundation for Compute versus Cisco ONE Enterprise Cloud Suite

Cisco ONE Enterprise Cloud Suite is a part of the Cisco ONE for Data Center solution and consists of four components: Infrastructure Automation, Cloud Management, Big Data Automation and Service Management. Each component can be used individually, or all components can be used together to create an integrated hybrid cloud solution. All components were designed to work together, providing you with an incremental approach to hybrid cloud automation.

The Cisco ONE ECS Service Management package which includes Cisco Prime Service catalog and Cisco Process Orchestrator is sold as a one-year, three-year, or five-year subscription and a customer can order the Service Management Base bundle with an option to add-on the Service Management Workplace option.

The following table illustrates the features available in the legacy offer, Cisco ONE Enterprise Cloud Suite Advanced , as well as the new Cisco ONE ECS Service Management.

Cisco Prime Service Catalog

v11.1.1 and previous

12.0 and above

Cisco ONE Enterprise Cloud Suite Advanced

Cisco ONE Enterprise Cloud Suite ITSM

Feature

Description

Prime Service Catalog

Base

Workplace

Tenant Management Feature Pack

Feature pack deploying RBAC avoiding the need to manually design and implement.

✔

✔

Mini Service Design

Deploy and manage UCSD and CloudCenter in a lightweight, user friendly UI.

✔

✔

Cisco UCSD Integration

Integration of Prime Service Catalog and UCSD enabling the setup of the connection without the need to create complex flows and configurations.

✔

✔

My Products and Services

view and manage order history, owned UCSD assets & CloudCenter applications.

✔

✔

Cisco CloudCenter Integration

Integration of Prime Service Catalog and CloudCenter enabling the setup of the connection without the need to create complex flows and configurations.

✔

✔

Virtual Appliance Installer

Publish installations or updates packages that the customer can install via a simple yum command (or via the shelladmin menus).

✔

✔

Service Catalog

Enables customers to find services, submit orders.

✔

✔

✔

Catalog Deployer

Used for content deployment and configuration management to migrate application entities between development, test, and production sites.

✔

✔

✔

Service Manager

Enables service teams and their outsource providers to manage and track service requests and service level agreements.

✔

✔

Service Portal

Provides a customizable portal for PSC that can supplement (or replace) the Service Catalog home pages.

✔

✔

Order Management

enables customers to track service requests.

✔

✔

Service Designer

enables service delivery teams to design and package services as a product, and catalog their service offerings.

✔

✔

Organization Designer

model & manage service delivery organizations & customers, including organizational units, people, queues, positions & roles.

✔

✔

Administration

Module for administering global settings, synchronizing with your directory, and customizing your implementation.

✔

✔

Service Item Manager

Design and manage service item classes, types, and instances; and to create, import and manage the supporting data (standards) to construct the forms through which users will request service items.

✔

✔

Service Link

Integration component, for interfaces between PSC with external systems, such as Cisco Process Orchestrator (CPO).

✔

✔

Portal Designer

Used to configure portlets and portal pages that can supplement (or replace) the Service Catalog home page providing a customizable entry point to the Catalog for end users.

✔

✔

Localization

Module used to localize the product in various languages and also enable them.

✔

✔

Demand Management

Design billing rates and configure accounts and agreements to charge services based on usage.

✔

✔

Reporting

Provides a set of reports, metrics and Key Performance Indicators (KPIs) for monitoring service delivery operations.

✔

Available if ordered separately.

Advanced Reporting

Provides ad hoc reporting and report authoring to enable root cause analysis and customized reporting for monitoring and managing service delivery operations. Uses IBM Cognos reporting and data management tools.

✔

Available if ordered separately.

New Features and Enhancements in Prime Service Catalog 12.0.1

This section provides an overview of the significant new and changed features in this release.

WebLogic 12c Support

Starting from Prime Service Catalog 12.0.1, Prime Service Catalog supports installation on Oracle WebLogic 12c (12.2.1.2) application server. If you are upgrading from a previous release of Prime Service Catalog that was installed with WebLogic 11.1.1, you must first upgrade your WebLogic. You can either install WebLogic 12c on a new machine, or uninstall previous version of WebLogic then install WebLogic 12c on the same machine. For more information, see Cisco Prime Service Catalog 12.0.1 Installation Guide.


Note

Slowness may be experienced in WebLogic 12c application server on RHEL during startup. This is a known issue with Oracle WebLogic 12c, refer to Oracle Weblogic documentation for the workaround.

Support for Inbound JSON Message

Prime Service Catalog now supports JSON inbound messages using FTL transformation. The JSON inbound message is supported only for File and HTTP/WS adapters. To achieve this you would need to write a FTL transformation which maps the custom JSON to nsXML. For more details on writing FTL transformation see http:/​/​freemarker.org/​. For more information on HTTP/WS Adapter and File Adapter, see Cisco Prime Service Catalog Integration Guide.

Following are the operations that can be performed on a requisition using HTTP/WS adapter and File adapter:

  • Add Comments

  • Adding Parameters

  • Updating Values

  • Completing Delivery Task

  • Review Task

  • Approve Task

  • Reject Task

Each of the operations are explained in detail below:

add-comments

An add-comments operation is used to add comments to the System Comments section of the requisition.

Example JSON Payload 
{
"key":"CF04ECC6-1868-4D7B-9C83-463054C27453",
"message":"Adding comment to requisition”,
}
Corresponding Example Transformation 
<?xml version="1.0" encoding="UTF-8"?>
<message channel-id="${root.key}">
<add-comments>
<comment>${root.message}</comment>
</add-comments>
</message>
Where,

  • ${root} represents org.json.JSONObject of the incoming JSON string.

  • ${root.key} corresponds to the channel-id/key attribute from the JSON payload.

  • ${root.message} corresponds to the message attribute to be added to the requisition.

add-parameters

Parameters are data elements that are bound to dictionary fields within the agent definition. The add-parameters message type allows one or more specified parameters to be added which, in turn, add the corresponding dictionary fields in the service. Using this type of inbound message is the preferred way for the external system to update dictionary fields used in a service request.

Example JSON Payload 
{
"key":"150A3FB7-5E2B-486B-8288-D197506A9762",
"param":"Param1",
"value":29
}
Corresponding Example Transformation 
<?xml version="1.0" encoding="UTF-8"?>
<message channel-id="${root.key}">
<send-parameters>
<agent-parameter>
<name>${root.param}</name>
<value>${root.value}</value>
</agent-parameter>
</send-parameters>
</message>
Where,

  • ${root} represents org.json.JSONObject of the incoming string.

  • ${root.key} corresponds to the channel-id/key attribute from the JSON payload.

  • ${root.param} corresponds to the parameter attribute.

  • ${root.value} is the value of the parameter to be added.

update-values

The update-value message type allows one or more specified parameters to be updated with a new value.

Example JSON Payload 
{
"key":"150A3FB7-5E2B-486B-8288-D197506A9762",
"param":"D.Age",
"value":65
}
Corresponding Example Transformation 
<?xml version="1.0" encoding="UTF-8"?>
<message channel-id="${root.key}">
<update-data>
<data-value multi-valued="false">
<name>${root.param}</name>
<value>${root.value}</value>
</data-value>
</update-data>
</message>

update-multiple-values

The update-value message type allows multiple specified parameters to be updated with a new value.

Example JSON Payload 
{
"key":"EE44AB32-6940-4423-A3A8-46EFDE8ED054",
"keypair":{"param":"D.Country",
                   "values":[{"value":"China"},
              {"value":"US"}]
               }
}
Corresponding Example Transformation 
<?xml version="1.0" encoding="UTF-8"?>
<message channel-id="${root.key}">
<update-data>
<data-value multi-valued="true">
<name>${root.keypair.param}</name>
<#assign x=root.keypair.values.length()>
<#list 1..x as i>
<value>${root.keypair.values.get(.vars.i - 1).get("value")}</value>
</#list>
</data-value>
</update-data>
</message>

take-action

A take-action message may be applied to an authorization or delivery task, to change the status of the task. The action attribute of the take-action tag identifies the action to be taken. Valid actions are summarized in table below.

Table 1 Take-action Messages Table

Action

Task Type

Description

done

Delivery task

Mark the delivery task as completed.

ok

Review task

Mark the review as completed.

reject

Authorization task

Reject the authorization.

approve

Authorization task

Approve the authorization.

When the last delivery task in a task plan is marked as done, the requisition is closed (completed). An approval task can be marked as Approved or Rejected, by setting the “action” attribute of the take-action tag to the corresponding value.

Example JSON Payload 
{
"key":"19E2A5E6-40EA-43AC-9D73-5FDEFF8C28FB",
"action":”ok”, "action":”approve”, "action":”reject
}
Corresponding Example Transformation 
<?xml version="1.0" encoding="UTF-8"?>
<message channel-id="${root.key}">
<take-action action="${root.action}">
</take-action>
</message>
Where,

  • ${root} represents org.json.JSONObject of the incoming string.

  • ${root.key} corresponds to the channel-id/key attribute from the JSON payload.

  • ${root.action} is the task type.

Limitations

  • On Windows operating system, when you stop the "Cisco Prime Service Catalog" service or "Cisco Prime Service Link" service, you may occasionally get an error message which says that Windows could not stop the service on Local computer, even though the service was actually stopped successfully. You can safely ignore the error message.
  • Before starting the standalone WildFly server as Windows services, you must perform the following configuration changes in the servicecatalogwrapper.conf and servicelinkwrapper.conf files. These files can be located under <ServiceCatalog_Install_Dir>/conf.
    1. Modify the following JVM parameters: 
      wrapper.java.additional.4=-XX:PermSize=256m
wrapper.java.additional.5=-XX:MaxPermSize=256m
      to 
      wrapper.java.additional.4=-XX:PermSize=512m
wrapper.java.additional.5=-XX:MaxPermSize=512m
    2. Comment out the following line. 
      wrapper.java.additional.24=-XX:ReservedCodeCacheSize=256m
  • Provisioning of APIC containers through APIC container catalogs imported from UCSD, when UCS Director is in a non-MSP (Default) mode, has not been validated (certified) in this release.
  • Do not use hyphen in Advance Catalog name while creating these catalogs in UCS Director. This is to avoid the synchronization issues after integrating with Prime Service Catalog.
  • The virtual appliance is supported only on VMware vSphere version 5.x.
  • The dynamic strings coming from the UCS Director server on the Usage Reports and Usage Details tabs cannot be localized.
  • You may experience slowness in WebLogic 12c application server on RHEL OS during startup. This is a known issue with Oracle WebLogic 12c, refer to Oracle WebLogic documentation for the workaround.

Installation Notes

In Prime Service Catalog 12.0.1, the installation is supported for both WildFly and WebLogic application server and can be configured in both Standalone and Cluster configurations.

  • Standalone Installer (zip file)

    • Use the setup.sh script on Linux and setup.cmd program on Windows for installing and upgrading Cisco Prime Service Catalog.

    • Use the reporting_setup.cmd program to install Cisco Prime Service Catalog Reporting. This is a separately licensed business intelligent product supported on Windows operating system.

      If you are using Cisco Prime Service Catalog Reporting, you must obtain the latest version of the Cognos software, and run the reporting_setup.cmd program to configure Cognos and the Data Mart database. For more information, see the Cisco Prime Service Catalog Installation and Upgrade Guide.

    • Use the setup.sh on Linux and setup.cmd on Windows for also installing Cisco Prime Service Catalog in clustered environment. Both WebLogic and WildFly application servers can be deployed in a cluster for failover scenarios.


Note

There are some limitations in the WildFly installations. For more information, see Limitations.

Upgrade Notes

Before upgrading, read the important notes in Planning Upgrades to Prime Service Catalog 12.0 and Later.

  • You can directly upgrade using the installer to Prime Service Catalog release 12.0.1, if your existing installation is one of the following releases:

    • 11.0

    • 11.1

    • 11.1.1

    • 12.0

If you are upgrading prior to 11.0, first upgrade your installation to release 11.0 using the 11.0 installer. Then without starting the Prime Service Catalog instance, run the 12.0.1 installer to upgrade the instance to 12.0.1 release. For detailed information about the application upgrade, see the Upgrading Prime Service Catalog chapter of Cisco Prime Service Catalog Installation and Upgrade Guide.

  • To upgrade from 11.0, 11.1.x, or 12.0 release to 12.0.1 release, you must supply the same MEK file (i.e. Master Encryption Key) that was used for your current installation.

  • If you are upgrading from a previous release databases and have an existing facet with display name as “Rating”, make sure that you rename this facet before upgrading. This is to avoid conflict with the new Rating facet available in Cisco Prime Service Catalog 12.0.1.

Platform Support

For information about platforms that are supported by Cisco Prime Service Catalog, see the Cisco Prime Service Catalog Compatibility Matrix.

Planning Upgrades to Prime Service Catalog 12.0 and Later

  • The Bootstrap library has been upgraded to a latest version (3.3.4). If you are using the existing Bootstrap library for any customizations, consider reviewing or modifying these customizations while planning the upgrade.
  • With the WildFly support, JBoss application server is no longer supported from Prime Service Catalog 12.0 and later versions. If you are leveraging any features specific to the JBoss application server in your solution, consider this information while planning the upgrade.

Prime Service Catalog 12.0.1 Bugs

Use the Bug Search tool to search for a specific bug or to search for all bugs in 12.0.1 release:

Procedure
    Step 1   Go to http:/​/​tools.cisco.com/​bugsearch.
    Step 2   At the Log In screen, enter your registered Cisco.com username and password; then, click Log In. The Bug Search page opens.
    Note   

    If you do not have a Cisco.com username and password, you can register for them at http:/​/​tools.cisco.com/​RPF/​register/​register.do.

    Step 3   To search for a specific bug, enter the bug ID in the Search For field, and click Return.
    Step 4   To search for bugs in the current release, click the Search Bugs tab and specify the following criteria:
    1. In the Search For field, enter Prime Service Catalog and in the Releases field, enter 12.0.1 and click Return. (Leave the other fields empty).
    2. When the search results are displayed, use the filter tools to find the types of bugs you are looking for. You can search for bugs by modified date, status, severity, and so on.

    To export the results to a spreadsheet, click the Export All to Spreadsheet link.

    Related Documentation

    For the list of documents available for Prime Service Catalog, see Cisco Prime Service Catalog Documentation Overview Guide. You can download product patch readmes from Download Software link.

    See the Cisco Prime Service Catalog support site for information about:

    Accessibility Features in Prime Service Catalog

    For a list of accessibility features in Prime Service Catalog 12.0, see the Voluntary Product Accessibility Template (VPAT) on the Cisco website, or contact accessibility@cisco.com.

    All product documents are accessible except for images, graphics, and some charts. If you would like to receive the product documentation in audio format, braille, or large print, contact accessibility@cisco.com.

    Copyright © 2017, Cisco Systems, Inc. All rights reserved.

    Was this Document Helpful?

    FeedbackFeedback

    Contact Cisco