4. Upgrading the MAP server
This chapter provides instructions on upgrading the PxM MAP server to the latest version. The following topics are covered:
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.
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.
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:
Copy the latest MAP server software to your current Windows MAP server.
From your Windows Server, run the MAP server installation MSI file.
Within the Welcome to the MAP Server Setup Wizard window, click Next.
Within the End-User License Agreement window, read and accept the License Agreement and click Next.
Within the Destination Folder window, select the folder you want to install the MAP server to or accept the default and click Next.
If installing to a location different to where the MAP server was previously installed, the files in the old location will be tidied up.
On the Enter your shared secret window, uncheck the Use existing shared secret. checkbox.
In the Shared secret field, enter a shared secret of your choice.
Finish the installation.
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.
For further details, see Adding the MAP server to PxM in the PxM Administratorâs Guide.
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.
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.