cfgmaker - Online nel cloud

PROGRAMMA:

NOME

cfgmaker - Crea file mrtg.cfg (per mrtg-2.17.4)

SINOSSI

cfgmaker [opzioni] [community@]router [[opzioni] [community@]router ...]

VERSIONI

--ifref=nome riferimenti all'interfaccia per nome interfaccia (predefinito)
--ifref=ip ... per indirizzo IP
--ifref=eth ... per numero Ethernet
--ifref=descr ... dalla descrizione dell'interfaccia
--ifref=nr ... per numero interfaccia
--ifref=tipo ... per tipo di interfaccia
Puoi anche utilizzare più opzioni separate da virgole,
in tal caso si utilizza il primo disponibile:
ad es. --ifref=ip,nome,nr

--ifdesc=nr la descrizione dell'interfaccia usa il numero di interfaccia (predefinito)
--ifdesc=ip ... usa l'indirizzo IP
--ifdesc=eth ... usa il numero Ethernet
--ifdesc=descr ... usa la descrizione dell'interfaccia
--ifdesc=nome ... usa il nome dell'interfaccia
--ifdesc=catname ... usa il nome dell'interfaccia CatOS
--ifdesc=ppname ... usa il nome della porta del passaporto
--ifdesc=alias ... usa l'alias dell'interfaccia
--ifdesc=tipo ... usa il tipo di interfaccia
Puoi anche utilizzare più opzioni separate da virgole,
in tal caso si utilizza il primo disponibile:
ad es. --ifdesc=catname,ppname,descr,alias,ip,name,nr

--if-filter=f Testa ogni interfaccia contro il filtro f per decidere se
o non includere quell'interfaccia nella raccolta.
Attualmente f viene valutato come un'espressione Perl
e il suo valore di verità viene utilizzato per rifiutare o accettare il
interfaccia.
(Sperimentale, in fase di sviluppo, potrebbe cambiare)

--if-template=filemodello
Sostituisci le normali voci di destinazione per le interfacce
con una voce come specificato dai contenuti nel file
file modello. Il file dovrebbe contenere Perl
codice da eseguire per generare le righe per il
destinazione nel file di configurazione.
(Sperimentale, in fase di sviluppo, potrebbe cambiare)

--host-template=filetemplate
Oltre a creare target per le interfacce di un host
crea anche obiettivi per l'host stesso come specificato
dai contenuti nel file templatefile. Il file è
dovrebbe contenere codice Perl da eseguire per generare
le linee per i target relativi all'host (come CPU,
misurazioni del tempo di risposta al ping, ecc.) nella configurazione
urazione file.
(Sperimentale, in fase di sviluppo, potrebbe cambiare)

--global "x: a" aggiunge voci di configurazione globali

--no-down non guardare lo stato admin o opr delle interfacce

--show-op-down mostra le interfacce che sono operativamente inattive

--zero-speed=spd usa questa velocità in bit al secondo come interfaccia
velocità per tutte le interfacce che restituiscono una velocità di 0
tramite ifSpeed/ifHighSpeed. 100Mbps = 100000000

--subdirs=format assegna a ogni router la propria sottodirectory, nominando ogni per
"formato", in cui HOSTNAME e SNMPNAME saranno
sostituito dai valori di tali elementi, ad esempio
--subdirs=NOMEHOST o --subdirs="NOMEHOST (SNMPNAME)"

--noreversedns non esegue la ricerca inversa dei numeri IP

--community=cmty Imposta la stringa della community predefinita su "cmty" invece di
"pubblico".

--enable-ipv6 Abilita il supporto IPv6, se le librerie richieste sono
regalo. Gli indirizzi IPv6 numerici devono essere racchiusi
tra parentesi quadre, ad es. public@[2001:760:4::1]:161

--use-16bit Utilizza gli ID di richiesta SNMP a 16 bit per interrogare tutti i router.

--snmp-opzioni=:[ ][:[ ][:[ ][:[ ][: ]]]]

Specifica le opzioni SNMP predefinite da aggiungere a tutti
router che seguono. I singoli campi possono essere vuoti.
I router seguenti potrebbero sovrascrivere alcuni o tutti i
opzioni date a --snmp-options.

--dns-domain=dominio
Specifica un dominio da aggiungere al nome di tutti
router che seguono.

--nointerfaces Non genera linee di configurazione per le interfacce,
salta la fase di raccolta delle informazioni sull'interfaccia e
non eseguire alcun codice modello di interfaccia.

--interfaces Genera linee di configurazione per le interfacce (questo è il
predefinito). Lo scopo principale di questa opzione è negare
un --nointerfaces che appare in precedenza sulla riga di comando.

--help breve messaggio di aiuto
--man documentazione completa
--version stampa la versione di cfgmaker

--output=il nome del file di output del file predefinito è STDOUT

DESCRIZIONE

Creatore di CFG crea file di configurazione MRTG in base alle informazioni estratte da un router o
un altro dispositivo gestibile da SNMP.

[comunità@]router

Comunita' è il nome della comunità del dispositivo per il quale si desidera creare una configurazione. Se
non specificato, il valore predefinito è 'la percezione'; potresti provare prima questo se non lo fai
conoscere il nome della comunità di un dispositivo. Se stai usando il nome della community sbagliato, lo farai
non ricevere risposta dal dispositivo.

router è il nome DNS o il numero IP di un dispositivo gestibile da SNMP. Seguendo il nome
puoi specificare 6 ulteriori opzioni separate da due punti. La sintassi completa è simile a questa:

router[:[prt][:[tout][:[retr][:[retrocedere][:a]]]]]

Di particolare interesse può essere l'ultimo parametro, a. Se lo imposti a '2' allora il tuo
dispositivo verrà interrogato con le richieste SNMP versione 2. Ciò consente di eseguire il polling a 64 bit
contatori di traffico nel dispositivo e funzionerà quindi molto meglio con interfacce veloci (no
più superamento del contatore). Notare che l'ordine in cui i router sono specificati sul
la riga di comando è importante poiché lo stesso ordine viene utilizzato quando viene generato il file di configurazione.
Il primo router specificato ha le sue linee di configurazione generate per prime, seguite da
linee appartenenti al router successivo e così via.

Nota che la prima riga del file cfg generato conterrà tutta la riga di comando
opzioni che hai usato per generarlo. Questo per consentire la facile "rigenerazione" nel caso
vuoi aggiungere nuovi host o apportare altre modifiche globali.

