1. Revisions

1.1. Changes in version 20.0

1.2. Changes in version 19.0

1.3. Changes in version 17.0

  • Restyled the entire manual

  • Log was reworked (see Server log)

  • Improved installation chapter (see Installation)

  • Improved Screenshots

2. Symbols


This paragraph contains additional information for the reader.


This paragraph contains additional tips for the usage of the product.


This section contains warnings that can occur when the application is not used correctly.


This paragraph tells the user that the application must be used carefully.


This section includes important information for the usage of mRay.

3. Manufacturer

mRay 6.0
Radiological image viewer for mobile devices with image processing functions
© 2020 mbits imaging GmbH

icon manufacturer

mbits imaging GmbH
Bergheimer Straße 147
D-69115 Heidelberg

ce sign

3.1. UDIs

mRay Server Windows


4. Intended Purpose

The software mRay as a radiology instrument can be used by medical specialists for the visualization of image data. Image processing allows the calculation and visualization of healthy and abnormal tissues.

5. Intended Use

5.1. General

The patient group, for which mRay can be used, includes all patients from whom radiological image data has been created for the purpose of diagnosis or treatment. In a worst-case scenario the medical condition of the patient may be critical.

mRay can be operated in hospitals, medical practices, on the go or at home. The software is dedicated for mobile devices for fast and immediate access to radiologic images for informational purposes. When using mRay for diagnostic purposes, national regulations must be considered and an appropriate display must be used. mRay allows the display of images and data types that are defined by the Digital Imaging and Communications in Medicine (DICOM) standard (e.g. computed tomography (CT), magnetic resonance imaging (MRI), positron emission tomography (PET), fluoroscopy (XA), digital x-ray (CR), ultrasound (US)). The software offers common radiological software tools (e.g. windowing, measurements, thick slices and annotations).

Furthermore mRay is capable of performing image processing tasks such as finding, visualizing and quantifying anomalies in tissue. In particular the image analysis module mRay VEOcore may be used to perform an automated processing of brain images from imaging modalities such as CT, CT-Perfusion, or MRI including a Diffusion Weighted MRI (DWI) Module. As a result, changes in contrast over time are visualized as colored perfusion maps, including flow related parameters and tissue blood volume quantification.

5.2. Contra-indications

mRay may not be used in Germany on a calibrated mobile device if reporting has to be performed for a x-Ray image (CR) or mammography (MG). Reporting may be performed on a regularly calibrated monitor ("Bildwiedergabegerät") with the mRay software.

5.3. Medical benefits

If mRay is used for viewing medical image data it can be used in the decision process for diagnosis and therapy. The following functionalities allow to do so.

To examine findings in CT images mRay Client is able to visualize images in accordance to the DICOM Grayscale Standard Display Function. By doing so a suitable mobile device is acting as a "Bildwiedergabesystem mit Befundqualität" in accordance with the DIN 6868-157. The constant availability of mobile devices results in time savings compared to stationary solutions.

The perfusion analysis of brain imaging data visualizes and quantifies tissue that is less supplied with blood (penumbra), oxygen deprived tissue caused by obstructed blood flow (core tissue) and the mismatch ratio between the two. The calculated values can be used to support decision making based on an assessment of the extent of tissue damage.

5.4. Warnings

  • mRay may not be used on a mobile device (tablet, smartphone or notebook) in a room containing a Magnet Resonanz Tomographie (MRT) scanner.

5.4.1. Notes for use in diagnosis findings

For the use of mRay in the diagnostic context on mobile devices according to the German legal regulations (QSRL, DIN 6868-157), the instructions under the link must be followed: https://mbits.info/downloads/mRay-Nutzungsanweisungen_Befundung.pdf.

When operating mRay on a Windows PC or Mac, the image display system (BWS) must be calibrated and approved accordingly. Restrictions with regard to the modalities must then be derived from the BWS.

6. Introduction

