Installing and Uninstalling the Program

Installing the Program on Windows

To install the program:

  1. Run the installer by double-click.

  2. Click CONTINUE in the window shown in Fig. 1.


    PIC

    Figure 1: Beginning of the installation


  3. It is strongly recommended to update graphics adapter drivers (integrated or discrete) from the official manufacturer‘s website, in order to prevent possible failure in operation of DICOM Viewer. If you are sure that drivers are up to date check the The drivers on this device have been updated box in the window shown in Fig. 2, and click CONTINUE. Otherwise stop installation (click CANCEL and in the confirmation dialog click Yes) and update drivers. To return to the previous installation step click GO BACK.


    PIC

    Figure 2: Software recomendation


  4. Read the License Agreement carefully. Its text is also available from the link inobitec.com/eng/about/viewerLic/. If you agree the terms and conditions, check the item I accept the license and click CONTINUE (Fig. 3). Otherwise click CANCEL and in the confirmation dialog box that appears click Yes.


    PIC

    Figure 3: License Agreement



    PIC

    Figure 4: Select users


  5. Select for whom you want to install the program (Fig. 4). If you select Anyone who uses this computer (all users), then the program will be installed to the system folder, and you will need administrative privileges.

  6. If necessary, change the Installation Folder (Fig. 5). We recommend leaving the default value. Click CONTINUE.

    PIC Attention:
    • it is prohibited to specify a path with only the disk root (e.g. D:\);

    • it is prohibited to specify folders created by other users and third-party software;

    • when the program is being installed for all the users, specify a folder that can be accessed by all the users.


    PIC

    Figure 5: Installation Folder


  7. If another version of the program is already installed in the selected folder, then the message The directory you selected already exists and contains an installation. To install the product the installation will be uninstalled first will be displayed.

    To uninstall, click Yes. The uninstaller will start (see the Section Uninstalling the Program on Windows). After the uninstall the installation will continue.

    To leave the already installed version of the program and select a new folder to install, click No and in the window shown in Fig. 5, specify another folder.

  8. If you select installation for all users, then you need to specify the Common Directory to store the program service information (Fig. 6). If necessary, change the path to the Common Directory. We recommend leaving the default value. Click CONTINUE.


    PIC

    Figure 6: Common Directory for service information


  9. In the Select Components window, (Fig. 7) select the required components by check the boxes. To expand or collapse the component tree, click on the symbols to the left of the component group name (highlighted in red and green in the Fig. 7):

    For detailed information about a component select it with the mouse.


    PIC

    Figure 7: Select Components Window



    PIC

    Figure 8: Start Menu Shortcuts


  10. If necessary, change the folder for the program’s shortcuts in the Start menu (Fig. 8). We recommend leaving the default value. Click CONTINUE.


    PIC

    Figure 9: Confirm installation


  11. In the confirmation window click the INSTALL button (Fig. 9).

  12. Wait until the installation process is complete (Fig. 10). Click the DONE button.


    PIC

    Figure 10: Installation complete


Silent Installation on Windows

Silent installation allows you to speed up and automate the process of installing the program by submitting the installation parameters to the installer through the file. Such installation can be launched automatically on domain computers using Microsoft Active Directory.

To prepare the installer for a silent installation:

  1. Unpack the installer to a folder using an archiver (for example, 7-zip).

  2. Go to the folder where the installer is unpacked.

  3. Edit the following parameters in the autoinstall.qs file:

    1. AllUsers = false to install only for current user (by default) or AllUsers = true to install for all users;

    2. TargetPathName: path to folder to install the DICOM Viewer. If AllUsers = true then the default value is C:\Program Files\InobitecDICOMViewer<Edition><Version>, if AllUsers = false then default value isC:\Users\<CurrentUserName>\InobitecDICOMViewer<Edition><Version>. If necessary, specify another value.

    3. CommonPath: path to the common folder (only if AllUsers = true). The default value is C:\ProgramData\InobitecDICOMViewer<Edition><Version>. If necessary, specify another value. All users must have write access to the specified folder.

    4. LocalStoragePath: path to the local storage. The default value is C:\Users\<username>\InobitecDICOMViewerWorkspace.

    5. OptionsFilePath: path to the file with settings exported from an already installed DICOM ViewerḞor detailes on how to export settings see Section 15.8. The settings file should be in the current folder. If the file is not specified, the default settings are used.

    6. ForceInstall = false to remove the previously installed version of the DICOM Viewer in the folder selected for installation.

    If national characters are used save the autoinstall.qs file in utf-8 encoding.

To install the DICOM Viewer run the silent_install.bat file. Log is written to file %temp%\install%DATE%.log, where %temp% and %DATE% are Windows system variables.

Uninstalling the Program on Windows

To uninstall the program:

  1. Run the uninstaller using one of the following methods:

    1. select Inobitec Dicom Viewer -> Uninstall in the Start menu or

    2. use Programs and Features in the Control Panel.

  2. Make sure that the item Remove all components is selected in the window shown in Fig. 11 and click the CONTINUE button.


    PIC

    Figure 11: Beginning of the uninstallation


  3. In the confirmation window click the UNINSTALL button (Fig. 12).


    PIC

    Figure 12: Confirm uninstallation


  4. In the confirmation window click the DONE button (Fig. 13).


    PIC

    Figure 13: Uninstallation complete


Silent Uninstallation on Windows

Silent uninstallation allows you to automate the process of uninstalling of the program similar to silent installation.