Configurazione
Tranne il --produzione ed --globale opzioni, tutte le opzioni riguardano solo i router
seguendoli sulla riga di comando. Se un'opzione specificata in precedenza sulla riga di comando
riappare in seguito sulla riga di comando con un altro valore, il nuovo valore sovrascrive il vecchio
valore per quanto riguarda i router rimanenti. In questo modo le opzioni potrebbero essere personalizzate per
gruppi di router o per singoli router.

See --produzione ed --globale per come il loro comportamento è influenzato da dove o quante volte
appaiono sulla riga di comando.

Vedere la Esempi di seguito su come impostare un'opzione in modo diverso per più router.

--Aiuto
Stampa un breve messaggio di aiuto ed esci.

--uomo
Stampa la pagina di manuale ed esce.

--versione
Stampa la versione di cfgmaker. Questo dovrebbe corrispondere alla versione di MRTG per la quale configurazione
file vengono creati.

--ifrif nr|ip|eth|descrizione|Nome
Selezionare il metodo di identificazione dell'interfaccia. L'impostazione predefinita è nr che identifica il router
interfacce in base al loro numero. Sfortunatamente lo schema di numerazione dell'interfaccia in un SNMP
albero può cambiare. Alcuni router cambiano la loro numerazione quando vengono aggiunte nuove interfacce,
altri cambiano la loro numerazione ogni luna piena solo per divertimento.

Per aggirare questo triste problema, MRTG può identificare le interfacce con altre 4 proprietà.
Nessuna di queste funziona per tutte le interfacce, ma dovresti essere in grado di trovarne una che funzioni
bene per te. Nota che in particolare gli indirizzi ethernet possono essere problematici in quanto alcuni
i router hanno lo stesso indirizzo ethernet sulla maggior parte delle loro schede di interfaccia.

Seleziona ip per identificare l'interfaccia tramite il suo numero IP. Uso eth usare l'ethernet
indirizzo per l'identificazione. Uso descrizione per utilizzare la descrizione dell'interfaccia. Oppure usa Nome a
utilizzare il nome dell'interfaccia.

Se lo desideri, puoi specificare più proprietà, separate da virgole. In questo caso,
cfgmaker utilizzerà il primo elemento nell'elenco che può fornire un'identificazione univoca.
Ciò consente di specificare, ad esempio, di utilizzare l'indirizzo IP e di utilizzare ifName se questo
non è definito:
--ifref ip,nome

Se il metodo scelto non consente l'identificazione univoca dell'interfaccia sul dispositivo,
stanno interrogando, cfgmaker te ne parlerò.

--ifdesc nr|ip|eth|descrizione|Nome|Digitare|alias
Seleziona cosa usare come descrizione dell'interfaccia. La descrizione appare in
la proprietà "Titolo[]" per il target così come l'intestazione di testo nel codice HTML
definito in "PageTop[]" del target. L'impostazione predefinita è utilizzare nr che è solo l'interfaccia
numero che non sempre è utile a chi guarda i grafici.

Ci sono altre 6 proprietà che potrebbero essere utilizzate. Uso ip se vuoi usare il
l'indirizzo IP dell'interfaccia. Uso eth se si desidera utilizzare l'indirizzo ethernet dell'interfaccia.
Se vuoi una descrizione migliore, puoi usare entrambe descrizione, Nome or alias. Esattamente
ciò che ognuno di questi fa varia tra le diverse apparecchiature, quindi potrebbe essere necessario
sperimentare. Ad esempio, per un'interfaccia seriale su un router Cisco che esegue IOS utilizzando
Nome potrebbe risultare in "S0" come descrizione dell'interfaccia, descrizione potrebbe risultare in
"Serial0" e alias potrebbe risultare in "Link to HQ" (a condizione che sia quello usato come
"descrizione" dell'interfaccia nella configurazione del router).

Infine, se vuoi descrivere l'interfaccia con il suo tipo B (cioè "ethernetCSMA",
"propPointtoPoint" ecc.) puoi usare Digitare.

Se lo desideri, puoi specificare più proprietà, separate da virgole. In questo caso,
cfgmaker utilizzerà il primo elemento nell'elenco disponibile per questa interfaccia.
Ciò consente di specificare, ad esempio, di utilizzare uno qualsiasi dei diversi alias nell'ordine
di preferenza.

--se-filtro 'filtro-espressione'
Prima di tutto, questo è in fase di sviluppo ed è sperimentale.

Usalo se vuoi avere un controllo migliore su quali interfacce vengono incluse
la configurazione. Il filtro-espressione viene valutato come un pezzo di codice Perl ed è
dovrebbe restituire un valore di verità. Se vero, includi l'interfaccia e se falso,
escludere l'interfaccia.

Per un'ulteriore discussione su come funzionano questi filtri, vedere la sezione "Dettagli su
Filtri" di seguito.

--se-modello file-modello
Prima di tutto, questo è in fase di sviluppo ed è sperimentale.

Usa questo se vuoi controllare come dovrebbe apparire la linea per ogni bersaglio nel
file di configurazione. Il contenuto del file file-modello sarà valutato come a
Programma Perl che genera le linee utilizzando determinate variabili per l'input e l'output.

Per un'ulteriore discussione su come funzionano questi modelli, vedere la sezione "Dettagli su
Modelli" di seguito.

--host-modello file-modello
Prima di tutto, questo è in fase di sviluppo ed è sperimentale.

Usa questo se vuoi avere alcuni obiettivi extra relativi all'host stesso come CPU
utilizzo, tempo di risposta del ping all'host, numero di modem occupati, ecc. I contenuti
del file file-modello sarà valutato una volta per host come un programma Perl che
genera le righe utilizzando determinate variabili per l'input e l'output.

Per un'ulteriore discussione su come funzionano questi modelli, vedere la sezione "Dettagli su
Modelli" di seguito.

--Comunità stringa-comunità
Usalo per impostare la community per i router che seguono sulla riga di comando su
stringa-comunità. I singoli router potrebbero sovrascrivere questa stringa della comunità utilizzando
la sintassi comunità@router.

--enable-ipv6
Questa opzione abilita il supporto IPv6. Richiede i moduli perl appropriati; se essi
non vengono trovati, allora IPv6 è disabilitato (consultare la documentazione di ipv6).

