Installing the PxM MAP Server

This section covers:

Installation process workflow

The following diagram illustrates the process for installing the MAP server.

MAP Install Process Flow

Software download

The installation file is supplied as an MSI, ready for deployment onto a Windows Server.

Note

The installer is now only available in 64-bit. However, PxM still supports existing 32-bit MAP server configurations.

To download the latest MAP server installation file, for use with PxM 5.4.0 or above:

  1. Go to the PxM MAP Server Installer download page section of the Software Releases page.

  2. From the table, download the installation file and copy to the Windows Server that will host the PxM MAP server.

    A SHA256 checksum is available to verify the download integrity.

To download the PxM MAP Server installation file for versions of 5.4.0 or earlier, contact Osirium Support.

Further details on MAP server compatibility with earlier versions of the PxM Platform can be found on the PxM versions and MAP installer compatibility table.

Installation procedure

The following steps guide you through deploying a PxM MAP Server service on an existing Windows Server:

  1. Within the Windows Server, run the PxM MAP Server installation file. The MAP Server Setup window appears. MAP Server Setup Welcome wizard

  2. Click Next.

  3. Within the End-User License Agreement window, read and accept the license agreement. MAP Server EULA

  4. Click Next.

  5. Within the Destination Folder window, accept the default folder location or specify a location of your choice. MAP Server folder

  6. Click Next.

  7. Within the Enter your shared secret window, specify a shared secret. We suggest noting the shared secret because it will be required later, when adding the MAP server to PxM through the Web Management Interface.

    MAP Server folder

    Note

    The same shared secret can be used for multiple MAP server installations.

  8. Click Next.

  9. To enable the MAP server to send logs to a syslog server:

    • Within the Add Logging Server window, select Setup Log Server?.
    • Provide your Server Address and Server Port details.

    We recommend using your PxM Virtual Appliance as your syslog server so you can view syslog messages in the Web Management Interface. See Administrators Guide > Logs

    MAP Server logging

  10. Click Next.

  11. Within the Ready to install MAP Server window, click Install. The installation process begins.

    MAP Server ready to install

  12. Within the Completed the MAP server Setup Wizard window, click Finish.

    MAP Server finish installation

    Note

    The MAP server service log file will be stored in the following location: C:\Windows\Logs\MapServer\service.log

  13. Within the MAP Server Setup window, click Yes to restart your system.

    Restart

Installing using command parameters

If you prefer to install the PxM MAP Server MSI package using command line parameters (or using automated deployment technologies) then the following command line parameters will help you:

The PxM MAP Server MSI package can be installed at the command line (or using automated deployment technologies) using the following parameters:

Parameter Example Description
INSTALLFOLDER C:Program Files (x86)Osirium PxM MAP Server The directory to install the PxM MAP Server software to.
SHARED_SECRET dsfg87dfg7a54sdg8sdf57dsghfdgh The shared secret is used between the PxM Virtual Appliance and the PxM MAP Server.
USE_LOG_SERVER 1 Turns on remote logging via syslog.
LOG_SERVER_ADDRESS 1.2.3.4 Target server for remote logging syslog. This is typically a PxM Virtual Appliance.
LOG_SERVER_PORT 514 Target server syslog port. The default for this is UDP 514.

These parameters can be used as follows:

1
Osirium_PxM_MAP_Server_v6.4.1.2_x64.msi /q /norestart /l C:\install.log INSTALLFOLDER="C:\Program Files\Osirium *PxM MAP Server*\" SHARED_SECRET=abc123 USE_LOG_SERVER=1 LOG_SERVER_ADDRESS=1.2.3.4 LOG_SERVER_PORT=514

Note

Although the /norestart switch has been used here, the PxM MAP Server does need a reboot to properly complete the install.

Next steps

Once the MAP Server has been installed you will need to do the following:

  • Ensure the required thick client applications are installed on the PxM MAP Server.

  • Add the PxM MAP Server to the PxM Virtual Appliance(s) that will be using it.

To add the PxM MAP Server to your PxM Virtual Appliance:

  1. Open the Web Management Interface.

  2. Click on the MAP servers option in the left-hand menu.

  3. Click on the MAP server group tab and create your PxM MAP Server groups first.

    See Administrators Guide > MAP server groups.

  4. Click on the MAP Servers tab and add a new MAP server.

    See Administrators Guide > Adding the MAP Server to the PxM Virtual Appliance.

  5. Provision the thick application using a device template compatible with MAP server.

    See Administrators Guide > Managing devices.

  6. Create a profile to give users access to the thick application. When selecting the MAP tool ensure a MAP Server Group is selected within the Options field.

See Administrators Guide > Managing devices.

The thick management application tool is now setup and can be single signed on by users through the PxM Client interface.