Ricerca nel sito web

Come installare Ralph CMDB su Ubuntu 22.04|20.04|18.04

Ralph è un sistema Open Source completo di gestione delle risorse, DCIM e CMDB per data center e back office. È rilasciato sotto la licenza Apache v2.0. Ralph ti consente di tenere traccia degli acquisti di asset e di gestire l'intero ciclo di vita degli asset, sia in ufficio che in Data Center.

In precedenza avevamo discusso di strumenti open source simili che possono aiutare con la gestione delle risorse. Le guide di installazione sono di seguito.

  • Installa lo strumento di gestione delle risorse i-doit su Ubuntu
  • Come installare GLPI su Ubuntu
  • Come installare OCS Inventory Server su Ubuntu

Questa guida ti guiderà attraverso l'installazione e la configurazione del sistema Ralph CMDB/Asset Management su Ubuntu 22.04|20.04|18.04. Inizieremo con l'aggiunta dei repository dei pacchetti, quindi con l'installazione e infine con come ottimizzare, modificare e ottimizzare l'installazione.

Passaggio 1: aggiornamento del sistema

Lavoriamo sempre su un sistema aggiornato. Questo è consigliato se stai lavorando su una nuova installazione del sistema Ubuntu.

sudo apt update && sudo apt -y upgrade

Controlla se è necessario riavviare l'istanza dopo l'aggiornamento.

[ -e /var/run/reboot-required ] && sudo reboot

Passaggio 2: aggiungi i repository Ralph

Ora che il nostro sistema è aggiornato, procediamo ad aggiungere i repository che contengono i pacchetti che devono essere installati. Esegui i comandi seguenti come utente con privilegi sudo.

curl -fsSL https://packagecloud.io/allegro/ralph/gpgkey|sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/ralph.gpg
sudo sh -c "echo 'deb https://packagecloud.io/allegro/ralph/ubuntu/ bionic main' >  /etc/apt/sources.list.d/ralph.list"
sudo sh -c "echo 'deb http://security.ubuntu.com/ubuntu bionic-security main' >>  /etc/apt/sources.list.d/ralph.list"
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3B4FE6ACC0B21F32

Passaggio 3: installa Ralph su Ubuntu

Dopo aver aggiunto il repository, aggiorna il tuo sistema e installa Ralph con i pacchetti di database mysql.

sudo apt update
sudo apt install mysql-server nginx ralph-core

Accetta la richiesta di installazione:

0 upgraded, 56 newly installed, 0 to remove and 41 not upgraded.
Need to get 76.0 MB of archives.
After this operation, 469 MB of additional disk space will be used.
Do you want to continue? [Y/n] y

Quando richiesto, inserisci le impostazioni del database Ralph o seleziona Utilizza le impostazioni predefinite che dovrebbero funzionare correttamente.

Le impostazioni del database verranno scritte in /etc/ralph/conf.d/database.conf. Potrai rivederli in seguito. Se decidi di aggiornare le informazioni di accesso al database come password, aggiornale nel file.

Passaggio 4: configurazione del database e di Ralph

Accedere alla console del server del database.

sudo mysql -u root -p

Se non hai password, premi semplicemente quando ti viene richiesta la password. Quindi crea database e utente per Ralph.

CREATE DATABASE ralph_ng;
CREATE USER 'ralph_ng'@'localhost' IDENTIFIED BY 'Str0ngPassw0rd';
GRANT ALL PRIVILEGES ON ralph_ng.* TO 'ralph_ng'@'localhost';
FLUSH PRIVILEGES;
QUIT;

Se utilizzi una password separata, aggiornala nel file /etc/ralph/conf.d/database.conf.

Testare l'accesso al database.

$ mysql -u ralph_ng -pStr0ngPassw0rd
mysql: [Warning] Using a password on the command line interface can be insecure.
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 15
Server version: 5.7.26-0ubuntu0.18.04.1 (Ubuntu)

Copyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved.

Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql>

Creare lo schema del database

sudo ralphctl migrate

Crea il superutente Ralph