cfgmaker utilizzerà IPv6 o IPv4 a seconda del target. Se il target è un numerico
indirizzo, il protocollo dipende dal tipo di indirizzo. Se il target è un nome host,
cfgmaker proverà a risolvere il nome prima in un indirizzo IPv6 e poi in un IPv4
indirizzo.

Gli indirizzi numerici IPv6 devono essere specificati tra parentesi quadre.

Per esempio:

cfgmaker --enable-ipv6 [2001:760:4::1]:165:::2

Se la destinazione ha sia un indirizzo IPv6 che un indirizzo IPv4 con lo stesso nome host,
cfgmaker interroga prima la destinazione utilizzando IPv6 e in caso di errore ritorna a IPv4. Questo
è utile per i target che non supportano SNMP su IPv6.

--usa-16bit
Questa opzione impone l'utilizzo di ID richiesta SNMP a 16 bit. Alcuni agenti SNMP non funzionanti non lo fanno
accettare ID richiesta a 32 bit. Cerca di evitare il più possibile questa opzione, lamentati con
il tuo agente venditore invece.

--opzioni-snmp :[porto][:[timeout][:[riprova][:[retrocedere][:versione]]]]
Usalo per impostare le opzioni SNMP predefinite per tutti i router che seguono il comando
linea. I singoli valori potrebbero essere omessi così come i due punti finali. Notare che
i router potrebbero sovrascrivere singoli (o tutti) i valori specificati da --opzioni-snmp utilizzando
la sintassi

router[:[porto][:[timeout][:[riprova][:[retrocedere][:versione]]]]]

--globale "bla: abc"
Usalo per aggiungere opzioni globali al file di configurazione generato. Puoi chiamare --globale
più volte per aggiungere più opzioni. La linea apparirà nella configurazione solo
prima che sulla riga di comando appaia la configurazione per il router successivo.

--global "workdir: /home/mrtg"

Se vuoi alcune opzioni predefinite potresti voler mettere

--global "opzioni[_]: growright,bits"

specificando --globale dopo che l'ultimo router sulla riga di comando creerà una linea in
il file di configurazione che apparirà dopo tutti i router.

--noreversens
Non cercare di invertire i numeri IP di ricerca... un must per gli ambienti DNS free.

--no-giù
Normalmente cfgmaker non include interfacce contrassegnate con altro che
amministrativamente e operativamente UP. Con questo interruttore li ottieni tutti.

--show-op-down
Includere le interfacce che sono operativamente inattive.

--velocità zero velocità
Assegna questa velocità in bit al secondo a tutte le interfacce che restituiscono 0 per ifSpeed ​​e
ifHighSpeed. Alcuni interruttori, in particolare le apparecchiature della fonderia, restituiscono una velocità pari a zero per
alcune interfacce. Ad esempio, per avere tutte le interfacce che riportano zero impostato su 100Mbps,
usa --zero-speed=100000000.

--sottodirectory formato
Assegna a ogni router la propria sottodirectory per i file HTML e grafici (o .rrd). Il
il nome della directory è quello dato formato stringa con un paio di sostituzioni di pattern. Il
la stringa "HOSTNAME" sarà sostituita dal nome host del router (comunque tu
lo ha specificato sul cfgmaker riga di comando: potrebbe essere un nome host effettivo o solo un IP
indirizzo) e "SNMPNAME" sarà sostituito con l'idea del proprio nome del dispositivo (il
stesso nome che appare sul lato destro delle righe "Titolo"). Ad esempio, una chiamata
piace:

cfgmaker --subdirs=NOMEHOST__NOMESNMP [email protected]

comporterebbe la generazione di linee simili a:

Directory[10.10.0.18_1]: 10.10.0.18__fp2200-bothrip-1.3

--produzione filetto
Scrivi l'output da cfgmaker nel file filetto. L'impostazione predefinita prevede l'utilizzo di "STDOUT".
--produzione dovrebbe apparire solo una volta sulla riga di comando. Se usato più volte,
il file specificato dall'ultimo --produzione verrà utilizzato.

--nessuna interfaccia
Non generare righe di configurazione per le interfacce.

Questo fa sì che cfgmaker salti tutti i passaggi relativi alle interfacce, il che significa che non lo farà
qualsiasi polling del router per recuperare informazioni sull'interfaccia che accelera il
esecuzione di cfgmaker e non eseguirà alcun modello di interfaccia.

--interfacce
Questo fa sì che cfgmaker generi linee di configurazione per le interfacce (l'impostazione predefinita
comportamento).

L'uso principale di questa opzione è negare un --nointerfaces che appare in precedenza sul
riga di comando.

SNMP V3 Opzioni
Creatore di CFG supporta SNMP V3 utilizzando il Rete:SNMP modulo perl. Ci sono parametri opzionali
che influenzano il funzionamento di SNMP.

--enablesnmpv3 {sì|no}
I --enablesnmpv3 opzione è un flag opzionale per verificare la presenza di
Rete::SNMP librerie. Creatore di CFG proverà a determinare se questo flag è richiesto e
imposterà i valori automaticamente.

SNMPv3 argomenti

Un contesto SNMP è una raccolta di informazioni di gestione accessibili da un'entità SNMP. Un
l'elemento delle informazioni di gestione può esistere in più di un contesto e un'entità SNMP
potenzialmente ha accesso a molti contesti. La combinazione di un contextEngineID e a
contextName identifica in modo univoco un contesto all'interno di un dominio amministrativo. In un
Il messaggio SNMPv3, il contextEngineID e il contextName sono inclusi come parte dello scopedPDU.
Tutti i metodi che generano un messaggio SNMP richiedono facoltativamente a --contextengineid ed
--nomecontesto argomento per configurare questi campi.

ID motore di contesto
I --contextengineid argomento si aspetta una stringa esadecimale che rappresenta il desiderato
contestoEngineID. La stringa deve essere lunga da 10 a 64 caratteri (da 5 a 32 ottetti) e può
essere preceduto da uno "0x" opzionale. una volta che --contextengineid è specificato che rimane
con l'oggetto fino a quando non viene modificato di nuovo o ripristinato ai valori predefiniti passando il
valore indefinito. Per impostazione predefinita, contextEngineID è impostato per corrispondere a
authoritativeEngineID del motore SNMP autorevole.

Nome contesto
Il contextName viene passato come una stringa che deve essere lunga da 0 a 32 ottetti usando il
--nomecontesto discussione. Il contextName rimane con l'oggetto finché non viene modificato.
Il nomecontesto per impostazione predefinita è una stringa vuota che rappresenta il contesto "predefinito".

