Configura file di inizializzazione o di servizio di sistema per ParStream

Introduzione

In questo documento viene descritto come creare file di servizio per init.d o Systemd per il database cronologico di PartStream.

Prerequisiti

Requisiti

Cisco raccomanda la conoscenza di Linux.

Componenti usati

Il documento può essere consultato per tutte le versioni software o hardware.

Le informazioni discusse in questo documento fanno riferimento a dispositivi usati in uno specifico ambiente di emulazione. Su tutti i dispositivi menzionati nel documento la configurazione è stata ripristinata ai valori predefiniti. Se la rete è operativa, valutare attentamente eventuali conseguenze derivanti dall'uso dei comandi.

Configurazione

Il pacchetto di installazione di Edge Fog Processing Module (EFM) non contiene file di servizio per init.d o Systemed preconfigurati.

In questa pagina è possibile trovare un semplice esempio per creare un file di servizio.

Per init.d

[root@cen7 ~]# cat /etc/init.d/parstream
#!/bin/bash
# parstream init script.

export PARSTREAM_HOME=/opt/cisco/kinetic/parstream/
export LD_LIBRARY_PATH=$PARSTREAM_HOME/lib:$LD_LIBRARY_PATH
PARSTREAM_SERVERNAME="parstream1"
PARSTREAM_USER="EFM"

case "$1" in
  'start')
    echo "Starting ParStream daemon $PARSTREAM_SERVERNAME as $PARSTREAM_USER"
    sleep 2
    su -c "cd $PARSTREAM_HOME;$PARSTREAM_HOME/bin/start.sh $PARSTREAM_SERVERNAME" $PARSTREAM_USER
    ;;

  'stop')
    echo "Stopping ParStream daemons for user $PARSTREAM_USER"
    stopstatus=$(pkill -c -U $PARSTREAM_USER -15 parstream-serv)
    echo "$stopstatus processes stopped"
    ;;

  *)
    # usage
    echo "usage: $0 start|stop"
    exit 1
    ;;
esac

Assicurarsi di regolare le variabili di ambiente in modo che corrispondano al proprio ambiente: PARSTREAM_HOME, PARSTREAM_SERVERNAME e PARSTREAM_USER.

Dopo aver creato il file, accertarsi che sia contrassegnato come eseguibile.

Per System

root@cen7 ~]# cat /etc/systemd/system/parstream.service
[Unit]
Description=ParStream
After=network.target

[Service]
Type=simple
User=EFM
Environment=LD_LIBRARY_PATH=/opt/cisco/kinetic/parstream/lib:$LD_LIBRARY_PATH
WorkingDirectory=/opt/cisco/kinetic/parstream/
ExecStart=/opt/cisco/kinetic/parstream/bin/parstream-server parstream1 --confdir=/opt/cisco/kinetic/parstream/conf/
Restart=on-failure

[Install]
WantedBy=multi-user.target

Accertarsi di modificare le variabili di configurazione in modo che corrispondano al proprio ambiente: User= e servername sulla riga ExecStart.

Dopo la creazione del file di servizio, accertarsi di aggiornare i file daemon in systemd:

[root@cen7 ~]# systemctl daemon-reload

Verifica

Fare riferimento a questa sezione per verificare che la configurazione funzioni correttamente.

Per verificare se gli script/file di servizio funzionano come previsto, è possibile provare ad avviare e arrestare il servizio.

Per init.d

[root@cen7 ~]# /etc/init.d/parstream start
Starting ParStream daemon parstream1 as EFM
Server Process ID: 5056
Output is written to: /var/log/parstream/server-5054-20180423-1648.log
[root@cen7 ~]# ps aux |grep 5056
EFM        5056  0.8  0.7 1235292 27200 ?       Sl   16:48   0:00 /opt/cisco/kinetic/parstream//bin/parstream-server parstream1
...
[root@cen7 ~]# /etc/init.d/parstream stop
Stopping ParStream daemons for user EFM
1 processes stopped

Per System

[root@cen7 ~]# systemctl start parstream
[root@cen7 ~]# systemctl status parstream
● parstream.service - ParStream
   Loaded: loaded (/etc/systemd/system/parstream.service; disabled; vendor preset: disabled)
   Active: active (running) since Mon 2018-04-23 16:49:30 CEST; 3s ago
 Main PID: 5186 (parstream-serve)
   CGroup: /system.slice/parstream.service
           └─5186 /opt/cisco/kinetic/parstream/bin/parstream-server parstream1 --confdir=/opt/cisco/kinetic/parstream/conf/

Apr 23 16:49:30 cen7 parstream-server[5186]: [2018-04-23T16:49:30]:unknown-000000:PROT-77086: **** PID:         5186 (host: cen7)
Apr 23 16:49:30 cen7 parstream-server[5186]: [2018-04-23T16:49:30]:unknown-000000:PROT-71005: **** config file: "/opt/cisco/kinetic/parstream/conf/parstream.ini"
Apr 23 16:49:30 cen7 parstream-server[5186]: [2018-04-23T16:49:30]:unknown-000000:WARNING-77082: Number of maximum file descriptors (1024) is lower than recommended value 98304
Apr 23 16:49:30 cen7 parstream-server[5186]: [2018-04-23T16:49:30]:unknown-000000:WARNING-77113: Maximum number of mmap'ed areas (65530) is lower than recommended value 1966080.
Apr 23 16:49:30 cen7 parstream-server[5186]: [2018-04-23T16:49:30.273380]:parstream1-164930:PROT-77045: Source Revision: 717e27f507aab73fdc0c3f9d4377ff658726c270
Apr 23 16:49:30 cen7 parstream-server[5186]: Local Changes:
Apr 23 16:49:30 cen7 parstream-server[5186]: [2018-04-23T16:49:30.278632]:parstream1-164930:PROT-77018: cluster node config: ClusterNodeConfig(clusterId = 'localCluster', claimLeadershipInitT...geInterval = 0
Apr 23 16:49:30 cen7 parstream-server[5186]: [2018-04-23T16:49:30.280474]:parstream1-164930:PROT-77018: channel instance created for accept on port: 23460
Apr 23 16:49:30 cen7 parstream-server[5186]: [2018-04-23T16:49:30.281084]:parstream1-164930:PROT-77134: Entering state ClaimLeadershipState, got event InitialEvent
Apr 23 16:49:30 cen7 parstream-server[5186]: [2018-04-23T16:49:30.281243]:parstream1-164930:PROT-77065: Running cluster leader detection (limited until 2018-Apr-23 16:51:30)
Hint: Some lines were ellipsized, use -l to show in full.
[root@cen7 ~]# systemctl stop parstream

Come si può vedere, i processi ParStream vengono avviati sotto l'utente definito nei file del servizio e tutto viene pulito dopo la richiesta di arresto dei servizi.

Risoluzione dei problemi

Le informazioni contenute in questa sezione permettono di risolvere i problemi relativi alla configurazione.

Se si verificano problemi durante l'avvio, verificare quanto segue:

• Parametri configurabili nel file init.d o nel file di servizio di sistema (utente, percorsi, nome server ParStream)
• Controllare l'output del file di registro per ParStream (in /var/log/parstream)
• Per SystemD: output del parstream di stato systemctl
• Output di journalctl —unit=parstream