This guide serves as a quick reference to remind you of the setup steps. For more detailed information, please refer to the general wiki

• Navigating Directories:
  1. cd: Change directory → Ex: `cd /path/ `
  2. ls: List directory contents → Ex: `ls -l` (detailed list including file permissions)

• Viewing and Manipulating Files:
  1. cat: Display the contents of a file → Ex: `cat filename`
  2. nano, vim: Edit files using a text editor → Ex: `nano filename`, `vim filename`
  3. tail: View the last part of a file → Ex: `tail -f filename.log` (continuously follow the file)
  4. grep: Search for patterns within files → Ex: `grep 'pattern' filename`

• Managing Processes:
  1. ps: Display running processes → Ex: `ps aux`
  2. top: Display real-time process → Ex: `top`
  3. kill: Send a signal to a process → Ex: `kill -9 PID`

• File Permissions and Ownership:
  1. chmod: Change file permissions → Ex: `chmod 755 filename`
  2. chown: Change file owner and group → Ex: `chown user:group filename`

• Package Management:
  1. yum (CentOS/RedHat) → Ex: `yum install packagename`
  2. apt-get (Debian/Ubuntu) → Ex: `apt-get install packagename`

• System Services:
  1. systemctl: Manage and monitor system services (systemd)
  2. Start → Ex: `systemctl start servicename`
  3. Status → Ex: `systemctl status servicename`
  4. Stop → Ex: `systemctl stop servicename`
  5. Enable at Boot → Ex: `systemctl enable servicename`

• Install Global Dependencies:
  1. Check Java version with `java -version` ensure it's version 15 or higher.
  2. Install Java on Red Hat/CentOS using `yum install java-latest-openjdk-headless.x86_64`. → More information
• Install Cockpit:
  1. Do not unpack in `opt`. Use a separate directory.
  2. Install dependencies for Cockpit
  3. Unpack the cockpit with `tar -zxvf Pro.Monitor-Cockpit-xxxx.tar.gz` and run `./install.sh`.
  4. Start the service with `systemctl start promonitor-cockpit`.
• Install Collector:
  1. Do not unpack in `opt`. Use a separate directory.
  2. Run `./install.sh`
  3. Start the service with `systemctl start promonitor`.

• Installing MySQL: More detail here
  1. CentOS/RedHat:
     1. Install MySQL : `yum install mysql-server`
     2. Start MySQL : `systemctl start mysqld`
     3. Secure MySQL installation: `mysql_secure_installation`
  2. Debian:
     1. Update package index: `apt-get update`
     2. Install MySQL: `apt-get install mysql-server`
     3. Secure MySQL installation: `mysql_secure_installation`

• Installing VictoriaMetrics: More detail here
  1. Common Steps for CentOS/RedHat and Debian:
     1. Download the latest VictoriaMetrics
     2. Exemple : `wget https://github.com/VictoriaMetrics/VictoriaMetrics/releases/download/v1.100.1/victoria-metrics-freebsd-amd64-v1.100.1-cluster.tar.gz `
     3. Extract the tar.gz file using: `tar -zxvf victoria-metrics*.tar.gz`
     4. Move the binaries to a suitable directory, such as `/usr/local/bin`
     5. Create a systemd service file for VictoriaMetrics at `/etc/systemd/system/victoriametrics.service`:

      [Unit]
      Description=VictoriaMetrics
      After=network.target

      [Service]
      Type=simple
      ExecStart=/usr/local/bin/victoriametrics -storageDataPath /var/lib/victoria-metrics-data
      Restart=on-failure

      [Install]
      WantedBy=multi-user.target
      

1. Start VictoriaMetrics service: `systemctl start victoriametrics`
2. Enable VictoriaMetrics at boot: `systemctl enable victoriametrics`

• Setting Environment Variables:
  1. Use cat setenv.sh to view current environment settings.
  2. Check setenv.sh script to establish necessary change.
     1. Dport.http.nonssl=8888 ← Change HTTP port
     2. Dport.http.ssl=8443 ← Change HTTPS port

• Remove Old version : Use this only if you can't update from old version
  1. Execute systemctl stop promonitor
  2. Execute rm -rf Pro.Monitor* to remove outdated application versions.
  3. Run systemctl daemon-reload to refresh the system daemon

• Rebooting Services:
  1. To reboot cockpit → `systemctl restart promonitor-cockpit.service`
  2. To reboot monitor → `systemctl restart promonitor.service`.
• Applying Updates with Cockpit:
  1. Remplace .war file with the new one
  2. Login to SuperAdmin Cockpit
     1. → Updates
     2. → Collector Updates
     3. Apply the update
  3. Login to the Admin Tenant
  4. → Collector
  5. → … (3dot)
  6. → Update
  7. → Apply