Basato sull'utente Sicurezza Modello argomenti

Il modello di sicurezza basato sull'utente (USM) utilizzato da SNMPv3 richiede che un securityName sia
specificato utilizzando il --nome utente discussione. La creazione di un oggetto Net::SNMP con il
la versione impostata su SNMPv3 fallirà se il --nome utente argomento non è presente. Il --nome utente
argomento si aspetta una stringa da 1 a 32 ottetti di lunghezza.

Diversi livelli di sicurezza sono consentiti dal modello di sicurezza basato sull'utente che affronta
problemi di autenticazione e privacy. Un target SNMPv3 deriverà il livello di sicurezza
(securityLevel) in base a quale dei seguenti argomenti sono specificati.

Per impostazione predefinita, viene assunto un securityLevel di 'noAuthNoPriv'. Se la --chiave d'autenticazione or
--password di autorizzazione vengono specificati gli argomenti, securityLevel diventa 'authNoPriv'. Il
--password di autorizzazione L'argomento si aspetta una stringa lunga almeno 1 ottetto. Facoltativamente,
, il --chiave d'autenticazione l'argomento può essere usato in modo che una password in testo semplice non debba essere
specificato in uno script. Il --chiave d'autenticazione argomento si aspetta una stringa esadecimale prodotta da
localizzazione della password con l'authoritativeEngineID per la destinazione specifica
dispositivo. L'utility "snmpkey" inclusa con la distribuzione Net::SNMP può essere utilizzata per
creare la stringa esadecimale (vedi snmpkey).

SNMPv3 definisce due diversi algoritmi di hash che possono essere utilizzati dalla sicurezza
Modello per l'autenticazione. Questi algoritmi sono HMAC-MD5-96 "MD5" (RFC 1321) e
HMAC-SHA-96 "SHA-1" (NIST FIPS PUB 180-1). L'algoritmo predefinito utilizzato dal modulo è
HMAC-MD5-96. Questo comportamento può essere modificato utilizzando il --protocollo di autorizzazione discussione. Questo
l'argomento si aspetta che venga passata la stringa 'md5' o 'sha' per modificare l'hash
algoritmo.

Specificando gli argomenti --chiave privata or --password privata il livello di sicurezza associato a
l'oggetto diventa 'authPriv'. Secondo SNMPv3, la privacy richiede l'uso di
autenticazione. Pertanto, se uno di questi due argomenti è presente e il --chiave d'autenticazione
or --password di autorizzazione mancano gli argomenti, la creazione dell'oggetto non riesce. Il --chiave privata
ed --password privata gli argomenti si aspettano lo stesso input di --chiave d'autenticazione ed --password di autorizzazione
argomenti rispettivamente.

Il modello di sicurezza basato sull'utente descritto nella RFC 3414 definisce un singolo protocollo di crittografia
da utilizzare per la privacy. Questo protocollo, CBC-DES "DES" (NIST FIPS PUB 46-1), è utilizzato da
default o se la stringa 'des' viene passata a --protocollo privato discussione. Lavorando con
il Consorzio Opzioni di Sicurezza Estesa http://www.snmp.com/eso/, anche il modulo
supporta protocolli aggiuntivi che sono stati definiti nella bozza delle specifiche. La bozza
http://www.snmp.com/eso/draft-reeder-snmpv3-usm-3desede-00.txt definisce il supporto di
CBC-3DES-EDE "Triple-DES" (NIST FIPS 46-3) nel modello di sicurezza basato sull'utente. Questo
il protocollo può essere selezionato utilizzando il --protocollo privato argomento con la stringa '3dedede'. Il
bozza http://www.snmp.com/eso/draft-blumenthal-aes-usm-04.txt descrive l'uso di
CFB128-AES-128/192/256 "AES" (NIST FIPS PUB 197) nell'USM. Le tre crittografia AES
i protocolli, differenziati per le dimensioni delle chiavi, possono essere selezionati passando 'aescfb128',
'aescfb192', o 'aescfb256' al -protocollo privato discussione.

Dettagli on Filtri
Lo scopo dei filtri è decidere quali interfacce accettare e quali interfacce
rifiutare. Questa decisione viene presa per ciascuna interfaccia valutando l'espressione del filtro come a
pezzo di codice Perl e indagando sul risultato della valutazione. Se è vero, accetta il
interfaccia altrimenti rifiutarlo.

Quando lavori con i filtri, ricorda che Perl ha la sua idea di cosa sia vero e falso
è. La stringa vuota "" e la stringa "0" sono false, tutte le altre stringhe sono vere. Questo
implica inoltre che qualsiasi valore intero di 0 è falso così come qualsiasi valore undef. anche
implica che tutti i riferimenti sono considerati veri.

Poiché il filtro viene valutato come un'espressione Perl, diversi costrutti utili in Perl sono
Vale la pena citare:

Le espressioni possono essere raggruppate utilizzando le parentesi "()". Le espressioni potrebbero essere combinate
utilizzando operatori booleani come i seguenti:

"ed" (equivalente a "&&")
Booleano "e" delle due espressioni, è vero solo se entrambe le espressioni sono vere.
Esempio: espressione1 ed espressione2

"or" (equivalente a "||")
Booleano "o" delle due espressioni, è vero se una o entrambe le espressioni sono vere.
Esempio: espressione1 or espressione2

"non" (equivalente a "!")
Negazione booleana di una singola espressione. Esempio: non espressione . ancora un altro
esempio: !espressione

(Per maggiori dettagli su questo consiglio un libro su Perl)

predefiniti Filtro Variabili

Per facilitare, sono disponibili una serie di valori predefiniti da utilizzare nel filtro.
Nota che queste variabili sono disponibili anche quando vengono valutate le interfacce dei modelli (ma
non host modelli).

Avvertenza: tutti i nomi di queste variabili iniziano con il simbolo del dollaro ($), che è una sintassi
requisito per le variabili scalari in Perl. Il pericolo qui è che il simbolo del dollaro in molti
shellsèun carattere attivo (spesso usato per le variabili di shell esattamente come in Perl
variabili) quindi è importante assicurarsi che l'espressione Perl non venga valutata dal
shell della riga di comando come codice shell prima di essere passato a cfgmaker come riga di comando
argomenti. In shell come Bourne shell, ksh shell o bash shell, posizionando l'intero
l'espressione all'interno di singole quote eviterà tale valutazione accidentale:

