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
- Download the Setup Executable from
http://www.treemap.com/server/download/
- Run the
treemap-server_windows_3_x_x.exe
installer - If desired, change the default settings:
- Accept or customize the destination directory (default is
C:\Program Files\Macrofocus\TreeMapServer\
) - Customize the port number if necessary (default is
9090
). Choose another port if the default is already used by another service. Port80
is the standard HTTP port and can be used if no web server is running on the computer. - 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. - 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.
- Accept or customize the destination directory (default is
- 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.
- 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-%202022.mtm
. Note that potential space characters in the file name have to be replaced by%20
.- 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 athttp://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 athttp://windows.microsoft.com/en-gb/windows7/open-a-port-in-windows-firewall
if you are using Windows Firewall). - 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.
- 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 to1024 MB
, you'd use:
-Xmx1024m
- 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
Setting up TreeMap Server on macOS
- Download the DMG Archive from
http://www.treemap.com/server/download/
- Open the archive and run the
TreeMap Server Installer
application - If desired, change the default settings:
- Accept or customize the destination directory (default is
/Applications/TreeMapServer
) - Customize the port number if necessary (default is
9090
). Choose another port if the default is already used by another service. Port80
is the standard HTTP port and can be used if no web server is running on the computer. - 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. - 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.
- Accept or customize the destination directory (default is
- 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.
- 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-%202022.mtm
. Note that potential space characters in the file name have to be replaced by%20
.- 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 athttp://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 athttp://support.apple.com/kb/PH4358
if you are using macOS Firewall). - 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.
- 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 to1024 MB
, you'd use:
-Xmx1024m
- 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
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