In order to manage and configure the mRay server application, there are three software tools:

  • The mRay server application to start or restart the server, install a service, to set the port of the server through which clients communicate with the server and to install the license file.

  • The mRay Configuration application to configure the server and to manage data access, users and groups.

  • The mRay Gateway application allows to setup external access points for an mRay server without opening or forwarding ports in the internal network.

The following sections describe the individual functions of these applications.

7. Installation

7.1. Initial installation

This paragraph applies only to the Windows-installation.

Run the downloaded setup routine (named, for example, 'mRayServer-5.5-win64.exe').

First Administrator rights are requested. Please note that the installation routine only needs those rights in order to install in the default folder 'C:\Program Files\mRay Server'. Please accept the dialog, no other modifications will be made to the system.

In the rest of the process, please follow the instructions of the installer program. During installation, the Visual Studio runtimes need to be installed, i.e. also on a newly installed server system all you have to install is contained in our installer package.

At the end of the installation the server application is automatically started and installed as a service.

7.2. Update

To perform an update just run the setup executable, which will detect any running mRay instances and ask you to close those. The existing data will not be deleted or overwritten. After the update is complete mRay Server will restart itself automatically.

New features require an update of your license file in order to be activated. Please consult the support of the installation.

7.2.1. Reinstallation / Future updates

In case of an update or a new installation, you can simply run the installer package (again). This will first try to uninstall the existing version (see Uninstall old version dialog). Afterwards, a normal installation is performed as described above. Note, however, that the uninstall process can delete existing data when requested. Please read the following subsection carefully.

1 1
Figure 1. Uninstall old version dialog

7.3. Uninstall

The uninstaller removes the currently installed version of the software. Please be nevertheless careful that you do not accidentally delete the existing data in this step unless you explicitly want to do so.

8. mRay server

The application mRay Server starts or stops the server process. In addition, a port can be set to under which the server is available. The server can be started as an ordinary application or automatically via a Windows service. We recommend to start the server via a service. This ensures that your server is restarted automatically in case of an unexpected system restart. Addtionally, no logon is required to restart the server. In a separate chapter 'Server Execution Models' you can learn more about the service installation process. The application can be seen in Server application dialog:

Figure 2. Server application dialog
  1. Checkbox for starting or stopping the server process.

  2. Configures the server communication port.

  3. Starts the mRay Configuration application.

  4. Opens the Admin Manual.

  5. Shows the server version, the intended use and license terms.

  6. You can switch between two different server execution models (application and service) over this button (more about that in chapter 'Server Execution Models').

9. License installation

To use mRay Server without any restrictions you need to obtain a license and activate it via the mRay server configuration. You can get a license by contacting your contractor. The following steps are required to do an activation:

license missing
Figure 3. Product license registration dialog
Figure 4. About dialog
  • Run the newly installed mRay server application.

  • A popup appears (see Product license registration dialog) which prompts you to install a license. It also shows you additional information such as:

    • License status: Displays how long your license is valid.

    • Registration key: This key needs to be submitted to your contractor to obtain an activation key.

  • Now it is time to get in contact with your contractor and to send him your registration key. After he has received your key, he will send you back an activation key.

  • Now go back to the mRay Server application window and click the' Configuration' button.

  • The mRay Server configuration opens. Now log on to the server with the "admin" account via the configuration. Please note the server text field, which specifies the target address of the server to which you want to connect and install the license. In the case of a remote license installation, this field may need to be edited.

  • After successful login please click on the "About this mRay server" button, which opens a dialog with the title bar "About mRay". This allows you to install a license (see About dialog).

  • With the reception of your activation key you are ready to activate the server by installing it via the 'Select license file' button. When you click on the button a file explorer opens which prompts you to input the path to your license file.

  • If the license file is valid you can now proceed to start and configure your server. If not, the mRay server application automatically closes and you will be prompted again to install a license after you restarted the mRay server application.

The same procedure is valid for a reactivation of your license which is needed in case of a license prolongation or a booking of additional modules. Since you are not prompted automatically again to activate your server, you need to open the reactivation dialog manually. You can access it via the "About" dialog of the mRay Server configuration. To do this, click on the "About" button after you have logged in as "admin" via the configuration on the server. Please click on the button labeled 'Change license'. Now, the activation dialog explained previously opens again. From there you can proceed with the steps described in the last section.

