Guide to installing mXrap for Client PCs

Hardware requirements

The minimum recommended requirements are:

  • Graphics card that supports OpenGL 4.0 or higher, with updated graphics drivers.
    • Note 1: We do not recommend Intel graphics cards as we have observed rendering and performance problems in the past.
    • Note 2: We have experienced problems with computers with “switchable graphics”, but this seems to be functioning correctly after updating graphics drivers.
  • Windows 7 or 10, 64-bit operating system
  • 8 GB of RAM (for sites with small data requirements)
  • 16 GB of RAM (for sites with larger amounts of data)

Support requirements

We are asking (within reason) that IT allow us to connect to engineer’s computers via Teamviewer for support purposes. Remote access is only needed “on demand”, which means we have no access unless the engineer explicitly gives us access. You can use the “Quick Support” version, which only allows connections while it is running and the engineer is there. This software is not installed on the machine (get it here). All but one of the consortium member companies allow Teamviewer OR some alternative, i.e. through VPN.

Please note that RDP is not an alternative as the engineer is not able to see the screen.  It is therefore not useful for training and does not facilitate troubleshooting where the engineer’s input is required.

Client PC Setup

All PCs that run mXrap need the following:

  • Updated graphics drivers.
  • Security (USB-key) dongle drivers installed:
    • If you have the Green Wibu Key, install the Wibu driver (with network options disabled – its an option during installation).
    • If you have the Silver Codemeter Key, install the Codemeter driver.
    • For information on where to get the drivers go here.
    • See below for more information on Codemeter setup.
  • Access to the “root folder”, where the mXrap data is stored.  This is usually either:
    • On a local disk drive (for single-user sites).
    • On a corporate network folder (for single and multi-user sites).
    • On a shared folder on another engineer’s computer (for multi-user sites).
    • On a shared folder on the ESG server (where the ESG server cannot access the corporate network).
  • Access to the data sources to enable data updating: 
    • IMS Seismic data:
      Read access to the IMS network drive, where .msrap_evp files are shared,
      IMS will set up a scheduled export to a read only shared folder.
    • ESG Seismic data:
      ESG data is exported directly to the “root folder”, so both the engineer and the ESG server will require access to the “root folder” location.
  • Install the latest version of mXrap software from here 
    • Choose the appropriate mXrap variant (older versions of mXrap require you to choose Codemeter (for Silver Codemeter keys) or Wibu (for Green Wibu keys), but newer versions of mXrap work with either key).
    • By default, it will install “per-user”, i.e. into AppData, but you can instruct it to perform a per-machine installation.
  • The user should have read/write privileges to the PC. This is needed to save data from the software to the hard drive.

Licence server (Codemeter in network-mode only)

Depending on the agreement with the mXrap consortium, a network licence may be set up.  The licence server will broadcast messages to all other computers on the same subnet.  If some computers are on a different subnet (or connected via VPN), each client computer can be configured to seek out the licence at a particular IP/hostname.


Licence client setup

  • Install the dongle drivers (see above).
  • For the Silver Codemeter dongle:
    • If it is used as a “network key” then it should just work when the computer is connected directly to the office network.
    • If the computer is used off-site and needs to connect to the office network key (via VPN), then:
      • Open the “Codemeter Control” program and press the “WebAdmin” button
      • In the displayed webpage, browse to:
        Configuration –> Basic –> Server Search List
      • Click Add and enter the IP or hostname
      • Hit Apply

Data server

There are no services for data.  All data is stored in one folder on any network drive.  The location on the network drive is generally detemined by the engineers.

Post installation setup

Once the drivers and mXrap are done, we can assist further with remote access through Teamviewer.  These last post-installation configurations are limited to gathering and restructuring data, and a quick audit of the system.