To prepare the installer for a silent uninstallation:

  1. Unpack the installer to a folder using an archiver (for example, 7-zip).

  2. Go to the folder where the installer is unpacked.

  3. Change the <Disk:\Full\Path\To\Installed\DICOMViewer\You\Want\To\Uninstall> text for the path to the folder with the DICOM Viewer to uninstall in the silent_uninstall.bat file.

To uninstall the DICOM Viewer run the silent_install.bat file. Log is written to the %temp%\uninstall%DATE%.log, where %temp% and %DATE% are Windows system variables.

Installing and Uninstalling the Program on Mac OS

To install the program uncompress the dmg file and drag DICOMViewer.app into the open Applications folder. The icon PIC is displayed on the file while dragging. Release the mouse button and wait for the program installation to complete.

To uninstall the program remove the DICOMViewer.app from the Applications folder.

Installing and Uninstalling the Program in AppImage Format on Linux

Inobitec DICOM Viewer software for Linux OS is comprised of only one file in <InobitecDICOMViewer><Bitness><Edition><Version> format with AppImage extension. The file contains the program with all the libraries required for its functioning. Example: InobitecDICOMViewer-linux-64-bit-pro-2.7.0.AppImage.

To install and run the program in AppImage format, proceed as follows (for Ubuntu):

  1. We advise you to transfer the downloaded Inobitec DICOM Viewer file from the Downloads file directory to the directory you need.

  2. Provide the AppImage file a permission to be executed. For that purpose, mouse over the file and click the right mouse button. In the context menu, select Properties. When the Properties menu (Fig. 14) pops up, go to the Permissions tab and check the Allow executing file as program box. Close the Properties menu.

  3. To run the program file, double-click on it with the left mouse button.


PIC

Figure 14: "Properties" menu


To uninstall the program in AppImage format remove the file from the directory.

If to run the AppImage you need to install FUSE

On Linux OS, FUSE (filesystem in userspace) software is required to work with Applmage files.

The Inobitec DICOM Viewer distribution for Linux OS in AppImage format requires FUSE 2 functionality.

If the FUSE 2 is not installed in your operating system, install and configure it manually. You will find detailed instructions on how to install and set up FUSE 2 together with command examples at https://docs.appimage.org/user-guide/troubleshooting/fuse.html. The resource may not be available. In this case you will have to find the information on installing and setting up FUSE 2 on your system for yourself.

Launching with Shortcuts

Starting from version 2.6 the DICOM Viewer shortcut in Windows operating systems is displayed in the format: <Inobitec><Edition><Version>.

The editions available are:

For example Inobitec PRO 2.6.0.

Each version and edition of the DICOM Viewer installed in Windows has their own shortcuts on the Desktop and the Start Menu to ensure the convenience of launching.

To launch the program, double-click on the desktop shortcut or click on the shortcut from the Start menu.

On Windows and macOS, the DICOM Viewer may be launched by dragging and dropping the data folder on the program icon. The studies contained in the folder will be opened in a new tab DICOM data in the folder, and, depending on the data type, the first series of the first study on the list will be opened:

If the DICOM Viewer has already been launched, the data will be opened in it. If there are no data in the folder to be displayed, an empty tab DICOM data in the folder will pop up.

Launch from the Command Line

PIC Attention! On macOS, command line parameters are not supported.

Launching the program from the command line allows you to set specific parameters for the current session of the program, change the settings and get help information about the command line options. To launch the DICOM Viewer use the following syntax on the command line:

[<path_to_the_program>]< executable_program> [ --help] | [--study-folder <path> [--open-series-images | --open-series-mpr | --open-series-volume | --open-series-endoscopy [--series-uid <uid> | --series-index <index>]]] | [--pacs-aetitle <aetitle> [--patient-id <patientID>] [--study-uid <studyUID>] [--series-index <seriesIndex> | --series-uid <seriesUID>] [--open-series-images] ] | [--aet <aet>] | [--import-settings <path> [--use-imported-listener-aetitle | --aet <aet>] [--update-scu-aetitle]] | [--export-settings <path>]

Example: C:\Users\user\DICOMViewerPro1.9.1\viewer.exe --study-folder D:\dicom_data --open-series-images --series-index 1 shows series with seriesIndex 1 of the first study from the D:\dicom_data folder in the Flat images view window.

If the option is wrong, then the help information about the command line options is displayed, and the program exits. If the option value is wrong (e.g. there are not DICOM data in the specified folder, there is no series with the specified seriesUID or seriesIndex), then this and all subsequent options are ignored.

PIC Attention! If some AE Titles of several PACSServers match, then data will be searched on the first PACSServer on the list. PACSServers are sorted by the "Server nickname" field.
For details on how to set up connection to PACSServer, see Section 12.2.

The length of AE Title value shall not exceed 16 characters. Cyrillic letters and "\" symbols in AE titles are not allowed.

The following options are used to change the settings. After executing any of these commands, the program exits. In case of a successful execution, the word Done appears on the command line.

Launch multiple instances of the program

If one instance of editions Pro or Lite is already launched, then other instances of editions Pro or Lite exit and activate the first instance. If another instance is launched from the command line, then the command line options are sent to the first instance.

Note that sometimes the program cannot exit immediately when the main window closes (e.g. if data is being transferred over the network, or if information is being written to a disk or flash card). In this case, if you try to launch the program, the main window of the launched instance does not open and you should wait until the launched instance exits and then launch the program again.