Administer > Service Manager Service Portal Administration Guide > HPE Service Manager Service Portal Tips

HPE Service Manager Service Portal Tips

Customizing HPE Service Manager Service Portal

  • Customizing the Portal

    You can customize the display of the Portal. For details about customizing the portal, refer to the Manage Customizations in the Identity Management section from the HPE Service Manager Service Portal online help for administrators.

  • Customizing the Launchpad

    You can customize the display of the Launchpad. For details about customizing the launchpad, themes, and widgets, refer to the HPE Propel Customizing the Launchpad whitepaper.

    Note As HPE Service Manager Service Portal is based on HPE Propel, the Propel customization techniques also work for HPE Service Manager Service Portal. For HPE Propel whitepapers, see https://softwaresupport.hpe.com/km/KM01746029.

Manually Changing the Keystore Password

The keystore password on the HPE Service Manager Service Portal host is automatically changed to “propel2014” during the initial installation. Though not required, HPE recommends that you change the default keystore password for the HPE Service Manager Service Portal host. To change the keystore password, execute the following commands:

# keytool –storepasswd –storepass propel2014 -new <NEW_KEYSTORE_PASSWORD>
-keystore /opt/hp/propel/security/propel.truststore

# ./configureKeys.sh --setkspassword <NEW_KEYSTORE_PASSWORD>

Where NEW_KEYSTORE_PASSWORD is the new keystore password that you specify.

Changing HPE Service Manager Service Portal Ticket Re-deliveries for Unavailable HPE SM System

If HPE Service Manager is integrated with HPE Service Manager Service Portal and the HPE SM system becomes unavailable for HPE Service Manager Service Portal to deliver tickets, the default number of attempted ticket re-deliveries is five and the interval is every 30 seconds.

You can configure these re-delivery parameters in the
/opt/hp/propel/sx/WEB-INF/sx.properties file on the HPE Service Manager Service Portal host:

sx.dlx.redelivery.interval.ms=30000
sx.dlx.redelivery.max.count=5

Where the interval property is in milli-seconds.

Managing Licensing

HPE Service Manager Service Portal uses these license types:

  • Instant-on licensing – implemented when installing HPE Service Manager Service Portal and limited to 60 days.
  • Permanent – either unlimited or limited duration.

For details, refer to the HPE Service Manager Service Portal Automation License topic in the Identity Management section from the HPE Service Manager Service Portal online help . (You must be logged into HPE Service Manager Service Portal as the admin user to view this topic.)

Understanding Administrative and Consumer Roles in HPE Service Manager Service Portal

Access to applications in HPE Service Manager Service Portal is controlled through HPE Service Manager Service Portal users. There are three types of HPE Service Manager Service Portal users:

  • Administrator:
    • Logs in as the admin user with the "propel" password at
      $PROPEL_VM_HOSTNAME:9000/org/Provider
    • Manages HPE Service Manager Service Portal settings across all of the organizations. For example, creating and managing organizations or content packs.
    • Has access to the Identity, Content Management, and Diagnostics applications.
  • Organization Administrator:
    • Logs in as the orgadmin user with the "propel" password at
      $PROPEL_VM_HOSTNAME:9000/org/CONSUMER
    • Manages the organization, creates suppliers, aggregates and publishes catalog items, and manages catalogs, categories, and policies. Additionally can perform all Organization Consumer functions (for example shopping and support requests).
    • Has access to the Shop, Knowledge, Request Support, Catalogs, Catalog Items, Categories, Policies, Catalog Connect, Suppliers, and Survey applications.
  • Organization Consumer:
    • Logs in as the consumer user with the "propel" password at
      $PROPEL_VM_HOSTNAME:9000/org/CONSUMER
    • Performs shopping, manages subscriptions, searches knowledge articles, and requests support.
    • Has access to the Shop, Knowledge, Request Support, and Survey applications.

Where $PROPEL_VM_HOSTNAME is the fully qualified host name of the HPE Service Manager Service Portal host.

Using Common LDAP Server with HPE Service Manager Service Portal and End-Point Systems

To prevent errors in HPE Service Manager Service Portal log files that are related to unknown users, HPE recommends that all integrated end-point systems (suppliers) share a common LDAP server with HPE Service Manager Service Portal. Otherwise, identically named users need to be created on both the HPE Service Manager Service Portal system and the integrated end-point system.

Viewing the SSL Certificate-Signing Algorithm

HPE recommends reviewing the certificate-signing algorithms used and ensuring that strong encryption is implemented. For example, SHA1 is sometimes used, and instead, stronger algorithms such as SHA256 should be used.

To view a certificate’s signing algorithm, execute the following command:

# keytool –printcert –file <SSL-CERTIFICATE> | grep –i algorithm

For example:

# keytool –printcert –file /opt/hp/propel/security/propel_host.crt | grep algorithm
Signature algorithm name: SHA256withRSA
#

Filter HPE SM Search Results by Display Name

When adding an aggregation in the Catalog Connect application and using the displayName column in the Query Filter field, the query can return more results than expected.

Because displayName is part of an HPE SM information retrieval (IR) key, searching on a specified displayName value can return more results than expected. By removing displayName from the HPE SM IR key, you are able to correctly search on displayName values.

Before aggregating HPE SM items into HPE Service Manager Service Portal, make the following HPE SM information retrieval (IR) configuration change to enable filtering by displayName.

  1. From the HPE Service Manager Client, access the Table definitions as follows:
    On the System Navigator tab, open System Definition > Tables > svcDisplay
  2. Select the Fields and Keys tab (bottom of the display).
  3. In the Keys content, select IR key:description – displayName.
  4. Under General, select displayName, then click Remove.
  5. Click Save.

Attachment Size and File Types in HPE Service Manager Service Portal

You can control the size and allowable file types for attachments to HPE Service Manager Service Portal Support Requests and Service and Support catalog items. Related properties are located in the /opt/hp/propel/catalog/config.yml file and their default values are:

blobstore
  fileLimit: 20971520
  fileExtensionWhiteList:
    - jpg
    - svg
    - png
    - ico
    - bmp
    - jpeg
    - doc
    - docx
    - ppt
    - pptx
    - xls
    - xlsx
    - xlt
    - xml
    - xsd
    - uml
    - pdf
    - txt
    - json
    - yml
    - csv
  whiteListEnabled: false

By default, 20971520 bytes (approximately 20 MB) is allowed per file and all file types are allowed, even if file extensions are already defined in the fileExtensionWhiteList property. The list of file extensions in the white list is not enabled by default.

To enable the white list of allowable file extensions, you need to specify the following in the config.yml file.

whiteListEnabled: true

After modifying the config.yml file, for the changes to take effect, you must restart the Catalog service with the following command on the HPE Service Manager Service Portal host:

# systemctl restart catalog

Note Be careful when modifying YAML files. Use an online parser tool (for example, Online YAML Parser, http://yaml-online-parser.appspot.com) to check indentations.