4. Upgrading the MAP server

This chapter provides instructions on upgrading the PxM MAP server to the latest version. The following topics are covered:

4.1. Prerequisites

  • To upgrade to the latest MAP server, your PxM Virtual Appliance must be upgraded to version 5.4.0 or higher.

    If your PxM Virtual Appliance is on version 5.3.3 or earlier, you can only upgrade the MAP server to version 5.3.1. Contact Osirium Support for the MAP server installation file and further details.

    Note

    For details on upgrading your PxM Virtual Appliance, see the PxM Virtual Appliance Upgrade Guide.

  • Create a backup of your MAP server.

4.2. New features

The newest MAP server introduces several features, including the following:

When adding a MAP server:

  • The MAP server shared secret can now be specified manually.
  • Several PxM Virtual Appliances can use the same MAP server.
  • Multiple PxM Virtual Appliances can use multiple MAP servers.

When provisioning a thick application device:

  • MAP server connections can now be configured to use Active Directory accounts by provisioning the thick application using a MAP template (requires an authentication service).
  • Personal user accounts are created on the MAP server the first time a user logs on. This allows each user to have a personal profile on the MAP server which is used each time they connect to a thick application.

Note

If you are using multiple MAP servers, Osirium recommends configuring MAP server groups with all MAP servers in the same group sharing the same secret key.

4.3. Upgrading the MAP server to use a client secret created by you

Client secrets cannot be updated for MAP servers that have already been added to PxM. To upgrade your PxM to use a client secret created by you:

  1. Copy the latest MAP server software to your current Windows MAP server.

  2. From your Windows Server, run the MAP server installation MSI file.

  3. Within the Welcome to the MAP Server Setup Wizard window, click Next.

    Map server Welcome screen

  4. Within the End-User License Agreement window, read and accept the License Agreement and click Next.

    Map server EULA

  5. Within the Destination Folder window, select the folder you want to install the MAP server to or accept the default and click Next.

    MAP server folder

    Note

    If installing to a location different to where the MAP server was previously installed, the files in the old location will be tidied up.

  6. On the Enter your shared secret window, uncheck the Use existing shared secret. checkbox.

    MAP Server shared secret unchecked

  7. In the Shared secret field, enter a shared secret of your choice.

  8. Finish the installation.

  9. On the PxM server, the MAP server will have to be added again and the old entry deleted. Before deleting the entry, make a note of the groups the MAP server belongs to. This is important, as groups are used in profiles to allow users access to the MAP tools.

Note

For further details, see Adding the MAP server to PxM in the PxM Administrator’s Guide.

4.4. Upgrading the MAP server using the current shared secret

To upgrade your MAP server:

  1. Copy the latest MAP server software to your current Windows MAP server.

  2. From your Windows Server, run the MAP server installation MSI file.

  3. Within the Welcome to the MAP Server Setup Wizard window, click Next.

    Map server Welcome screen

  4. Within the End-User License Agreement window, read and accept the License Agreement and click Next.

    Map server EULA

  5. Within the Destination Folder window, select the folder you want to install the MAP server to or accept the default and click Next.

    MAP server folder

    Note

    If installing to a location different to where the MAP server was previously installed, the files in the old location will be tidied up.

  6. Within the Enter your shared secret window, ensure Use existing shared secret. is selected.

    MAP Server shared secret

    Note

    To upgrade the MAP server to use a client secret created by you, see Post-installation.

  7. Click Next.

  8. Within the Add Logging Server window, if you want logs to be sent to a Syslog server, enter your logging server details.

    MAP server add logging server

  9. Within the Ready to install MAP Server window, click Install.

    MAP server Ready to install

    The MAP service is installed.

  10. Within the Completed the MAP Server Setup Wizard window, click Finish.

    MAP server completed setup

  11. Within the MAP Server Setup window, click Yes to restart your system for the changes to take effect.

    MAP server restart

    Your upgrade is now complete.

Note

To check the status of your MAP server in the PxM Web Management Interface, see MAP server detail page in the PxM Administrator’s Guide.

4.5. Post-installation

The latest version of the MAP server facilitates the creation of personalised accounts and profiles on the MAP server when a user connects to a MAP application tool. Therefore, the 50 MAP user accounts and Windows profiles created in previous releases are deemed redundant.

User accounts will start with: ms_user_[randomly-generated unique ID] and can be found in the Local Users and Groups > Users folder on your Windows MAP server. These can now all be deleted, as they are no longer used by PxM.

MAP server Computer Management

Local user profiles for each of these accounts that would have been created when a user connected through PxM can also be deleted. These can be found in: C:Users on your Windows MAP server.