Purpose: This installation aims at installing metasfresh directly on a bare-metal or a virtual machine. If you want a more flexible installation, try using metasfresh-docker.
user@host:~/$ sudo apt update
user@host:~/$ tar xvzf ./metasfresh_5_X.tar.gz user@host:~/$ cd metasfresh_install user@host:~/metasfresh_install$ chmod +x ./install_metasfresh.sh user@host:~/metasfresh_install$ sudo ./install_metasfresh.sh
After a successful installation, the application server as well as the webapi back end start up. Wait a few minutes for the services to be completely booted up before you try accessing the service.
When the services have been initialized, you can either:
http://XXX.YYY.ZZZ.AAA:8080/to download the Java Swing Client to your client workstations
http://XXX.YYY.ZZZ.AAA/to access metasfresh-WebUI
Note: Check out this TO DO guide for using a hostname instead of an IP address to access the WebUI.
If you want to check the statuses of the metasfresh services, you can simply stop or restart them. To do so, you can use the following commands:
user@host:~/$ sudo systemctl start/stop/restart/status metasfresh_server.service user@host:~/$ sudo /etc/init.d/metasfresh-webui-api start/stop/restart/status
The application server uses ports
5432/TCP for communication with the Java Swing Clients. Please ensure access to these ports before trying to connect with the Java Client.
The metasfresh-WebUI uses port
80/TCP by default for browser access. Make sure to allow connections in your firewall to your server if you want to use the WebUI.
Which software/services will be installed?
A: Along with the metasfresh-server, the installer will download and setup PostgreSQL-Server 9.5, Apache2, Elasticsearch and OpenJDK-8 JDK.
Where can I find the binaries and config files for metasfresh?
A: The binaries as well as their config files will be located in their respective directories under the main folder
I want to check out the source code. Where am I able to find it?
A: You can find and download the source code for all of our applications on Github: https://github.com/metasfresh.
Which ports are used by metasfresh?
80/TCP(http) - WebUI
443/TCP(https) - WebUI (optional)
8080/TCP- Download of the Java Swing Client
61616/TCP- Connection for the Java Client to the application-server
5432/TCP- Connection for the Java Client to the database-server
When trying to connect to the server I get an error message about a non-working "DB Connection". Why does this error appear?
A: The hostname of the Ubuntu server needs to be resolved by the server itself as well as the client workstations.
Please note: The hostname resolved in your network needs to be identical to the one set on the server itself. If for example the hostname of your Ubuntu server is set to “erpserver”, the name needs to be pingable using “ping erpserver” in the command line interface of the server and all client workstations.
If you have any questions or problems that have not been mentioned here, feel free to ask for support in our official public forum: forum.metasfresh.org.