10. Server execution models

There are two different execution models of the server. The first one is to execute the server as an ordinary application. To run the server in this mode two requirements need to be met: You need to keep the mRay server application window open and the checkbox 'start on port' must be checked. A disadvantage of this execution model is that the server will get and be kept deactivated if the mRay server application is closed accidentally or the system restarts unexpectedly unless the server is restarted again manually.

The second execution model is to install the server as a service. With this model you do not need to keep the mRay server application window open and the server restarts automatically if the system restarts. Furthermore a login at the logon screen is not required.

To switch between both modes you can to click on the button labeled 'Install as service' or 'Uninstall service' within the mRay server application. 'Install as service' installs the service as a service application (second mode) whereas 'Uninstall service' runs the server as an ordinary application (first mode). The button labeling is alternating.

A service is not allowed to access a network drive unless the affected host system (computer name) is listed in the ACL (access control list) of the network drive. An alternative is to run the service under a different account as opposed to the LocalSystem account which is authorized to access the network drive. Please ensure that the account has full access to the application data of mRay (C:\ProgramData\MBITS\mRayServer) and to all of the registered folders in the configuration.

11. mRay Gateway

The mRay gateway offers a connection forwarding for mRay clients to a mRay server where the clients may have no direct access to the mRay server itself e.g. if you are running your mRay server in a closed network.

In order to install the gateway application, run the 'mRayGateway-5.5-win64.exe' and follow the install programs instructions.Wait until the installation process has completed and run the gateway application.

Figure 5. Gateway window

The gateway launcher offers a small user interface to configure the application.

  1. Run gateway: Toggle to run or stop the gateway process.

  2. Client port: The port used by mRay clients to connect to the gateway.

  3. Server port: The port used by the mRay server to connect to the gateway.

  4. Install as service: Installs the mRay gateway as a Windows service.

To connect your mRay server to the gateway installation, enter the address of the gateway with the port of the gateway in the mRay configuration like it is shown in General Settings (see Configuration settings).

12. mRay Configuration

The mRay Configuration application is used to manage the server system (see Configuration status). You can change general settings, pool, users, groups and monitor the server process. Please log in with an administrator user in order to make adjustments.

12.1. Connection window

The connection window (see Configuration status) is used to connect to the server:

config status
Figure 6. Configuration status
  1. The network address including the port of the server you want to connect to

  2. Enter your administrator login name (default name is 'admin' ) here.

  3. Specify the administrator password that you received by your mbits contact. The password should be changed after the first login.

  4. If everything is correct, you can connect to the server using the Connect button.

12.2. Configuration window

The Home screen (see Configuration connection section) contains the general configuration tabs, which are explained in the following sections:

config connection
Figure 7. Configuration connection section
  1. Status: Displays the current status of the server and other internal information.

  2. Settings: Make general, globally applicable settings to the server.

  3. E-mail SMTP: Here you can set up an outgoing e-mail server (SMTP) to send important messages via e-mail from mRay Server (e. g. PIN messages, expiring licenses, etc.).

  4. Pools: A Pool corresponds to a DICOM node on the network. Pools contain user access rights for different data sources.

  5. Users: Create, manage and delete users.

  6. Groups: Create user access and chat groups.

  7. Log: Displays the server log.

  8. Advanced: You can adjust advanced settings here.

12.3. Status tab

The Status tab (see Configuration status with PIN information) shows license information, free space on the server and other internal information:

config status pin
Figure 8. Configuration status with PIN information
  1. Shows the users PIN’s if LDAP is active.

  2. Opens the About dialog for the connected server that displays information about the manufacturer, used licenses, certification, etc. for the product and allows you to install updates or a license.

  3. Opens the report generation dialog (see Generate statistics).

  4. Activating the checkbox displays additional internal information of the server process.

  5. Activating the checkbox pauses the information pane to be updated continuously.

13. General settings

This tab can be used to change various global settings (see Configuration settings).

config settings
Figure 9. Configuration settings
  1. If checked the server can also be configured from a remote computer. Note: If your server is reachable from the internet, choosing this option will enable server configuration from any computer. Pay attention to provide a strong administrator password (min. 8 characters with uppercase and lowercase characters and numbers).

  2. This checkbox activates the automatic deletion of the oldest records if the free memory falls under the provided limit on the installation disk. This ensures that the server is always ready for use. Please note that no data will be deleted from the PACS or similar, only the cached and encrypted DICOM data of the mRay server will be removed.

  3. Specifies the desired free space in gigabytes if automatic deletion is activated.

  4. If checked, the server uses an alternate working mRay path to store data like the cached and encrypted DICOM files there.

  5. Set the alternate working folder. If enabled, the application data of newly created pools are stored within that path.

  6. Choose which devices of a user do instantly get access without permission of the administrator.

  7. If checked the server will connect to the gateway URL given in the input field. Input field: Set the address of the mRay Gateway installation the mRay Server should connect to. Make sure that the specified URL includes the port of the gateway. If you want your mRay Server to connect to multiple gateways you can specify their addresses by using a semicolon as a separator. For example: demo.mray.info:35000 or heidelberg.mbits.info:34999;test.mray.info:35001

  8. If enabled, set the settings for the LDAP connection.

  9. Fill in your IP address or server URL in this input field. If the server needs to be contacted via a special port you need to append a colon followed by the port. For example: ad.mbits.info:40000 bzw.

  10. Fill in the domain which contains the users and groups. This input field is optional. If it is empty, the domain will be requested from the LDAP server. By setting the option "LDAP - Domain is DN" unequal 0 in the advanced options the fully qualified domain needs to be specified (e.g. dc=ad,dc=example,dc=com).

  11. Insert your username here (optional in case of an anonymous login). By setting the options "LDAP - Username is DN" and/or "LDAP - Domain is DN" unequal 0 in the advanced options the fully qualified username needs to be specified. (e.g. cn=ldapuser,dc=ad,dc=example,dc=com).

  12. Insert your password here.

  13. Here you can input the time interval to synchronize with the LDAP server.

  14. Press this button to synchronize the LDAP server immediately. Please note that all changes within the settings will be applied.

  15. Shows the current synchronization state.

  16. Here you can choose, which groups and their users will be stored in the user and groups directory of the mRay server.

  17. With this input field you can search for special groups.

  18. Apply the changed settings. Note: Changes to the fields 1-7 must always be confirmed with this button.

  19. Revert the changed settings.

For the integration scenario 'mRay server with worldwide access' you can configure the server worldwide with the mRay configuration and internet access. Please be cautious to use a strong administrator password (at least 8 characters, upper/lower case and digits).

Please note that if you have activated the LDAP synchronization (see point 8), you must also configure an existing sender e-mail account (see chapter Email SMTP). This is required to send an automatic PIN notification to an mRay LDAP user to be authenticated if requested. A new PIN request is usually made in the case of a first authentication or a password change.

The expire time of a PIN that is requested by an LDAP user can be manually set using the Advanced options using the 'LDAP - Time after PIN expires' setting.

Changes need to be confirmed before they are applied.

14. Pool management

The Pool Tab (Pool list) lets you create, edit and delete „pools“:

config pools
Figure 10. Pool list
  1. Adds a new pool.

  2. „Edit“ or double clicking a pool will open the edit dialog.

  3. Deletes the selected pool.

  4. Filter the pool list using free text.

  5. This button will only be shown if your license includes the PACS upload feature. This features enables structured reports, presentation states and photos to be stored in a PACS. Push this button to open the PACS Upload Pool settings. You can enter your PACS address, port and AET in the dialog. Note that you may need to enter the upload pool as a DICOM send entity in your PACS (depending on the PACS software).

  6. Press this button to edit the share pool settings. This pool is used to host shared data. If your license doesn’t include the PACS upoad feature then all datasets created on client devices (i.e. structured reports, presentation states and photos) will be stored in this pool. Otherwise only internally shared presentation states will be stored in the share pool.

