Historial: Lliurex-mirror.
Previsualización de la versión: 9
Introducció
El Lliurex-mirror és l'eina per a realitzar rèpliques de repositoris remots allotjats en dispositius extraïbles.
El lliurex-mirror generalment s'utilitza a través d'una interfície web (admin-center), que permet realitzar les operacions bàsiques.
L'usuari avançat disposa també de la versió text, mitjançant ordres, la qual pot resultar més còmoda, ràpida o avançada per a un ús específic que no estiga inclòs en les operacions bàsiques que permet la interfície web.
Mode d'ús del client en consola
Per a utilitzar el client en mode consola, cal tindre instal·lat el paquet "lliurex-mirror-cli".
El paquet proporciona l'ordre "lliurex-mirror", el qual permet realitzar totes les operacions.
Aquest paquet es pot instal·lar en un ordinador servidor (hauria d'estar instal·lat) o bé des d'un client d'aula per a poder realitzar accions remotes sobre el servidor.
La forma d'ús general del programa és la següent:
user@computer:~$ lliurex-mirror
Ajuda interactiva
Per a obtindre una ajuda ràpida sobre les opcions que permet el programa, simplement una execució sense paràmetres ni opcions mostrarà una ajuda en el terminal mateix.
Algunes de les ordres llistades es mostren amb un "*" davant, això indica que l'ordre necessita validació d'usuari i contrasenya que s'han de proporcionar en la crida.
Paràmetres generals
Els paràmetres generals que s'han d'utilitzar perquè el comportament del programe siga correcte són els següents:
| Paràmetre, forma curta | Paràmetre forma llarga | Utilitat |
| -H | --host | Indica l'amfitrió (servidor) sobre el qual es realitzaran les accions, això és necessari ja que es poden executar des d'un equip client d'aula, encara que generalment s'executen des del servidor mateix, per a això es pot indicar ‘localhost’ o, simplement, no utilitzar aquest paràmetre. |
| -k | --key | Indica una clau interna per a poder utilitzar les accions sobre el servidor, és equivalent a l'ús d'usuari i contrasenya, per tant es recomana utilitzar usuari i contrasenya d'usuari amb permisos d'administració d'aula (‘netadmin’). |
| -u | --user | Usuari amb permisos d'administració d'aula (‘netadmin’) |
| -p | --password | Contrasenya de l'usuari amb permisos d'administració d'aula. |
Modes d'operació
Operacions habituals
update DISTRO [ url | FILEPATH ]
Realitza/actualitza una rèplica d'un repositori interactivament per a utilitzar-la com a repositori ‘rèplica’ per a l'aula.
Aquesta opció necessita com a primer paràmetre ‘DISTRO’, el qual per al cas de LliureX 16 Xenial es correspon amb el valor ‘llx16’.
Com a segon paràmetre es pot utilitzar un URL (per exemple, http://lliurex.net/xenial), o bé utilitzar una carpeta ubicada en el servidor sobre el qual realitzem l'acció (servidor). Aquesta opció de realitzar/actualitzar la rèplica des d'una carpeta és interessant si es disposa d'una còpia del repositori en un suport extraïble (per exemple, un disc/memòria USB).
Aquesta operació com que s'executa de manera interactiva, es pot cancel·lar amb Ctrl+C.
Nota:
L'ús d'aquesta operació fixarà en el servidor de destinació l'origen de les actualitzacions especificat en aquesta opció.
Això pot ser adequat en cas d'utilitzar l'exemple (http://lliurex.net/xenial) perquè posteriorment sempre serà una font vàlida per a obtindre una còpia actualitzada del repositori. Si utilitzem una carpeta local, quedarà configurat en el servidor objecte de l'operació una font de dades possiblement incorrecta (no existeix o bé és la mateixa que inicialment va sincronitzar la primera còpia del repositori) que impedeix la detecció de rèpliques actualitzades.
Si es vol utilitzar com a origen del repositori una carpeta local pot ser convenient l'ús de l'operació ‘volatileupdate’, o bé utilitzar l'ordre ‘resetconfig’ després de realitzar la rèplica.
Exemples:
user@computer:~$ lliurex-mirror -H server -u netadmin -p password update llx16 http://lliurex.net/xenial
user@computer:~$ lliurex-mirror -H server -u netadmin -p password update llx16 /media/disk/repo_lliurex/
volatileupdate DISTRO [ url | FILEPATH ]
És una operació anàloga a actualitzar 'update', amb la diferència que no fixa l'origen de dades que especifiquem en aquesta operació de manera permanent.
Amb aquesta operació es permet crear un repositori amb un origen d'un suport extraïble alhora que es manté la configuració perquè les actualitzacions futures siguen amb el valor per defecte (http://lliurex.net/).
Exemple:
Un disc USB connectat i muntat en el servidor mateix i un terminal en el servidor.
user@computer:~$ lliurex-mirror -u netadmin -p password volatileupdate llx16 /media/disk/repo_lliurex/
unattendedupdate DISTRO [ url | FILEPATH ]
És una operació anàloga a actualitzar 'update', amb la diferència que no es realitza de manera interactiva, executa la tasca en segon pla en el servidor objecte de l'operació.
Aquesta operació no mostra un progrés de la realització. Si volem obtindre el progrés de l'operació, posteriorment hem d'utilitzar l'operació ‘getpercentage’.
Com que és una operació que s'executa en segon pla, no es disposa d'un intèrpret que permeta cancel·lar l'operació mitjançant un senyal d'interrupció, per a això, s'ha d'utilitzar l'operació ‘stopupdate’.
stopupdate
És l'operació que permet parar una operació ‘unattendedupdate’.
isalive
És l'operació que permet comprovar si un procés d'actualització mitjançant les operacions ‘update’, ’rundebmirror’, ‘volatileupdate’, ’unattendedupdate’, executades prèviament, està en funcionamient.
getmirrorarchitecture
És l'operació que permet comprovar les arquitectures que estan configurades per a realitzar la rèplica en el servidor especificat en el paràmetre -H (si s'ha omés aquest paràmetre s'agafarà ‘localhost’).
setmirrorarchitecture DISTRO (amd64|i386) [ (amd64|i386) ]
És l'operació que permet configurar una arquitectura en la configuració del procés de rèplica del repositori. El valor per defecte per a una rèplica és totes les arquitectures (i386 i amd64).
Amb aquesta operació és possible ‘alleugerir’ la grandària d'una còpia d'un repositori quan es realitza la rèplica en el servidor d'aula. No obstant això, s'ha d'utilitzar amb compte ja que, encara que tota l'aula utilitze arquitectures més modernes (amd64) i, en principi, no hi haja clients antics (i386), encara es poden necessitar paquets i386 instal·lats sobre equips amd64, que en cas de ser necessaris en una instal·lació de programari i no estar disponibles en la rèplica d'aula impedisquen la instal·lació correcta del programari.
Nota: Aquesta operació sols configura les capacitats de la rèplica per a utilitzar-les amb la pròxima actualització, en cap moment realitza l'eliminació dels fitxers que actualment té la rèplica.
Exemple:
user@computer:~$ lliurex-mirror -H server -u netadmin -p password setmirrorarchitecture amd64
getpercentage [ DISTRO ]
És l'operació que permet comprovar el progrés d'una operació d'actualització (‘update’, ’rundebmirror’, ’volatileupdate’, ’unattendedupdate’) ja que mostra el percentatge completat fins al moment. Si l'operació d'actualització no s'està executant, s'indica el percentatge de la rèplica completat fins al moment.
El valor que torna es correspon amb el tant per cent de l'estat del procés d'actualització.
getavailabledistros
És l'operació que llista els perfils per a realitzar rèpliques configurats en el servidor sobre el qual s'aplica l'operació.
Els perfils llistats que s'obtenen com a resultat es corresponen amb el paràmetre vàlid anomenat ‘DISTRO’ en les diferents operacions de l'eina lliurex-mirror.
getmirrororig [ DISTRO OPTION ]
Aquesta operació mostra una llista que associa orígens (‘URL’) configurats amb una numeració ('option') per a realitzar les actualitzacions del repositori.
Les opcions d'actualització es poden consultar amb l'operació ‘distrolistoptions’, la qual mostra tots els valors possibles per al camp opcions.
Si es vol consultar quin és l'origen ('option') actualment habilitat, s'ha d'utilitzar l'operació ‘getoptionupdate’. Per a realitzar un canvi de l'opció d'actualització, s'ha d'utilitzar-se l'operació ‘setoptionupdate’ des del client.
getoptionupdate [ DISTRO ]
És l'operació que torna l'origen (ur
setoptionupdate DISTRO OPTION
És l'operació que permet fixar una ‘option’, la qual especifica un URL que s'utilitzarà en el procés de rèplica, generalment l'‘option’ numerada com a ‘1’ es considera el valor per defecte (rèplica des de lliurex.net) i l'‘option’ numerada com a ‘3’ és el valor especificat manualment en una operació generada des d'una actualització des d'un directori personalitzat.
Aquesta operació pot ser necessària per a restaurar l'origen si no s'utilitza l'opció ‘volatileupdate’.
Exemple:
user@computer:~$ sudo lliurex-mirror -H server -u netadmin -p password setoptionupdate llx16 1
ismirrorupdate [ DISTRO ]
Operación que informa si existe un proceso de creación/actualización de una replica actualmente en funcionamiento.
resetconfig [ DISTRO ]
Operación que permite restaurar la configuración por defecto en lliurex-mirror para una determinada distribución.
Operaciones raramente utilizadas
setcname
Prepara en el host la resolución del nombre ‘mirror’, el host de destino debe utilizar el paquete ‘dnsmasq’.
rundebmirror DISTRO [ url | FILEPATH ]
Operación idéntica a ‘update’ (ver ayuda de ‘update’), se mantiene por compatibilidad.
exportmirror DISTRO MIRROR_COPY_DIR
Operación que permite generar una copia de la réplica actual hospedada en el servidor de aula ‘server’ sobre un directorio de nuestra elección, el cual debe estar creado previamente.
Para utilizar esta operación será necesario tener instalado correctamente el paquete ‘n4d-lliurex-mirror’ en el equipo que lanza la operación y ejecuta ‘lliurex-mirror’.
Es posible observar el funcionamiento del proceso ejecutándose mediante la operación ‘isaliveexport’, la cual proporciona información acerca de si el proceso esta en funcionamiento así como el porcentaje de la tarea que tiene completado.
Notas:
Para que el funcionamiento de esta operación sea correcto la réplica del servidor de aula debe estar completa y ser válida.
Esta operación debe ser ejecutada con permisos de administración (usuario ‘root’ o bien utilizando ‘sudo’), independientemente de los parametros ‘-u’ o bien ‘user’ y ‘-p’ o bien ‘password’ que son proporcionados para poder realizar las operaciones sobre el servidor de aula.
Esta operación no puede ser cancelada una vez lanzada.
Esta operación puede ser sustituida si se dispone de acceso al servidor mediante herramientas de sincronización tradicionales de sistemas Linux (cp, scp, rsync).
Ejemplo:
user@computer:~$ sudo lliurex-mirror -H server -u netadmin -p password exportmirror llx16 /media/disk/repo_copy
getpercentageexport [ DISTRO ]
Operación que permite comprobar el progreso de una operación de copia de la actual réplica (‘exportmirror’) mostrando el porcentaje completado hasta el momento.
Esta operación debe ser ejecutada con permisos de administración (usuario ‘root’ o bien utilizando ‘sudo’), independientemente de los parametros ‘-u’ o bien ‘user’ y ‘-p’ o bien ‘password’ que son proporcionados para poder realizar las operaciones sobre el servidor de aula.
El valor devuelto se corresponde con el tanto por cien del estado del proceso de exportación.
Ejemplo:
user@computer:~$ sudo lliurex-mirror -H server -u netadmin -p password getpercentageexport llx16
isaliveexport
Operación que permite comprobar si un proceso de actualización mediante la operación ‘exportmirror’ lanzada previamente esta en funcionamiento.
setmirrororig DISTRO URL OPTION
Esta operación fija un origen (ur
Ejemplo:
Fijar el origen por defecto de las actualizaciones (similar a la operación ‘resetconfig’):
user@computer:~$ lliurex-mirror -H server -u netadmin -p password setmirrororig llx16 http://lliurex.net/xenial 1
getchecksumvalidation [ DISTRO ]
Operación que consulta si será realizada una comprobación de los paquetes cuando es realizada la réplica, el valor por defecto es 0 que corresponde con no realizar la comprobación, lo cual hace el proceso mas ligero al realizar la operativa. Si se desea cambiar este valor debe utilizarse la opción ‘setchecksumvalidation’.
setchecksumvalidation DISTRO [ [0|false] | [1|true] ]
Operación que fija si será realizada una comprobación de los paquetes cuando es realizada la réplica.
Ejemplo:
user@computer:~$ lliurex-mirror -H server -u netadmin -p password setchecksumvalidation llx16 1
enablewebserverforpath PATH
Operación que permite servir por http en la red local un directorio de nuestra elección en el host especificado.
La operación devuelve un numero de puerto no privilegiado en el cual se está presentando el path proporcionado como parámetro.
Ejemplo:
user@computer:~$ lliurex-mirror -H server -u netadmin -p password enablewebserverforpath /net/mirror/llx16
user@computer:~$ 36322
user@computer:~$ firefox http://server:36322
stopwebserver PORT
Operación para finalizar el servidor http creado con la operación ‘enablewebserverforpath’.
Ejemplo:
user@computer:~$ lliurex-mirror -H server -u netadmin -p password stopwebserver 36322
distrolistoptions [DISTRO]
Operación que lista los valores a aplicar en una configuración de un perfil de replicación de una distribución. Esta operación solo tiene sentido para uso interno o para una programación que utilice la herramienta.
