TreeMap Server

Setup

Installing TreeMap Server

Installation of TreeMap 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 TreeMap Server

A web server is built into TreeMap Server. Simply launch TreeMap 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 TreeMap Server, the following URL will usually work: http://127.0.0.1:9090. The default port number can be changed by editing the treemap‑server.vmoptions file in your installation directory.

Setting up TreeMap Server on Windows

  1. Download the Setup Executable from http://www.treemap.com/server/download/
  2. Run the treemap-server_windows_3_x_x.exe installer
  3. If desired, change the default settings:
    1. Accept or customize the destination directory (default is C:\Program Files\Macrofocus\TreeMapServer\)
    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\TreeMapServer\data\). You can either make this point to the installation directory of the desktop version of TreeMap (C:\Program Files\Macrofocus\TreeMap\ by default) or any other location where TreeMap data files (with the .mtm 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 TreeMap 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, TreeMap Server is operational. Click Finish and your default Internet browser will start (if you are on the same machine as TreeMap Server) and open the main landing page of TreeMap 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/Forbes%20Global%202000%20-%202013.mtm. 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 TreeMap 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. TreeMap Server will be started automatically every time the computer starts. It runs as a standard Windows service and a treemap‑server.exe file is in the installation directory. You can use this executable to install and control the TreeMap 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:
      treemap‑server /install -- installs the service.
      treemap‑server /uninstall -- uninstalls the service.
      treemap‑server /start -- starts the service.
      treemap‑server /stop -- stops the service.
    3. Advanced users may wish customize paramaters to the runtime environment of TreeMap Server. You can do this by editing the treemap‑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 TreeMap Server on macOS

  1. Download the DMG Archive from http://www.treemap.com/server/download/
  2. Open the archive and run the TreeMap Server Installer application
  3. If desired, change the default settings:
    1. Accept or customize the destination directory (default is /Applications/TreeMapServer)
    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/TreeMapServer/data/). You can either make this point to the installation directory of the desktop version of TreeMap (/Applications/TreeMap/ by default) or any other location where TreeMap data files (with the .mtm 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 TreeMap 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, TreeMap Server is operational. Click Finish and your default Internet browser will start (if you are on the same machine as TreeMap Server) and open the main landing page of TreeMap 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/Forbes%20Global%202000%20-%202013.mtm. 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 TreeMap Server is running on (follow the instructions at http://support.apple.com/kb/PH4358 if you are using macOS Firewall).
    2. TreeMap Server will be started automatically every time the computer starts. It runs as a standard daemon and a treemap‑server executable file is in the installation directory. You can use this executable to control the TreeMap Server daemon from a Terminal window by running the following commands:
      treemap‑server start -- starts the daemon.
      treemap‑server stop -- stops the daemon.
      treemap‑server status -- displays status information about the daemon.
      treemap‑server restart -- restarts the daemon.
    3. Advanced users may wish customize paramaters to the runtime environment of TreeMap Server. You can do this by editing the treemap‑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 TreeMap 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 TreeMap Server using the /etc/init.d/treemap-server script.

    # /etc/init.d/treemap-server
    Usage /etc/init.d/treemap-server {start|stop|restart|status|condrestart|reload}
    # /etc/init.d/treemap-server start
    Starting treemap-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 TreeMap Server using the treemap-server script in your installation directory:

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