There are three different types of pools: Network Nodes, Query/Retrieve pools and External DICOM Folders.

14.1. Network node pool

A Network node pool is equivalent to a regular DICOM node (see Network node pool configuration).

config pool network
Figure 11. Network node pool configuration
  1. Select which type of pool you want to create:

    • Network node: Represents an ordinary PACS node to which you can send data from a PACS.

    • Query/Retrieve: Represents a pool with which you can send search queries to a PACS.

    • External DICOM folder: Access to an abitrary folder.

  2. Specify a name for the pool. The checkbox lets you activate or deactivate the pool (without deleting it).

  3. If activated, a different working path for the new pool can be specified where all data is stored. This will overwrite the general setting on the working path (if set). Please note, however, that the settings concerning free space and limits will apply to that path.

  4. Enables a DICOM C-Store SCP listener through which you can send DICOM data from your PACS to your pool. A TCP input port and an application entity title (AET) for the DICOM C-Store SCP listener must be set for this pool.

    • Please note: You have to add the specified AET and port of the mRay server to your PACS configuration. Otherwise you will not be able to send images to mRay.

    • A possible connection error while sending image data from a PACS workstation to the mRay server, cannot be detected by mRay.

  5. Activates the temporary storage of already retrieved or transmitted datasets, which speeds up a later search for these datasets. When this option is activated, new incoming datasets are not automatically placed in the user’s inbox, but must first be moved to the inbox via the search tab.

  6. Let’s you specify a limit of datasets that this pool can contain. Use this option to limit the entries that will displayed to the users within the client application.

  7. Delete incoming datasets from the server after the specified number of days. You can also enter floating-point numbers (e.g. „2.5“).

  8. „Zero Footprint Mode“ enforces a deletion of data immediately after viewing it on the client. Choosing this option will disable functions 8 and 9.

  9. Let’s you specify how long local data on the client app will be available.

  10. Activates/deactivates the “auto download” feature. If enabled here and in the client app, incoming datasets will automatically be downloaded to the client app.

  11. Activates/ deactivates JPEG Compression for this pool.

  12. The mRay server can optionally remove patient information from incoming image data (“Pseudonymization”). Warning

Burned-in information cannot be removed. Please ensure, that there is no personal information directly encoded in your images when using this feature.

JPEG compression is only supported for images with maximum 12 bits and lossless compression is only supported for images with maximum 16 bits.

14.2. Query/Retrieve pool

A Query/Retrieve Pool is created to search a PACS from within the client app (see Query/Retrieve pool configuration).

config pool qr
Figure 12. Query/Retrieve pool configuration

Any function already described in 'Network Node Pool' will not be explained. These are the different form fields to consider:

Specify first the local port and the AET for the mRay server (i.e. the AET which will receive answers from your PACS). On the second line specify the connection details of your PACS. Status field containing potential errors. Creates the pool. Abort Creation of the pool. Notice You have to add the specified AET and port of the mRay server to your PACS configuration. Otherwise the connection will not be accepted by your PACS.

14.3. External DICOM folder pool

An external DICOM folder (see External DICOM pool configuration) imports dicom data from a local directory.

config pool dicom
Figure 13. External DICOM pool configuration

All other fields are explained in chapter 'Network node pool'.

Specify the external directory containing DICOM data here. Info The external DICOM folder pool also supports non DICOM file types i.e. PDF, PNG, JPG, TIFF, TGA and BMP

15. User management

The Users tab lets you add, edit and delete users (User list).

config users
Figure 14. User list
  1. Add a new user.

  2. Edit the selected user. Or double click the user item in the list.

  3. Delete the selected user.

  4. Filter the users list using free text.

15.1. Create and edit users

After clicking “add” or “edit” the user dialog will come up (Manual users: see User configuration, LDAP synchronized users: see LDAP user configuration).

