products:cockpit.old:1.0:installguide:installpromonitor

Install Pro.Monitor cockpit

The application can be installed on most common Linux distributions, the syntax of the commands described below might change from one distribution to another

To install Pro.Monitor Cockpit, download the install package and extract the compressed file in your home directory. Do not copy the archive in /opt folder

tar -xvzf Pro.Monitor-Cockpit-VERSION_BUILD_NUMBER.tar.gz

This will create the following files:

  • Pro.Monitor.Cockpit.tar.gz : The application package
  • update.sh : The update script
  • install.sh : The install script
  • promonitor-cockpit.service : The Service configuration file
Run install.sh 

The Pro.Monitor Cockpit is installed by default in /opt
You can now start the application:

systemctl start promonitor-cockpit

User access

  • The installer will automatically create a dedicated promonitor service user for running the application.
  • For security reasons, do not run the application as root
  • Please follow the policy of least privilege for all access granted to run or maintain the application.

Update Pro.Monitor

  • It is recommended to update Pro.Monitor via the web superadmin UI.
  • However, it is possible to update from the OS directly
  • Once you downloaded and decompressed the update package, you can stop the application and run the update script:
systemctl stop promonitor-cockpit
./update.sh
systemctl start promonitor-cockpit
  • Update will create a new folder for the application and redirect the link from the old version to the new one.

Older versions are not deleted during an update from the OS. You will have to delete old version folders manually

How to change the installation folder

Before to installing Pro.Monitor Cockpit, open install.sh script and update the pmDir variable

pmDir="/opt"

Then, open promonitor-cockpit.service and set the same folder on the following lines :

WorkingDirectory=/opt/Pro.Monitor-Cockpit/
ExecStart=/opt/Pro.Monitor-Cockpit/bin/startup.sh

How to change the HTTP/HTTPS ports

Change port.http.nonssl and port.http.ssl value in the file /opt/Pro.Monitor-Cockpit/bin/setenv.sh

systemctl stop promonitor-cockpit
vi /opt/Pro.Monitor-Cockpit/bin/setenv.sh  # change the appropriate port
systemctl start promonitor-cockpit

Memory tuning

Linux

Change the -Xms and -Xmx value in /opt/Pro.Monitor-Cockpit/bin/setenv.sh to define minimum and maximum allocated memory

systemctl stop promonitor-cockpit
vi /opt/Pro.Monitor-Cockpit/bin/setenv.sh
systemctl start promonitor-cockpit

Manage firewall settings

  • Application ports must be open:
    • 9888 for HTTPS
    • 9443 for HTTPS
  • Example on REDHAT / CENTOS 7 :
sudo firewall-cmd –zone=public –add-port=9888/tcp –permanent
sudo firewall-cmd –reload
  • Other example for different Linux distributions:
sudo iptables -I INPUT -p tcp -m tcp –dport 9888 -j ACCEPT
sudo service iptables save

Reverse proxy

  • If you intend to install the application behind a NGINX reverse proxy, you need to add the below parameter to the location section:
proxy_pass http://<LOCAL SERVER>:<LOCAL PORT>;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "Upgrade";
proxy_set_header host $host;
proxy_set_header X-forward-for $proxy_add_x_forwarded_for;
/home/clients/8c48b436badcd3a0bdaaba8c59a54bf1/wiki-web/data/pages/products/cockpit.old/1.0/installguide/installpromonitor.txt · Last modified: 2024/05/01 18:39 (external edit)