'--if-filter=($default_iftype && $if_admin)'

$se_tipo
Questo è un numero intero che specifica il tipo di interfaccia secondo gli standard SNMP e come
segnalato dal dispositivo interrogato. Un elenco completo dei tipi di interfaccia sarebbe
poco pratico per questo documento , ma ci sono un numero di variabili predefinite di seguito.
Normalmente, cfgmaker inserisce nel PageTop del target questo valore iftype tra parentesi
dopo il nome del tipo di interfaccia. (es. "propPointToPointSerial (22)").

Ecco un elenco di alcuni dei tipi di interfaccia più comuni per numero:

6 ethernet Csmacd
7iso88023Csmacd
9 iso88025 Token Ring
15 fddi
19 E1
20 ISDN di base
21 ISDN primario
22 propPuntoToPuntoSeriale
23 ppp
24 software Loopback
30 d3
32 frame-relè
33 rs232
37 atm
39 sonetto
44 frameRelèService
46 ore
49 aal5
53 propVirtuale
62 Ethernet veloce (100BaseT)
63 ISDN e X.25
69 Fast Ethernet duplex completo (100BaseFX)
94 Ciclo abbonato digitale asimmetrico (ADSL)
117 Gigabit Ethernet
134 Interfaccia secondaria ATM

$predefinito
Vero se e solo se cfgmaker normalmente dovrebbe accettare l'interfaccia basata su
interfacce amministrative e stato operativo (prendendo le bandiere --no-giù ed
--show-op-down in considerazione) ed è type (e poche altre cose).

$default_ifstate
Vero se e solo se cfgmaker avrebbe accettato l'interfaccia in base a essa
stati operativi e amministrativi (tenendo conto anche della presenza del
bandiere --no-giù ed --show-op-down).

$default_iftipo
Vero se e solo se cfgmaker avrebbe accettato l'interfaccia in base al suo tipo (e
alcuni dettagli specifici del tipo in aggiunta).

$se_admin
Vero se e solo se l'interfaccia è in uno stato amministrativo attivo.

$se_opera
Vero se e solo se l'interfaccia è in uno stato operativo attivo.

Sono inoltre predefinite un certo numero di variabili per decidere facilmente se un'interfaccia appartiene a a
determinata categoria o meno. Di seguito sono elencate tutte quelle variabili insieme a cui if_type
numeri per i quali ogni variabile sarà vera. Nota che alcune variabili si riferiscono ad altre variabili
come pure.

$se_è_ethernet
Vero per le interfacce ethernet (nr 6, 7, 26, 62, 69 e 117).

$se_è_isdn
Vero per vari tipi di interfaccia ISDN (nr 20, 21, 63, 75, 76 e 77)

$se_è_dialup
Vero per interfacce dial-up come PPP e ISDN. (n. 23, 81, 82 e 108 in
oltre ai numeri di $se_è_isdn).

$ se_è_atm
Vero per vari tipi di interfaccia relativi ad ATM (nr 37, 49, 107, 105, 106, 114 e
134).

$se_è_wan
Vero per le interfacce WAN punto-punto, Frame Relay e High Speed ​​Serial (
22,32,44,46)

$se_è_lan
Vero per le interfacce LAN (8, 9, 11, 15, 26, 55, 59, 60 e 115 oltre al
numeri di $se_è_ethernet).

$se_è_dsl
Vero per ADSL, RDSL, HDSL e SDSL (nr 94, 95, 96, 97)

$se_è_loopback
Vero per interfacce software loopback (nr 24)

$se_is_ciscovlan
Vero per le interfacce Cisco VLAN (interfacce con la parola Vlan o VLAN nelle loro
ifdesc)

$if_vlan_id
Restituisce l'ID vlan associato a una porta specifica sugli switch Cisco Catalyst sotto
sia Catalyst OS che IOS e switch 3Com. Se non è un'interfaccia vlan, will
ritorno indif.

$se_cisco_trunk
Restituisce lo stato del trunking di una porta specifica sugli switch Cisco Catalyst in entrambi
Catalyst OS e IOS. Restituisce "1" se l'interfaccia è un trunk, undef altrimenti.

$se_MTU
Restituisce l'unità di trasferimento massima associata a una porta specifica.

Oltre a ciò, puoi anche utilizzare le variabili definite per i modelli di seguito. Inoltre, tutto
le variabili disponibili in cfgmaker sono a disposizione degli script anche se l'uso di tali
caratteristiche è scoraggiato. Saranno più "scorciatoie" sotto forma di variabili e funzioni
reso disponibile in futuro invece.

Esempi on Filtri

Il seguente filtro non influenzerà quali interfacce vengono incluse o escluse, lo farà
fare in modo che cfgmaker si comporti normalmente.

'--if-filter=$predefinito'

Il seguente filtro farà in modo che cfgmaker escluda le interfacce PPP (23):

'--if-filter=$predefinito && $if_type!=23'

Il seguente filtro farà comportare cfgmaker come al solito tranne che considererà il
stato operativo di un'interfaccia irrilevante ma rifiuta comunque tutte le interfacce che sono
amministrativamente in basso.

'--if-filter=$if_admin && $default_iftype'

Dettagli on Modelli
Il contenuto dei file modello viene valutato come un programma Perl. Un numero o Perl
le variabili sono disponibili per la lettura del programma e altre sono utilizzate per la scrittura.

Poiché molte delle variabili predefinite hanno valori che dovrebbero essere utilizzati in
Il codice HTML alcuni di essi hanno una variante "con escape HTML", ad es. $html_syslocation è l'HTML
variante con escape di $syslocation. L'escape HTML significa che i caratteri "<", ">" e "&"
sono sostituiti da "<", ">" e "&" e che le nuove righe incorporate nella stringa sono
preceduto da " " e aggiunto con un carattere spazio (se una nuova riga è l'ultima nel
stringa non viene toccato).

Scrivibile Modello Variabili

Queste sono le variabili disponibili per memorizzare le righe di configurazione. Alcune di esse sono
inizializzato prima della valutazione del modello ma tale contenuto normalmente è commenti
per l'inclusione nel file di configurazione finale in modo che quelle variabili possano essere reimpostate su
stringa vuota nel codice del modello per eliminare i commenti. Anche il contrario è
possibile, il contenuto di queste variabili potrebbe essere esteso con ulteriori informazioni per
vari motivi come il debug ecc.