config user settings
Figure 15. User configuration
config user ldap settings
Figure 16. LDAP user configuration
  1. Specify the login name.

  2. Complete name of the user (will be shown to others in chat-rooms).

  3. Enter and confirm the password for the user.

  4. These entries will appear depending on your server license modules.

  5. Enable PACS upload: enables the automatic upload of DICOM datasets for this user. This effects the creation of Structured Reports and Key Images. Sharing of KeyImages in messenger will not be effected.

  6. Enable photo capturing: enables the capturing of photos as a DICOM series (wounddocumentation) for this user. This effects the photo button in the inbox.

  7. Choose whether this user is allowed to use the messaging feature.

  8. Allows a user to share a dataset with other users who have no access to the related pool.

  9. The devices list cannot be edited by hand. It lists all device IDs with which the user has been registered. By selecting/deselecting the checkbox of a device ID access can be allowed/prohibited a user’s device.

  10. Deletes a selected device.

  11. Check all pools the user should have access to.

  12. Error messages.

  13. Applies the changes.

  14. Cancel changes.

  15. Enables or disables the user (Disabled users can not connect to the server).

  16. Alternate e-mail address(es). Will be preferred against LDAP mail (see point 18) in case of e-mail notifications. You can use the semicolon separator (;) to specify multiple e-mail addresses.

  17. DN (short: distinguished name), i.e. unique identifier within the LDAP directory, of the synchronized LDAP user.

  18. LDAP synchronized e-mail address of an LDAP user. Is used for the automatic dispatch of important e-mail notifications from mRay. Can be overwritten by an alternative e-mail address (see item 16).

  19. Triggers a new PIN request for a user, so that the most recent LDAP password is queried again (for example, in case of password change).

Please take care of the characters used for the password as they might not be available on the keyboard of a mobile device.

Manual users can still be maintained and used alongside LDAP synchronized users.

16. Group management

The Groups tab (see Group list) lets you manage user groups. You can grant access to certain pools for a group of users at the same time. Furthermore, a group also represents a chat-room within the client app (if enabled).

config groups
Figure 17. Group list
  1. Adds a group.

  2. Edit the selected group. Alternatively double click on the group item in the list.

  3. Delete the selected group.

  4. Search the group list using free text.

16.1. Add or edit groups

The group dialog (see Group configuration) will show up after clicking add/edit in the groups tab.

config group settings
Figure 18. Group configuration
config group ldap settings
Figure 19. LDAP group configuration
  1. Provide a name for the group. Please note that this will also be the name of the chat-room.

  2. Enable PACS upload: enables the automatic upload of DICOM datasets for this user. This effects the creation of Structured Reports and Key Images. Sharing of KeyImages in messenger will not be effected.

  3. Enable photo capturing: enables the capturing of photos as a DICOM series (wounddocumentation) for this user. This effects the photo button in the inbox.

  4. Enable photo documentation: enables the photo documentation feature for this user. This effects the photo button in the inbox.

  5. Enable/disable messaging for the group. If disabled no chat-room will be created.

  6. Enable access rights of the group for one or several pools.

  7. Add users to the group or remove them.

  8. Enables or disables the Group. (Disabled groups are not connected to the server).

  9. Apply changes.

  10. Abort changes.

17. Server log

The Log tab displays the last lines of the server log (see Server log). The log is the most important tool for tracing errors. To get access to the complete server log use the 'Export server log' button.

config log
Figure 20. Server log
  1. View verbose informations inside the log

  2. Export the protocol to a file.

  3. Search for specific log messages

  4. Filter the entire log output

  5. Specify a date range from when the log should be displayed

  6. Filter the type of logging entries you want to see

18. Email SMTP

In the "E-Mail SMTP" tab you can store an e-mail account and a corresponding mail outgoing server. This is used to send e-mail notifications to users of mRay. An example is the automatic PIN notification with activated / licensed LDAP user synchronization.

