Install > Install Service Request Catalog (SRC) > Configure Service Manager

Configure Service Manager

After you install the Service Request Catalog application, complete the following tasks to refine your Service Manager environment.

Task 1: Configure user capability words

Service Manager best practices recommend assigning user roles that carry all the required capability words to be successful at their tasks. The required capability word for Service Request Catalog is service catalog. The service catalog capability word allows a user to request items from the service catalog. Other capability words may be required for role-based scenarios.

Related capability words

To use SRC a user must have the SOAP API Capability word plus at least one of the other capability words from the following table.

Capability word Description
SOAP API (Required) The capability word must be added to enable the user to log in to SRC. Otherwise, a “invalid user” error message may pop up.
svcCatDeptRequester (Optional) An employee can request items from the catalog on behalf of a department.
svcCatEmployeeRequester (Optional) An employee can request items from the catalog.
svcCatManagerRequester (Optional) A manager can request items from catalog.
svcCatRequestOnBehalf (Optional) A user can request items on for another employee.

Request for another person

You can order catalog items and services for another person only if the svcCatRequestOnBehalf capability word is part of your user profile.

Mass update

As an administrator, you can apply new capability words to a large group of users in a single operation. Follow the steps in Service Manager documentation that describes the mass update feature to apply a capability word to the user profile of a group of users.

Task 2: Synchronize the timeout value

Service Manager administrators should make sure Service Request Catalog and Service Manager timeout settings match.

  • On the Service Manager server, if Service Manager uses a default installation path, open this file with a text editor:

    Windows:

    C:\Program Files\Micro Focus\Service Manager n.nn\Server\RUN\sm.ini

    Linux:

    /opt/..../MicroFocus/Service Manager n.nn/Server/RUN/sm.ini
  • On the Service Request Catalog server, open this file with a text editor:

    Windows:

     C:\...\src\WEB-INF\web.xml

    Linux:

    /opt/..../src/WEB-INF/web.xml
  • Verify the webservices_sessiontimeout value in the sm.ini file matches the session-timeout value configured in the web.xml file.
    • The sm.ini file should have a setting for webservices_sessiontimeout. Example:

      webservices_sessiontimeout:1800

      This value is expressed in seconds. (1800 seconds = 30 minutes)

    • The web.xml file has the <session-timeout> parameter set to 30 minutes by default.
      <session-config>
      	<session-timeout>30</session-timeout>
      </session-config>

      Note This value is expressed in minutes. (30 minutes = 1800 seconds). The minimum value allowed is 3 minutes (180 seconds).

  • If you change the value in the file, make sure you save the file.

Task 3: Start Service Request Catalog

When you complete all the basic configuration tasks, you are ready to start Service Request Catalog. Make sure the Service Manager server is running before you start Service Request Catalog.

  1. Start Apache Tomcat:

    Windows:

    Go to the Control Panel > Administrative Tools > Services dialog to start the Apache Tomcat service.

    Windows:

    Run /opt/...../apache-tomcat-9.0.x/bin/startup.sh

  2. Type this URL into a supported browser window:

    http://hostname.domainName:nnnn/src/

    In this URL, hostname.domainName is a placeholder for the fully qualified domain name of the Tomcat server, and :nnnn is the Tomcat port number on that server. The exact format of the URL depends on how you configured the path parameter when you installed Service Request Catalog.

  3. Log in with your Service Manager credentials.

Task 4: Perform optional tasks

There are a large number of optional task you may also wish to perform. The steps for these optional tasks are detailed in the Service Request Catalog Customization section. Therefore, for specific instructions on how to perform the following tasks, you should review that section.

The following list shows some of the most important tasks you may wish to consider after you have installed Service Request Catalog. Note that some tasks may require you to restart Service Request Catalog:

  • Enable Knowledge Management
  • Configure the default check out panels
  • Support other locales, including translating Service Request Catalog
  • Support multiple companies in Service Request Catalog
  • Branding for your organization

There are many other potential customizations that are described in the Service Request Catalog Customization section.