High‑D Server

Setup

Installing High-D Server

Installation of High-D Server is pretty straight forward and can usually be performed by simply running the appropriate installer and accepting the default settings. For detailed instructions, including customization notes, please follow the platform-specific instructions for Windows, macOS, Unix/Linux below.

Connecting to High-D Server

A web server is built into High-D Server. Simply launch High-D Server and use a web browser to connect to its interface. The default port for the web-based interface is 9090. If you are on the same machine as High-D Server, the following URL will usually work: http://127.0.0.1:9090. The default port number can be changed by editing the high-d‑server.vmoptions file in your installation directory.

Setting up High-D Server on Windows

  1. Download the Setup Executable from http://www.high-d.com/server/download/

  2. Run the high-d-server_windows_2020_x_x.exe installer

  3. If desired, change the default settings:

    1. Accept or customize the destination directory (default is C:\Program Files\Macrofocus\High-DServer\)

    2. Customize the port number if necessary (default is 9090). Choose another port if the default is already used by another service. Port 80 is the standard HTTP port and can be used if no web server is running on the computer.

    3. Customize the datasets location if desired (default is C:\Program Files\Macrofocus\High-DServer\data\). You can either make this point to the installation directory of the desktop version of High-D (C:\Program Files\Macrofocus\High-D\ by default) or any other location where High-D data files (with the .mhd extension) are stored. The use of network drive is allowed if multiple people want to share their data files.

    4. If desired, customize the maximum memory that High-D Server is allowed to use. 512 MB (the default) should be adequate for small to medium datasets with a low number of concurrent users. If your computer has a lot of RAM, then increasing this value may for sure not hurt.

  4. Enter the user name and the license key as provided in your license certificate. Make sure to enter both exactly as indicated, as they should match.

  5. Once the installation is completed, High-D Server is operational. Click Finish and your default Internet browser will start (if you are on the same machine as High-D Server) and open the main landing page of High-D Server (by default http://localhost:9090/). From there, any dataset available at the datasets location will be listed and is also accessible by appending the file name to the URL, e.g. http://localhost:9090/Italian%20Olive%20Oils.mhd. Note that potential space characters in the file name have to be replaced by %20.

    1. If there is no firewall or NAT router preventing connection to it, it can also be reached from other computer on the network (and potentially the Internet) by using the IP address of the computer instead of localhost. Finding your computer’s IP address can be done by following the instructions at http://windows.microsoft.com/en-us/windows7/find-your-computers-ip-address. If you have a firewall enabled on the computer, you may have to add an exception to allow connections to the port number High-D Server is running on (follow the instructions at http://windows.microsoft.com/en-gb/windows7/open-a-port-in-windows-firewall if you are using Windows Firewall).

    2. High-D Server will be started automatically every time the computer starts. It runs as a standard Windows service and a high-d‑server.exe file is in the installation directory. You can use this executable to install and control the High-D Server service. You can also use the Services tool in the Windows Control Panel to start and stop the service, or from a console window run the following commands:
      high-d‑server /install — installs the service.
      high-d‑server /uninstall — uninstalls the service.
      high-d‑server /start — starts the service.
      high-d‑server /stop — stops the service.

    3. Advanced users may wish customize paramaters to the runtime environment of High-D Server. You can do this by editing the high-d‑server.vmoptions file in the installation directory. Each parameter to the VM should be on a new line of the file. For example, to set the max VM heap size to 1024 MB, you’d use:
      -Xmx1024m

Setting up High-D Server on macOS

  1. Download the DMG Archive from http://www.high-d.com/server/download/

  2. Open the archive and run the High-D Server Installer application

  3. If desired, change the default settings:

    1. Accept or customize the destination directory (default is /Applications/High-DServer)

    2. Customize the port number if necessary (default is 9090). Choose another port if the default is already used by another service. Port 80 is the standard HTTP port and can be used if no web server is running on the computer.

    3. Customize the datasets location if desired (default is /Applications/High-DServer/data/). You can either make this point to the installation directory of the desktop version of High-D (/Applications/High-D/ by default) or any other location where High-D data files (with the .mhd extension) are stored. The use of network drive is allowed if multiple people want to share their data files.

    4. If desired, customize the maximum memory that High-D Server is allowed to use. 512 MB (the default) should be adequate for small to medium datasets with a low number of concurrent users. If your computer has a lot of RAM, then increasing this value may for sure not hurt.

  4. Enter the user name and the license key as provided in your license certificate. Make sure to enter both exactly as indicated, as they should match.

  5. Once the installation is completed, High-D Server is operational. Click Finish and your default Internet browser will start (if you are on the same machine as High-D Server) and open the main landing page of High-D Server (by default http://localhost:9090/). From there, any dataset available at the datasets location will be listed and is also accessible by appending the file name to the URL, e.g. http://localhost:9090/Italian%20Olive%20Oils.mhd. Note that potential space characters in the file name have to be replaced by %20.

    1. If there is no firewall or NAT router preventing connection to it, it can also be reached from other computer on the network (and potentially the Internet) by using the IP address of the computer instead of localhost. Finding your computer’s IP address can be done by following the instructions at http://support.apple.com/kb/PH10658. If you have a firewall enabled on the computer, you may have to add an exception to allow connections to the port number High-D Server is running on (follow the instructions at http://support.apple.com/kb/PH4358 if you are using macOS Firewall).

    2. High-D Server will be started automatically every time the computer starts. It runs as a standard daemon and a high-d‑server executable file is in the installation directory. You can use this executable to control the High-D Server daemon from a Terminal window by running the following commands:
      high-d‑server start — starts the daemon.
      high-d‑server stop — stops the daemon.
      high-d‑server status — displays status information about the daemon.
      high-d‑server restart — restarts the daemon.

    3. Advanced users may wish customize paramaters to the runtime environment of High-D Server. You can do this by editing the high-d‑server.vmoptions file in the installation directory. Each parameter to the VM should be on a new line of the file. For example, to set the max VM heap size to 1024 MB, you’d use:
      -Xmx1024m

Setting up High-D Server on Linux/Unix

If you are running on a Red Hat or Red Hat like system (CentOS, Fedora, etc), we recommend using the RPM as it contains some custom handling of the standard Red Hat like environment. Assuming that you have used the RPM, you can start and stop High-D Server using the /etc/init.d/high-d-server script.

    # /etc/init.d/high-d-server
    Usage /etc/init.d/high-d-server {start|stop|restart|status|condrestart|reload}
    # /etc/init.d/high-d-server start
    Starting high-d-server:

If you are running on a different Linux/Unix varient, and/or you have used the .tar.gz 'installer', you can start and stop High-D Server using the high-d-server script in your installation directory:

    # ./high-d-server
    Usage: ./high-d-server {start|stop}
    # ./high-d-server start
    Starting high-d-server

FAQ

How do I upload data files created by the desktop version of High-D, to the High-D Server?

You can upload files from within the web interface, as long as the upload mechanism has been enabled during the installation process (disabled by default). You can also manually place the .mtm files created by the desktop version of High-D in the dataset location folder set during the installation (by default C:\Program Files\Macrofocus\High-DServer\data\ on Windows and /Applications/High-DServer/data on macOS). The location of this folder can be adjusted either by editing the high-d-server.vmoptions file or by running the installer again (e.g. to make it point to the same location that is used by the desktop version of High-D).
We are going to provide an upload mechanism from within the desktop version of High-D in a forthcoming version.

Can I organize the files in subfolders?

Yes, but currently we are now showing the subfolders in the directory listing. As an example, it is possible to access http://public.high-d.com/secret/ even though it is not listed in http://public.high-d.com/. Using this method, it is also possible to make specific subfolders only available to closed user groups by only communicating its location with these users.