config smtp
Figure 21. E-Mail configuration
  1. IP or name of the outgoing mail server to which the mails are forwarded for dispatch.

  2. Port of the outgoing mail server (optional). This can vary depending on the security setting of the connection (see point 3).

  3. Security setting / encryption regarding the communication link between mRay and the outgoing mail server. The following options are available: None = Unsecured connection (default ports: 25, 587), SSL / TLS = Secure connection (default port: 465), STARTTLS = Unsecured connection with upgrade to a secure connection (default ports: 25, 587).

  4. E-mail address of the sender via which the notifications or e-mails are sent.

  5. Username of the sender’s e-mail account for logging on to the outgoing mail server.

  6. Password of the sender’s e-mail account for logging on to the outgoing mail server.

  7. Checks the connection and logon data against the outgoing mail server.

  8. Optional e-mail addresses of the administrators who are to receive important notifications regarding the operation of mRay (e.g., reporting on outgoing PIN notifications to users). Using the semicolon separator (;), you can specify several e-mail addresses.

19. Remote Auto-Update

Since version 5.3, you can also use the "About" dialog of the configuration to install server updates via a remote computer. To do this, go to the Update tab of the configuration "About" dialog.

config update
Figure 22. Remote update
  1. Shows the currently uploaded mRay Server Installer version. This is only displayed if it is a valid and supported installer.

  2. Uploads the preselected mRay Server Installer.

  3. Starts the currently uploaded mRay Server Installer to update the server.

20. Generate statistics

This dialog can be used to generate statistical reports about the usage of mRay.

config report generation
Figure 23. Generate usage statistics
  • Allows the selection of report types

  • Select export folder

  • Specify the time range for which the report should be generated

21. Advanced options

In addition to the default settings that you make through the graphical interface of the mRay Configuration application, there is an advanced options tab which allows to customize server and client behaviour.

config advanced
Figure 24. Advanced options list
  1. Title: Shows a human readable name of the option.

  2. Value: Shows the Value of the option.

  3. Value: values displayed in black are default values, the green ones are customized.

  4. Filter: Use free text to find an option.

  5. Restart Server: Restarts the server automatically.

Any change in the advanced options tab reqires a restart of the server application to be applied.

In order to edit an option, double cklick on its row to open the edit window.

config advanced entry
Figure 25. Advanced option configuration
  1. Description of the option.

  2. Default value (can change between mRay versions).

  3. Current value (grey means empty/default).

  4. Reset the value to its default.

  5. Apply the value and close the window.

  6. Do not change the value and close the window.

22. Photo Documentation

The photo documentation feature is expressly not permitted to be used for diagnosis or treatment decisions. The feature is only available for evaluation purposes. To take part in the evaluation and use the photo documentation feature please contact the mbits support team. You may need an mRay server license that has the feature enabled and the following settings to be configured properly:

22.1. Advanced Options Tab:

  1. "PhotoDoc-Tagging Entries Specification": Entered in advanced tab and specifies a tagging model in the JSON format that will be displayed on the client side

  2. "PhotoDoc - Export path": Specifies a folder that will be used by the server to export completed orders. Those orders are then picked picked up by the backend.

22.2. User/Group-Options:

  1. Enable photo capturing: Must be enabled so the photo capturing feature is available for the given user or group.

23. System requirements

23.1. Server

The following operating systems were tested and approved for the server application:

  • Windows Server 2016

  • Windows Server 2019

The hardware has to meet the following minimum requirements:

  • CPU: Quadcore (x86 64bit)

  • RAM: min. 8 GB

  • HDD: 512 GB or more, SSD preferred

When VEOcore was added there are the following additional requirements:

  • CPU: +1 Core

  • RAM: +4 GB

23.2. Gateway

The following operating systems were tested and approved for the gateway application:

  • Windows Server 2016

  • Windows Server 2019

  • Windows 10

  • Ubuntu 18.04

  • Debian 10.2

The hardware has to meet the following minimum requirements:

  • CPU: Dual core x86 64bit Processor

  • RAM: 1GB

  • HDD: 32GB

24. Security recommendations

  • Please make sure you keep device operating system up to date.

  • Always use the latest version of the mRay Server.

  • Forward only the ports required by the mRay Server.

  • Use a virus scanner (which might need configuration for the mRay Server)