Una volta valutato il template, accade quanto segue: se il template è a
il modello di interfaccia e l'interfaccia effettiva per qualche motivo vengono rifiutati e quindi devono
essere commentate, tutte le righe nella variabile $righe_obiettivo sono trasformati in commenti da
aggiungendo un cancelletto ("#") all'inizio. Allora tutte le variabili $righe_testata,
$righe_problematiche , $righe_obiettivo ed $linee_separatrici sono concatenati insieme per formare il
righe da aggiungere al file di configurazione.

$righe_obiettivo
Questa variabile è il segnaposto per le righe di configurazione create dal modello.
$righe_obiettivo è predefinito per essere vuoto quando viene valutato il codice del modello.

$righe_testata
Questa variabile è intesa come segnaposto per la riga di commento che appare solo
prima della destinazione nel file di configurazione. Viene inizializzato con quella riga di commento
prima della valutazione del codice del template e se il template non cambia
$righe_testata durante la valutazione, il commento apparirà come di consueto nel file di configurazione.

$righe_problematiche
Questa variabile è intesa come segnaposto per le righe di commento che descrivono qualsiasi
problemi che potrebbero essere stati riscontrati durante il tentativo di aggiungere il target nel
configurazione. Per i modelli host normalmente non viene utilizzato e per quelli lo è
predefinito come stringa vuota. Per i modelli di interfaccia $righe_problematiche è predefinito
con i commenti sulla descrizione dell'errore che cfgmaker normalmente utilizzerebbe per rifiutato
interfacce o come stringa vuota per le interfacce accettate.

È possibile testare contro $righe_problematiche per scoprire se un'interfaccia sarà
incluso o rifiutato, ma questo non è raccomandato. Prova contro $se_ok anziché.

$linee_separatrici
Questa variabile è il segnaposto per la stringa da usare come separatore tra i
codice per i singoli obiettivi. Il contenuto di questa variabile viene inserito dopo ogni obiettivo
(quindi le linee appariranno anche dopo la fine dell'ultimo target nella configurazione).

predefiniti Modello Variabili

Tutte le variabili seguenti sono disponibili per i modelli di interfaccia da utilizzare. Per i modelli host,
sono disponibili solo quelli elencati in "Host e Variabili di sistema".

Per i modelli di interfaccia le variabili elencate in "Variabili di filtro predefinite" sono anche
a disposizione.

ospite ed Sistema Variabili

$nome_router
Questo è il nome completo del router. È influenzato da quanto segue
elementi sulla riga di comando: il nome del router stesso e --dominio-dns.

$connessione_router
Questa è la stringa di riferimento per il router che viene interrogato. È sul modulo
community@router possibilmente seguito da alcune opzioni snmp. È influenzato da
seguenti elementi sulla riga di comando: il nome del router stesso, --Comunità,
--opzioni-snmp ed --dominio-dns. (Non sono disponibili varianti con escape HTML)

$nome_directory
Questa variabile dovrebbe contenere il nome della directory come normalmente cfgmaker userebbe come
valore per la direttiva "Directory[]". Il valore è determinato da --sottodirectory
opzione della riga di comando. Se --sottodirectory non è specificato $nome_directory sarà il vuoto
corda. (Non sono disponibili varianti con escape HTML)

$syscontact
Questa variabile è il valore SNMP sysContact del router. (variante con escape HTML:
$html_syscontatto)

$ sysname
Questa variabile è il valore sysName SNMP del router. (Nessuna variante HTML con escape disponibile)

$ posizione di sistema
Questa variabile è il valore SNMP sysLocation del router. (variante con escape HTML:
$html_posizione di sistema)

$syscr
Questa variabile è il valore SNMP sysDescr del router. Normalmente non è utilizzato da
cfgmaker ma potrebbe essere utile in un modello. (variante con escape HTML: $html_sysdescr)

Interfaccia Target Leggi Anche Variabili

$nome_obiettivo
Questo è ciò che normalmente cfgmaker userebbe come nome del target. Il bersaglio
nome è ciò che si trova all'interno delle parentesi quadre, "[]", per le direttive di destinazione.
(Non sono disponibili varianti con escape HTML)

$se_rif
Questa è la stringa di riferimento per l'interfaccia. Si prevede di essere utilizzato nel
Direttiva "Target[xyz]" per distinguere quale interfaccia utilizzare. Il valore di questo
variabile è influenzata da --ifrif opzione della riga di comando. Normalmente è usato insieme
con $connessione_router. (Non sono disponibili varianti con escape HTML)

$se_ok
Questa variabile è vera se l'interfaccia sarà inclusa nella configurazione
file, altrimenti falso. Non eseguire il test rispetto ad altre variabili come $righe_problematiche a
scopri se un'interfaccia verrà rifiutata o meno, usa questo $se_ok anziché.

$ linee_di_destinazione predefinite
Questa variabile contiene tutte le linee di destinazione che cfgmaker di default emette per questo
interfaccia. È utile se vuoi avere il "target standard" ma vuoi aggiungerne qualcuno
linee extra ad esso utilizzando un modello.

Per impostazione predefinita, cfgmaker utilizza le seguenti direttive per ogni target che genera: Target[],
SetEnv[], MaxBytes[], Title[], PageTop[] e se è presente una directory specificata anche il
Direttiva Directory[].

Per facilitare la creazione di modelli che generano configurazioni di destinazione simili
a quella di default, ciascuna delle suddette linee di direttiva ha un corrispondente
variabile contenente la riga come cfgmaker l'avrebbe emessa per impostazione predefinita.

Nota che nessuno di questi ha una variante con escape HTML, il testo in essi è con escape HTML dove
necessario. Si noti inoltre che non hanno alcuna nuova riga alla fine.

$direttiva_destinazione_predefinita
Questa variabile contiene la stringa predefinita per la riga della direttiva Target[].

$direttiva_imposta_predefinita
Questa variabile contiene la stringa predefinita per la riga della direttiva SetEnv[].

$default_directory_directory
Questa variabile contiene la stringa predefinita per la riga direttiva Directory[] che
significa che è una stringa vuota (senza newline) se non c'è una directory.

$ default_maxbyte_direttiva
Questa variabile contiene la stringa predefinita per la riga della direttiva MaxBytes[].

$predefinito_titolo_direttiva
Questa variabile contiene la stringa predefinita per la riga della direttiva Title[].

$direttiva_top_pagina_predefinita
Questa variabile contiene la stringa predefinita per le righe della direttiva PageTop[].

Interfaccia Network NetPoulSafe Configurazione Variabili

$se_ip
Questa variabile dovrebbe contenere l'indirizzo IP dell'interfaccia, se ne è stato assegnato uno
ad esso. (Non sono disponibili varianti con escape HTML)

$iindex
Questa variabile è l'ifIndex SNMP per l'interfaccia che per definizione è sempre an
numero intero. (Non sono disponibili varianti con escape HTML)

$se_indice
Equivalente a $iindex.

$se_eth
Contiene l'indirizzo ethernet dell'interfaccia, se presente. (Non c'è l'escape dell'HTML
variante disponibile)

$se_velocità
Questa variabile è la velocità in byte/secondo (con prefissi). (Non c'è l'escape dell'HTML
variante disponibile)

$if_speed_str
Questa variabile è una descrizione della velocità elaborata che dipende da bit o byte
se l'opzione bit è attiva o meno e anche con il prefisso appropriato per il
velocità (k, M, G ecc.). (Nessuna variante HTML con escape disponibile)

$if_tipo_desc
Questa variabile è una descrizione testuale del tipo di interfaccia. (variante con escape HTML:
$html_if_type_desc)

$se_tipo_num
Questa variabile il valore intero corrispondente al tipo di interfaccia (per un elenco per
il valore per i tipi di interfaccia più comuni, vedere la sezione DETTAGLI SUI FILTRI
sopra). (Nessuna variante HTML con escape disponibile)

$se_nome_dns
Questo è il nome DNS per l'interfaccia. (Nessuna variante HTML con escape disponibile)

Interfaccia nome, Descrizione ed Alias Variabili

Potrebbe sembrare confuso con entrambi Nome, Descrizione ed Alias in questo contesto e ad alcuni
misura lo è. Nome ed Descrizione sono generalmente supportati sulla maggior parte delle apparecchiature, ma in che modo
utilizzati varia, sia tra i produttori che tra le diverse categorie di
apparecchiature dello stesso produttore. Il Alias è almeno supportato da Cisco IOS e
quella variabile contiene tutto ciò che viene utilizzato nell'istruzione IOS chiamata "descrizione" per il
interfaccia (da non confondere con le variabili SNMP per Descrizione).

Per un migliore controllo dalla riga di comando, considera $se_titolo_desc quali sono i contenuti
controllato da --se-descr opzione da linea di comando.

$if_snmp_descr
Questa variabile dovrebbe contenere la descrizione "grezza" dell'interfaccia come determinata da
il polling SNMP del router. (variante con escape HTML: $html_if_snmp_descr)

$se_nome_snmp
Il nome "grezzo" per l'interfaccia fornito dal polling SNMP. (variante con escape HTML:
$html_if_snmp_name)