$ sudo ralphctl createsuperuser
Username: admin
Email address: [email 
Password: <InputStrongPassword>
Password (again): <ConfirmPassword>
Superuser created successfully.

Facoltativamente popolare il database con alcuni dati:

$ sudo ralphctl demodata
Generating Users and Groups
Generating Back Office assets
Generating Data Center assets
Generating Supports
Generating Licences
Generating Transitions
done

Al termine, avvio del servizio Ralph.

sudo ralphctl sitetree_resync_apps
sudo systemctl enable ralph.service
sudo systemctl start ralph.service

Conferma lo stato del servizio: dovrebbe essere "in esecuzione".

$ systemctl status ralph.service
 ● ralph.service - Ralph service
    Loaded: loaded (/lib/systemd/system/ralph.service; enabled; vendor preset: enabled)
    Active: active (running) since Thu 2019-06-06 10:38:16 CEST; 1min 9s ago
  Main PID: 17424 (gunicorn)
     Tasks: 3 (limit: 2299)
    CGroup: /system.slice/ralph.service
            ├─17424 /opt/ralph/ralph-core/bin/python /opt/ralph/ralph-core/bin/gunicorn -c /var/local/ralph/gunicorn.ini ralph.wsgi
            ├─17442 /opt/ralph/ralph-core/bin/python /opt/ralph/ralph-core/bin/gunicorn -c /var/local/ralph/gunicorn.ini ralph.wsgi
            └─17444 /opt/ralph/ralph-core/bin/python /opt/ralph/ralph-core/bin/gunicorn -c /var/local/ralph/gunicorn.ini ralph.wsgi
Jun 06 10:38:16 ralph systemd[1]: Started Ralph service.

Il servizio dovrebbe essere in ascolto sulla porta 8000.

$ ss -tunelp | grep 8000
tcp    LISTEN   0        128               0.0.0.0:8000          0.0.0.0:*       users:(("gunicorn",pid=17444,fd=7),("gunicorn",pid=17442,fd=7),("gunicorn",pid=17424,fd=7)) uid:112 ino:44358 sk:a <->

Passaggio 5: configura il proxy Nginx

Si consiglia di accedere alla dashboard Ralph tramite un proxy Nginx in cui è possibile terminare SSL.

Crea un nuovo file di configurazione Nginx.

sudo nano /etc/nginx/conf.d/ralph.conf

Incolla i dati sottostanti nel file.

server {

    listen 80;
    client_max_body_size 512M;
    server_name ralph.example.com;
    proxy_set_header Connection "";
    proxy_http_version 1.1;
    proxy_connect_timeout  300;
    proxy_read_timeout 300;

    access_log /var/log/nginx/ralph_access.log;
    error_log /var/log/nginx/ralph_error.log;

    location /static {
        alias /usr/share/ralph/static;
        access_log        off;
        log_not_found     off;
        expires 1M;
    }

    #location /media {
    #    alias /var/local/ralph/media;
    #    add_header Content-disposition "attachment";
    #}

    location / {
        proxy_pass http://127.0.0.1:8000;
        include /etc/nginx/uwsgi_params;
        proxy_set_header Host $http_host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

Sostituisci ralph.example.com con il tuo nome di dominio per Ralph o il nome host del server.

Successivamente, riavvia nginx:

sudo systemctl restart nginx.service

Accedi alla dashboard Ralph su http://hostname

Accedi con l'account utente amministratore creato.

Dovresti vedere la dashboard con i dati di esempio importati in precedenza.

File di registro: per la risoluzione dei problemi

Le posizioni di tutti i file di registro relativi a Ralph sono:

  • /var/log/ralph/ralph.log
  • /var/log/ralph/gunicorn.error.log
  • /var/log/ralph/gunicorn.access.log
  • /var/log/nginx/ralph-error.log
  • /var/log/nginx/ralph-access.log

Se qualcosa va storto, puoi dare un'occhiata ai file di registro.

Visita la pagina della documentazione di Ralph per ulteriori letture.

Articoli correlati: