Documentazione

Dettagli di esecuzione

Quando si seleziona la casella di controllo Esegui in remoto, la finestra di dialogo cambia e consente di inserire la porta ssh e le credenziali per eseguire il comando o lo script in remoto:

Quando si seleziona il pulsante di opzione Script in linea, la finestra di dialogo cambia e consente di inserire il codice di scripting all'interno di una casella di testo più grande:

Parametri di esecuzione

L'elenco a discesa Tag consente di inserire variabili predefinite nei campi sopra, ad esempio $NAME$ per il nome del lavoro.

La directory di lavoro dell'esecuzione dello script è /var/opt/run/eranger/collector, quindi specificando un percorso file relativo come bin/script.sh all'interno dello script Inline o del percorso Programma si farà riferimento a /var/opt/run/eranger/collector/bin/script.sh.

Esegui funzioni di inclusione per bash, perl e python

Selezionando il pulsante di opzione Script inline è possibile inserire uno script nella casella di testo grande. Sono supportati i linguaggi di scripting bash, perl e python. Il lavoro Execute offre varie funzioni include per questi linguaggi per mappare l'output dello script ai valori di ritorno, ai valori stringa e al messaggio informativo. Per poter utilizzare queste funzioni, è necessario prima includerle posizionando il cursore sulla prima riga della casella di testo Script inline e selezionando la funzione include corrispondente per uno dei 3 linguaggi di scripting dall'elenco a discesa Tag:

Ad esempio, aggiungendo la voce della funzione di inclusione sh/bash si aggiunge il seguente codice allo script inline:

Ora è possibile utilizzare le seguenti funzioni all'interno dello script per mappare valori numerici e stringhe a valori di ritorno, valori stringa e messaggi informativi:

Esegui valori e limiti di allarme

Esempi di esecuzione

Esempio 1 - Eseguire un singolo comando con più argomenti della riga di comando

I seguenti parametri eseguiranno il comando sudo per eseguire uno script per riavviare il servizio di report in SKOOR Engine:

Non è necessario definire valori di ritorno o stringhe, verrà controllato solo il codice di uscita del comando combinato.

Output 1

Se il comando non dovesse funzionare per qualche motivo, inserire un nome di file nella casella di testo del parametro Salva output su file:

L'output standard e/o l'errore standard del comando verranno reindirizzati in quel file. È possibile visualizzarlo dalla sezione dei valori del lavoro:

Fare clic sul pulsante Aggiorna file, il nome del file si trasforma in un collegamento:

Fare clic sul collegamento per visualizzare l'output del comando in una scheda o finestra separata del browser:

Running /opt/eranger/bin/eRanger.sh with root privileges...
eRanger Server installation...
waiting up to 15 seconds for 7090 to terminate 

Stopping eranger-report[  OK  ]
Starting eranger-report[  OK  ]

Esempio 2 - Eseguire uno script inline con funzioni bash include

Contenuto della casella di testo dello script inline per un semplice calcolo di un numero casuale:

. /opt/eranger/collector/eranger_exec_values.sh

newValue=$RANDOM
lastValue=$(getLastErangerValue 1)

diffValue=$(expr $newValue - $lastValue)

setErangerValues $newValue $diffValue
outputErangerValues

È necessario definire due valori di ritorno come configurato nello script inline. Nell'esempio seguente, sono stati definiti Nuovo valore e Differenza:

Facendo clic sul pulsante Unità è possibile specificare i dettagli del valore:

Output 2

Esempio 3 - Eseguire uno script inline con funzioni bash include e utilizzando le proprietà personalizzate del lavoro come variabili dello script

Quanto segue eseguirà uno script specificato come variabile con argomenti script passati da una proprietà personalizzata. Lo script scarica un file specificato (argomento 2) da un server FTP (argomento 1).

La proprietà personalizzata per gli argomenti della riga di comando deve essere definita prima utilizzando il menu Admin. Fare clic sul pulsante Admin nell'angolo in alto a destra della vista di configurazione, quindi selezionare Proprietà personalizzate dall'elenco a discesa Cerca:

Fare clic sul pulsante + nella parte inferiore dello schermo. Viene visualizzata la sezione Proprietà aggiunte di recente:

Assegnare un nome alla proprietà personalizzata, quindi specificare che questa proprietà personalizzata deve essere disponibile solo per gli oggetti di lavoro:

Fare clic su Applica, quindi individuare l'ID della proprietà appena aggiunta passando con il mouse sul suo nome:

Esci dal menu Admin facendo nuovamente clic sul pulsante Admin nell'angolo in alto a destra. La proprietà personalizzata è ora disponibile per essere aggiunta a ogni processo.

Aggiungila al lavoro Esegui e compila i parametri della riga di comando per lo script a cui fa riferimento lo script Inline:

In questo caso ci sono 2 argomenti della riga di comando, delimitati da uno spazio.

Ora aggiungi il contenuto della casella di testo Script inline:

. /opt/eranger/collector/eranger_exec_values.sh

SCRIPT="/var/opt/run/eranger/bin/ftp_download_local.sh"

PARAMS="$OID_74$"

VALUE=$(${SCRIPT} ${PARAMS})
setErangerValue 1 $VALUE
outputErangerValues