$if_snmp_alias
IfAlias ​​"grezzo" per l'interfaccia fornito dal polling SNMP. (HTML con escape
variante: $html_if_snmp_alias)

$se_cisco_descr
Il CiscolocIfDescr "grezzo" per l'interfaccia fornito dal polling SNMP. (HTML
variante sfuggita: $html_if_cisco_descr)

$if_descrizione
Questa è la stringa di descrizione "cotta" per l'interfaccia, tenendo conto del
Valori SNMP trovati per RDescr, ifAlias ​​e CiscolocIfDescr dell'interfaccia. (HTML
variante sfuggita: $html_if_descrizione)

$se_titolo
La stringa completa cfgmaker per impostazione predefinita sarebbe stata utilizzata per la direttiva Title[] nel
configurazione così come il contenuto del tag H1 più in alto in PageTop[]. è
composto dal contenuto di $ prefisso_desc, $se_titolo_desc ed $ sysname.

As $se_titolo dipende $se_titolo_desc, è possibile controllare indirettamente $se_titolo
usando l'opzione della riga di comando --se-descr.

(variante con escape HTML: $html_se_titolo)

$se_nome_porta
Se l'host è uno switch LAN Cisco Catalyst, questa variabile è il nome di quella porta.
(Nessuna variante HTML con escape disponibile)

$se_pp_nome_porta
Se l'host è uno switch LAN Nortel Passport, questa variabile è il nome di quella porta.
(Nessuna variante HTML con escape disponibile)

$ prefisso_desc
Questa variabile è un prefisso della descrizione di ciò che l'obiettivo deve utilizzare nel
Direttiva "Title[]" e nella sezione H1 di "PageTop[]". L'impostazione predefinita è "Traffico
analisi per ". (variante con escape HTML: $html_desc_prefisso)

$se_titolo_desc
Questa è la descrizione dell'interfaccia normalmente utilizzata da cfgmaker come parte del
variabile $se_titolo. Quest'ultimo è usato come la stringa completa nella directory "Title[]"
e la sezione H1 in PageTop[].

$se_titolo_desc è controllato dall'opzione della riga di comando --se-descr che indirettamente
controlla il contenuto di $se_titolo

(variante con escape HTML: $html_if_title_desc)

Aiuto funzioni per Modelli

Le seguenti funzioni esistono per facilitare la scrittura di host e modelli di interfaccia.

html_escape(stringa)
html_escape() prende una stringa come argomento e restituisce una nuova stringa dove il
sono state effettuate le seguenti sostituzioni: i caratteri "<", ">" e "&" sono sostituiti da
"<", ">" e "&" e che le nuove righe incorporate nella stringa sono precedute da
" " e aggiunto con un carattere spazio (le nuove righe alla fine della stringa non lo sono
toccato).

oid_pick($router_connect,$v3opt,"oid1","oid2"...)
Questa funzione proverà a interrogare ciascuno degli oid specificati finché non avrà successo o
ha esaurito l'oids. Restituirà il nome del primo oid che ha funzionato o undef se
non ha successo

Esempio Modello File

Esempio di modello 1: eliminazione dei bersagli rifiutati dall'apparire

Questo file modello genera esattamente lo stesso codice di configurazione per interfaccia di cfgmaker
fa per impostazione predefinita, con l'eccezione che elimina tutte le righe (commenti e
config) per un'interfaccia se l'interfaccia viene rifiutata.

