7.12. MAP servers

This chapter describes how MAP servers can be added to PxM and how to create MAP server groups.

The following topics are included in this chapter:

7.12.1. Prerequisites

We recommend first installing the MAP service on the MAP server and then entering a client secret of your choice that conforms to your company’s policy. Make a note of the client secret, as it will be required to add the MAP server to PxM. Once the MAP service has been successfully installed, you can add a MAP server to one or more PxM Virtual Appliance.

When adding a MAP server, you will need to be logged in as an administrator to the Windows Server where the MAP server service will be installed.

Note

For more information, see the MAP Server Installation Guide.

7.12.2. Adding the MAP server to PxM

  1. Within the Web Management Interface left-hand menu, under MANAGE, either:

    • Click MAP servers and then click the New MAP server button, or
    • To the right of MAP servers, click the Plus icon icon.

    The New MAP server window appears.

    Webui New MAP server window

  2. On the Details tab, edit the following settings:

    Heading Description
    Name MAP server display name.
    Address MAP server IP address.
    Checked box iconGenerate new client secret

    Deselect to provide your client secret in the space.

    As per our recommendation, the MAP service should already be installed and the client secret noted.

    Client secret The shared secret assigned to the MAP server.
    Checked box iconEnabled Indicates if the MAP server is enabled.
    Notes Additional information.
    MAP SERVER GROUP MEMBERSHIP Select each MAP server group you wish to add the MAP server to.
  3. Click Next.

  4. On the Create MAP server tab, wait while a connection test is made. PxM makes an API call to the MAP server to gather/update the MAP server information.

    Webui New MAP server create

    The connection test results will be displayed as follows:

    Status Description
    Usable Device icon Good PxM has successfully made an API call to the MAP server, which is required to gather the MAP server information.
    Unreachable Device icon Error PxM was unable to make an API call to the MAP server.

    Note

    To run the connection test again, click the Test button.

  5. Click Create. The MAP server is added to your PxM Virtual Appliance.

    Note

    Apply the same process to add the MAP server to multiple PxM appliances.

If you are upgrading a MAP server, remove the old MAP server entry:

  1. Go to the Manage MAP servers page.

  2. Right-click the old MAP server entry and select Delete.

    Note

    After removing the old MAP server entry, ensure that the users still have connectivity to their tools through the PxM Client.

To upgrade an existing MAP server setup, see Osirium MAP server upgrade instructions.

When a new user connects to a thick client application through a MAP server, the default behaviour is to create a local Windows user account and profile on the MAP server for the session. This local user account will be used each time the user logs on.

As an alternative, you can arrange to have the MAP server use your Active Directory accounts. For more information, see the Osirium Support article, How to: Choose the right account for your MAP tool.

7.12.3. MAP server detail page

The MAP server detail page allows you to manage MAP server configurations, check the connection status to the MAP server and add it to MAP server groups.

To view the MAP server detail page:

  • From the left-hand menu, under MANAGE, click MAP servers.
  • Within the MAP servers tab, click a MAP server Name.

WebUI MAP server Detail window

Click the Edit pencil icon icon to edit the following details:

Heading Description
Name MAP server display name.
Address MAP server IP address.
Checked box iconEnabled Indicates if the MAP server is enabled.
Notes Additional information.

To save changes, click the Save icon icon.

Connection test

The CONNECTION TEST area provides details of the MAP server and the number of user connections available.

The Check Status button makes an API call from the PxM server to the MAP server and provides one of the following statuses:

Status Description
Usable Device icon Good PxM has successfully made an API call to the MAP server, which is required to gather the MAP server information.
Unreachable Device icon Error PxM was unable to make an API call to the MAP server.

MAP server groups

To add the MAP server to MAP server groups:

  1. To the right of MAP SERVER GROUPS, click the Manage button. The Manager: MAP server groups window appears.

    Webui MAP server Groups Manage window

  2. Within the Manager: MAP server groups window, select the checkboxes for each MAP server group to be Included in the MAP server.

  3. Click Save changes.

7.12.4. Manage MAP server groups

A MAP server group is a collection of MAP servers that PxM uses to load-balance connections to tools. Each tool is assigned a MAP server group when added to a profile.

A MAP server group could be created to handle each tool or a selection of tools, negating the need to install each tool on every MAP server.

Groups are also useful for situations where a tool might require a certain combination of a thick client, .NET, Java, IE or similar. The combination can be installed on a collection of MAP servers, and they can all be added to the same group in PxM.

Different groups can be created to handle combinations required by different tools.

To manage MAP server groups:

  • On the left-hand menu, under MANAGE, click MAP servers. The Manage MAP servers screen appears.
  • On the Manage MAP servers screen, click the MAP server groups tab.

Webui Manage MAP server groups tab

The information presented in the table includes:

Heading Description
Name MAP server group display name.
Notes Additional information.
Counts

MAP servers: the number of MAP servers in the group.

Profiles: displays the number of profiles using the MAP server group.


7.12.5. Creating a MAP server group

To create a MAP server group:

  1. On the left-hand menu, under MANAGE, click MAP servers. The Manage MAP servers screen appears.

  2. Click the Plus iconNew MAP server group button. The New MAP server group window appears.

    Webui New MAP server Group window

  3. Fill in the following details:

    Heading Description
    Name The MAP server group display name
    Notes Additional information.
  4. Click Save.


7.12.6. MAP server groups detail page

The MAP server groups detail page page allows you to configure and group MAP servers.

To view the MAP server groups detail page:

  • On the left-hand menu, under MANAGE, click MAP servers. The Manage MAP servers screen appears.
  • Click the MAP server groups tab.
  • On the table, click a MAP server group Name.

Webui MAP server Group Detail window

Click the Edit pencil icon icon to edit the following details:

Heading Description
Name The MAP server group display name.
Notes Additional information.

To save changes, click Save icon.

To add a MAP server to the MAP server group:

  1. To the right of MAP SERVERS, click the Manage button. The Manager: MAP servers window appears.

    Webui MAP servers Manage window

  2. Within the Manager: MAP server groups window, select the checkboxes for each MAP server group to be Included in the MAP server.

  3. Click Save changes.

Associated profiles

Lists all the profiles the MAP server group has been used in. Clicking on a profile name will navigate you to the corresponding profile page.