Quindi aggiungi 1 valore di ritorno:

Lo script restituisce la velocità di download FTP in kB/s, quindi è necessario aggiungere un divisore per convertire in MBit/s.

Il vantaggio principale dell'utilizzo di proprietà personalizzate per alimentare gli argomenti è che è possibile riutilizzare lo stesso blocco di codice dello script inline per molti lavori utilizzando un modello di lavoro (vedere la sezione Modelli) e avere solo la proprietà personalizzata che differisce tra i vari lavori.

Output 3

Esempio 4 - Eseguire uno script inline con funzioni bash include e utilizzando una chiamata ssh remota

Il seguente script inline esegue un comando in remoto utilizzando il comando ssh. Si presume che l'autenticazione ssh sia già configurata utilizzando chiavi pubbliche senza password, quindi non viene richiesta alcuna password quando ci si connette al server ssh remoto.

Il comando legge il numero di processi ddclient in esecuzione in remoto. Viene utilizzata la variabile interna $DEVICE_ADDRESS$.

. /opt/eranger/collector/eranger_exec_values.sh

cmd="ps -u root | grep 'ddclient - ' | wc -l"
num_procs=$(ssh -o ConnectTimeout=15 -o ConnectionAttempts=1 eranger@$DEVICE_ADDRESS$ "$cmd")

setErangerValue 1 $num_procs
outputErangerValues

Aggiungere 1 valore di ritorno:

Output 4

Esempio 5 - Eseguire un comando in remoto tramite ssh

L'esempio seguente utilizza la casella di controllo Esegui in remoto per poter inserire le credenziali di autenticazione ssh ed eseguire un comando su una macchina remota:

Durante l'esecuzione in remoto non è possibile utilizzare valori di ritorno o valori stringa, ma viene controllato solo il codice di uscita.

Output 5

Esempio 6 - Esecuzione di una query WMI su un server Windows 2000 e lettura del relativo registro eventi

Utilizzare il seguente script inline:

. /opt/eranger/collector/eranger_exec_values.sh

# this does a wmi query to windows 2000 servers
# for server 2003 upwards, use the dedicated "Agent Eventlog"
# job plugin directly.
# for the query to work, port tcp135 and the portrange tcp1025-tcp65535 
# must be accessible from this collector to the remote windows server

# BEWARE: when querying the eventlog for lots of events, especially events
# of severity 3, the query can take a very long time, sometimes hours.
# However, the maximum allowed runtime of a SKOOR execute job is merely 5
# minutes after which the job will kill this script and exit with a warning

# login credentials for wmi query (needs to be either an administrator 
# account or must have sufficient privileges to do remote wmi queries

USER=skoor
PWD=<fill in password here>

# Filter parameters (uncomment only parameters that are used)

# Logfile can be \'Application\', \'Security', 
# \'System\', or e.g. \'CustomEventLog\'
Logfile=\'Application\'

# Event source (always enclose in \'....\')
SourceName=\'FEP\'

# Event ID
#EventCode=203

# Severity (1=Error, 2=Warning, 3=Information, 
# 4=Security Audit Success, 5=Security Audit Failure)
EventType=1

# Event description (find events that contain the following string(s) 
# anywhere in the event description)
#Message='string1'
#Message='string1|string2' (for filtering multiple strings inside message field, use pipe delimiter)
Message='WSAECONNREFUSED'

# search only events which have been logged
# during the last XXX minutes (always adapt 
# to job execution interval)
Maxage=3

################################################3

Maxagesec=$((Maxage*60))
Tepoch=$(date +%s)
Tstart=$((Tepoch-Maxagesec))
# get start time in UTC
Tstart_datetime=\'$(date -u -d @$Tstart +%Y%m%d%H%M00.000000+000)\'

# construct query
Query="Select Logfile,Message,RecordNumber from Win32_NTLogEvent where Logfile=${Logfile} and TimeWritten>${Tstart_datetime}"
[ ! -z "${SourceName}" ] && Query+=" and SourceName=${SourceName}"
[ ! -z "${EventCode}" ] && Query+=" and EventCode=${EventCode}"
[ ! -z "${EventType}" ] && Query+=" and EventType=${EventType}"
echo "WMI Query is ${Query}"

wmic -U ${USER}%${PWD} //$DEVICE_ADDRESS$ "${Query}" > $DEVICE_NAME$_$ID$_eventlog.out
RC=$?

if [ ! -z "${Message}" ]; then
   Eventcount=$(grep -v dcerpc_connect $DEVICE_NAME$_$ID$_eventlog.out | grep -v 'Login to remote object' | egrep ${Message} | wc -l)
else
   Eventcount=$(grep -v dcerpc_connect $DEVICE_NAME$_$ID$_eventlog.out | grep -v 'Login to remote object' | wc -l)
fi

setErangerValue 1 $Eventcount
setErangerValue 2 $RC
outputErangerValues

Quindi aggiungere 2 valori di ritorno:

Output 6

Esempio 7 - Download wget con terminazione automatica dopo 45 secondi

Utilizzare la seguente notazione per assicurarsi che il comando esterno (wget in questo caso) venga terminato automaticamente se dura più di 45 secondi:

(sleep 45; kill -9 -$$) &
wget -O /dev/null http://www.debian.org/netinst.iso