if(non $problem_lines)
{
$target_lines .= <

Destinazione[$nome_destinazione]: $if_ref:$router_connect
SetEnv[$target_name]: MRTG_INT_IP="$if_ip" MRTG_INT_DESCR="$if_snmp_descr"
ECHO

if ($nome_directory) {
$target_lines .= "Directory[$target_name]: $directory_name\n";
}

$target_lines .= <
MaxBytes[$nome_destinazione]: $if_velocità
Titolo[$target_name]: $html_desc_prefix$html_if_title_desc -- $sysname
Inizio pagina[$nome_destinazione]: $html_desc_prefix$html_if_title_desc -- $sysname



Sistema:
$sysname in $html_syslocation


Manutentore:
$html_syscontact


Descrizione:
$html_if_descrizione


ifTipo:
$html_if_type_desc ($if_type_num)


ifNome:
$html_if_snmp_name

ECHO

$target_lines .= <

Nome del porto:
$if_port_name

ECHO

$target_lines .= <

Nome del porto:
$if_pp_port_name

ECHO

$target_lines .= <

Massima velocità:
$if_speed_str

ECHO

$target_lines .= <

IP:
$if_ip ($if_dns_name)

ECHO

$target_lines .= <

</div>
ECHO
} Else {
$head_lines="";
$problem_lines="";
$righe_destinazione="";
$separator_lines="";
}

Modello Esempio 2: più semplice Versione of Esempio 1

L'esempio 1 aveva in parte lo scopo di dimostrare come personalizzare la generazione dell'interfaccia
target ma anche per fornire un suggerimento su come vengono utilizzate le variabili nel modello "predefinito"
che si potrebbe considerare utilizzato normalmente da cfgmaker.

Se sei interessato solo al modo più semplice di eliminare completamente quei rifiuti
interfacce, il modello sottostante farebbe anche il lavoro usando $ linee_di_destinazione predefinite.

se($se_ok) {
$linee_di_destinazione = $linee_di_destinazione predefinite;
} Else {
$head_lines="";
$problem_lines="";
$righe_destinazione="";
$separator_lines="";
}

Modello Esempio 3: Creazione CPU Obiettivi per Host

Di seguito è riportato un esempio di un modello host.

$head_lines .= <
#------------------------------------------------- --------------------
ECHO

my $target_name = $router_name . ".processore";

$target_lines .= <

YLegend[$target_name]: percentuale di carico della CPU
BreveLegenda[$target_name]: %
Legend1[$target_name]: carico della CPU in %
Legend2[$nome_destinazione]:
Legend3[$target_name]: Carico massimo della CPU osservato
Legend4[$nome_destinazione]:
LegendI[$target_name]: Carico CPU:
LegendO[$nome_destinazione]:
WithPeak[$nome_destinazione]: ywm
MaxByte[$nome_destinazione]: 100
Opzioni[$target_name]: growright, gauge, nopercent
Titolo[$target_name]: $router_name CPU load
Destinazione[$nome_destinazione]: 1.3.6.1.4.1.9.2.1.58.0&1.3.6.1.4.1.9.2.1.58.0:$connessione_router
Inizio pagina[$nome_destinazione]: $router_name Carico della CPU



Sistema:
$router_name in $html_syslocation


Manutentore:
$html_syscontact


Descrizione:
$html_sysdescr


Risorsa:
PROCESSORE.


</div>
ECHO

ESEMPI

Il primo esempio crea un file di configurazione per posto.router.xyz: il router ha il
nome della comunità la percezione. Le interfacce vengono identificate dal loro numero IP. Due opzioni globali
vengono aggiunti al file di configurazione. Il file di configurazione viene reindirizzato a mrtg.conf. Il '\'
i segni alla fine della riga indicano che questo comando deve essere scritto su un'unica riga.

cfgmaker --global "WorkDir: /home/tobi" \
--global "Opzioni[_]: growright,bits" \
--ifref=ip\
[email protected] > mrtg.cfg

Nota: se cfgmaker non è nel tuo percorso, ma sei nella directory in cui si trova cfgmaker
memorizzato, puoi avviarlo con ./cfgmaker

Il prossimo esempio crea un file di configurazione per quattro dispositivi: router1.posto.xyz,
router2.posto.xyz, switch1.posto.xyz ed switch2.posto.xyz tutto con la comunità la percezione.

I due router avranno --ifrif impostato descrizione mentre i due interruttori useranno --ifrif
impostato Nome. Inoltre i router utilizzeranno --ifdesc impostato alias ed switch1.posto.xyz
userà --ifdesc impostato descrizione mentre switch2.posto.xyz uso Nome anziché.

Infine, ci saranno due righe Opzioni inserite nella configurazione: Una sarà nel
dall'inizio, mentre l'altro verrà inserito dopo le righe relative ai due router
ma prima di quelle righe relative agli interruttori.

cfgmaker --global "WorkDir: /home/tobi" \
--global "Opzioni[_]: growright,bits" \
--ifref=descrivi \
--ifdesc=alias \
[email protected] \
[email protected] \
--global "Opzioni[_]: growright" \
--ifref=nome \
--ifdesc=descr \
[email protected] \
--ifdesc=nome \
[email protected] > mrtg.cfg

Il prossimo esempio mostra come usare il --Comunità, --opzioni-snmp ed --dominio-dns
per rendere la riga di comando più semplice. Tutta l'attrezzatura utilizzerà la comunità nascosto, ad eccezione
per il server ppp che usa community accesso. Tutte le apparecchiature utilizzano queste opzioni SNMP: 1s
timeout, 1 riprovare ed SNMP versione 2 (retrocedere ed porto non è specificato, il che significa che usano
i valori di default). L'eccezione è di nuovo il server ppp che usa SNMP versione 1.
Infine, tutta l'attrezzatura fa parte del dominio posto.xyz, ad eccezione del server ppp
che fa parte del dominio luogo.remoto.xyz. Si noti che quest'ultimo è ottenuto semplicemente da
specificando il nome del server ppp da essere server ppp.a distanza .

cfgmaker --global "WorkDir: /home/tobi" \
--global "Opzioni[_]: growright,bits" \
--dns-domain=posto.xyz \
--community=nascosto \
--snmp-opzioni=::1:1::2 \
router1 \
router2 \
router3 \
router4 \
router5 \
interruttore1 \
interruttore2 \
interruttore3 \
interruttore4 \
interruttore5 \
interruttore6 \
interruttore7 \
[email protected]:::::1 > mrtg.cfg

Usa cfgmaker online utilizzando i servizi onworks.net