Programari pyAdministrador
El programari per configurar el servidor de processos s'anomena pyAdministrador.py, en la seva execució es podran especificar les següents opcions:
- '—configuració' o '-c': Permet establir un arxiu de configuració on llegir i emmagatzemar els paràmetres de configuració utilitzats. Per defecte queda establert per la variable 'constArxiuParametres' i el valor és 'execucio.ini'. El directori on queda emmagatzemat és en el directori d'execució.
- '—inicialitza' o '-i': Inicialitza els valors de l'arxiu de configuració amb els especificats en els paràmetres. Si aquests paràmetres no són especificats, llavors utilitza els valors per defecte. Quan aquesta opció s'ha especificat, el programari d'administració genera l'arxiu de configuració i finalitza la seva execució per deixar modificar manualment els paràmetres de configuració.
- '—identificacio' o '-n': Identificació del programari d'administració utilitzat per identificar-se a la plataforma del Gestor de Processos en realitzar la connexió. Queda establert per la variable 'constNomServidor' i el valor per defecte és el nom del maquinari en execució, calculat per la funció del sistema platform.node().lower().split('.')[0].
- '—servei' o '-o': Identificació del servidor de servei que s'espera rebre en realitzar la connexió. Per defecte, si no s'especifica és la variable constNomServidor.
- '—servidor' o '-s': Adreça IP del servidor de processos, es pot utilitzar tant l'adreça IP com el nom del servidor.
- '—port' o '-p': Port de connexió al servidor de processos.
- '—usuari' o '-u': Usuari de connexió amb el servidor de processos.
- '—contrasenya' o '-a': Contrasenya de l'usuari.
- '—foreground' o '-f': Executa el programari d'administració en segon pla, per defecte s'executa en mode interactiu.
- '—destinataris' or '-t': Destinataris del missatge de correu electrònic amb el resultat de l'execució. El seu valor per defecte és: 'sense_correu'. Per defecte queda desactivada la notificació de correu.
- '—log' o '-l': Arxiu on deixar el registre d'execució del programari d'administració. Establerta per la variable 'constArxiuLogAdministrador', el seu valor per defecte és 'administrador.log' en el directori d'execució.
- '—usage' o '-g': Mostra les opcions de configuracions del programari.
- '—debug' o '-d': Activa el registre de log en modo depuració d'errors.
- '—execucio' o '-e': Especificació de l'agent d'execució on s'ha de realitzar l'execució. El valor per defecte és: ' constExecucioServidorPerDefecte, el seu valor és 'per_defecte'.
-
'—llista' o '-w': Dona la llista dels procediments definits al servidor i la seva definició. Es llisten tots els elements o es pot especificar la llista dels següents elements:
-
verbos: Informa de tots els paràmetres de configuració.
- cru: Els resultats no es transformen per la visualització.
- rols: Rols que disposa la connexió.
- usuaris: Llista els usuaris.
- grups: Llista els grups.
- servidor: Llista els servidors.
- connexio: Llista les connexions.
- alies: Llista els Alies.
- festius: Llista dels dies festius.
- notificacions: Llista les direccions de notificacions.
- proces: Llista dels processos.
- Procediment: Llista dels procediments.
- programacio: Llista els processos programats a executar.
- projectes: Llista dels projectes configurats.
-
scripts: Llista els scripts configurats.
-
'—versions' o '-m': Retorna la versió d’execució del servei com dels agents en execució així com la versió del python que l’està executant.
-
'—registres' o '-r': Retorna els registres existents de la configuració emmagatzemada a l’arxiu de configuració del servidor ‘processosServer.ini'.
Es poden demanar el filtratge dels registres retornats, per seleccionar un tipus de registres amb una o diferents claus, es realitzaria com '[tipus_registre[=clau1[\,clau2[\,clau3[....]]]][:camp1[,camp2[,camp3[,...]]]][|....]', per Exemple: usuaris o usuaris=usuari1 o usuaris=usuari1,usuari2,usuari3 o usuaris=usuari1,usuari2:identificacio,nom_usuari.
Els tipus de registre que es poden especificar són:
Si no s'especifica cap, llavors són tots els registres i tots els camps.
-
'—execucions' o '-q': Llista l’estat de finalització de les execucions realitzades. En el cas de finalitzar l’error, retorna també el missatge associat a l’error.
Si s'especifica un usuari de connexió i no una contrasenya, aquesta es demanarà per teclat.
Perquè una execució sigui en segon pla (background) és necessari especificar una adreça de correu electrònic per enviar els resultats, opció: '--destinataris' o estar definit a l’arxiu de configuració.