25. FAQ

25.1. Server application

  1. Why do all datasets except the last 20-30 disappear from the server?

    Please check the free space on your server. See section General settings.

  2. Which files should be backed up regularly?

    • On Windows the important files are saved in the folder C:\ProgramData\MBITS\mRayServer. You should backup these files:

      • config.ini (saves basic server options like port number, etc.)

      • mraydb.mes (main database, saves everything concernig users, pools, etc.)

      • mraydb.mes-wal (if available)

      • license.ini (license which has been installed for the server activation)

      • options.ini (advanced options)

    • Please notice that received image datasets might be located at a different place on the drive according to the settings made in the configuration. By default, the location described above is used. These can be backed up as well. In case of a reinstallation it is meaninful to resend the data from the PACS again where it is stored normally.

    • mRay features a built-in backup mechanism that saves the fundamental settings of the server. This process is triggered e.g. before an LDAP synch.

The installation package contains a backup script mRayServerBackup.bat which copies those files into a folder on the desktop.

25.2. Client application

  1. Why do some datasets have the green tag ‘JPEG’?

    Those datasets are transferred by employing JPEG compression (according to the Konsensius-Conference [Loose et al. 2009]).

  2. The patient list does not show all datasets. Why?

    Please ensure that the search field is empty.

  3. Why are no results shown after performing a query search to my PACS, although the patient is listed in my PACS?

    Some PACS distributers require a case sensitive search. Searching for “smith” will not lead to a result list as searching for “Smith” does.

26. Known issues

The list of known issues leads to problems identified after the release of the latest version of mRay. These problems, however, were classified as non-critical, so that an unrestricted working with the application is possible.

  1. Pseudonymization of images is not applied to the burned- in pixel data information. Please communicate this fact to the users to ensure that the data is sent only to pools for which Pseudonymization is turned off.

  2. Form fields for floating point numbers within the configuration application only accept values in english format, i.e. with a point as a delimiter.

  3. The auto-download setting Wifi/Mobile is not applicable for the Windows version of mRay client app.

  4. Multi touch gestures might trigger a button press event if they end above a button. This will happen altough the gesture is recognized as intended.

  5. The new Android 7 splitscreen mode will lead the application to crash, if it is displayed in a splitscreen.

  6. The camera on a MED-TAB v2 does not focus correctly.

  7. Emojis in text fields can behave unexpectedly.

  8. A global cache path to a network drive can cause problems (concerns mRay server only)

  9. Automatic memory management on the mobile device may be incorrect if several mRay accounts are used on the device. Although the data is no longer accessible, they are not deleted under certain circumstances.

  10. Right click is not working on Windows Surface

  11. The badge number for studies increases each time a new study arrives, but doesn’t decrease when studies are no longer available

  12. mRay server license changes to invalid after activating VPN controller

  13. Messaging: attachment is rendered with 'no access' despite being able to open the attachment

  14. Inbox: Search within study that has no result leads to jumping back to top level (usability bug)

  15. Multi-Frame MR images are do not fully supported. Varying spacing on one slice is not supported.

  16. Screen stays black when app is started after update of the device

26.1. VEOcore

  1. Plugin processing context invalid if prepare folder is cleaned after one day, fails to restart VEOcore call for a study that is pushed again

  2. Symmetric Gaussian in fourier can lead to slight numerical inaccuracies for even matrix sizes.

27. Information

  • The DICOM conformance statement can be consulted at the following address.

  • To avoid operating delays in your medical office or station in case of a failure of your main device by e.g. a hardware defect, operating system failure, overheating or similar please make sure that you always keep a functional backup device ready.

  • If JPEG compression is selected for a pool it is not guaranteed that all datasets are compressed using jpeg encoding. Please note the information in Pool-Management about supported number of bits. The decision between lossless and jpeg compression is also based on the resulting size of a dataset.

  • If anti-virus software is used please make sure that the configuration prevents possible data losses for directories containing patient data.