ab2admin(1M) (Installation et administration d'un serveur AnswerBook2)

Installation et administration d'un serveur AnswerBook2

ab2admin(1M)

Nom

ab2admin- interface de ligne de commande pour l'Administration d'AnswerBook2

SYNOPSIS

/usr/lib/ab2/bin/ab2admin

-h

commande

-o

commande

arguments

DESCRIPTION

La commande ab2admin est une interface de ligne de commande pour l'administration des collections et des documents AnswerBook2 sur un serveur AnswerBook2 donné. La commande permet d'installer et de désinstaller les collections AnswerBook1 et AnswerBook2 sur un serveur, de scanner les collections installées localement et de mettre à jour la base de données du serveur ainsi que d'obtenir une liste des collections et des livres.

Les fonctions de gestion de serveur de la commande ab2admin incluent : l'arrêt, le démarrage et le redémarrage du serveur, l'activation et la désactivation des journaux du serveur et le renouvellement des fichiers journaux. Le serveur peut être configuré de façon à résoudre les liens vers les livres situés sur d'autres serveurs AnswerBook2.

ab2admin peut également être utilisée pour contrôler l'accès au serveur en ajoutant ou en supprimant des utilisateurs du groupe d'administrateurs. Le contrôle d'accès peut être activé ou désactivé.

ab2admin permet de se connecter à n'importe quel serveur AnswerBook2 (local ou distant). Certaines fonctions (stop, start et restart par exemple) s'appliquent uniquement au serveur local AnswerBook2. Si le serveur AnswerBook2 est protégé par un mot de passe, un ID utilisateur et un mot de passe sont nécessaires pour lancer la tâche d'administration.

Pour exécuter ab2admin de manière interactive, tapez ab2admin sur la ligne de commande, puis entrez des commandes aux invites. Elle peut entièrement être exécutée à partir de la ligne de commande à l'aide de l'option -o .

OPTIONS

Les options suivantes sont prises en charge :

-h [ commande ]: Affiche l'aide et une aide spécifique à la commande.
-o sous-commande [ arguments]: Les sous-commandes prises en charge sont répertoriées ci-dessous.

Sous-commandes

Les sous-commandes suivantes de l'option -o sont prises en charge :

access_off [ -m serveur ] [ -p numéro_port_serveur ]: Désactive le journal des accès du serveur.
access_on [ -m serveur ] [ -p numéro_port_serveur ]: Active le journal des accès du serveur.
add_admin -u id_utilisateur [ -m serveur ] [ -p numéro_port_serveur ]: Ajoute un utilisateur à la liste des administrateurs de serveur autorisés.
add_coll -d chemin [ -m serveur ] [ -p numéro_port_serveur ]: Ajoute des collections AnswerBook1 ou AnswerBook2 à la base de données indiquée du serveur AnswerBook2.
add_server -M autre_serveur -P numéro_port_autre_serveur [ -m serveur ] [ -p numéro_port_serveur ]: Ajoute un autre serveur au serveur spécifié.
auth_off [ -m serveur ] [ -p numéro_port_serveur ]: Désactive la vérification de l'administration du serveur.
auth_on [ -m serveur ] [ -p numéro_port_serveur ]: Active la vérification de l'administration du serveur.
autostart_no [ -m serveur ] [ -p numéro_port_serveur ]: Empêche le serveur AnswerBook2 de démarrer automatiquement lors de la réinitialisation du système.
autostart_yes [ -m serveur ] [ -p numéro_port_serveur ]: Déclenche le démarrage automatique du serveur AnswerBook2 lors de la réinitialisation du système.
browser [ -m serveur ] [ -p numéro_port_serveur ]: Lance un navigateur Web pour accéder aux pages Administration d'AnswerBook2.
change_password -u id_admin [ -m serveur ] [ -p numéro_port_serveur ]: Modifie le mot de passe des administrateurs autorisés.
del_admin -u id_utilisateur [ -m serveur ] [ -p numéro_port_serveur ]: Supprime un utilisateur de la liste des administrateurs de serveur autorisés.
del_coll -t titre_collection [ -m serveur ] [ -p numéro_port_serveur ]: Supprime les collections AnswerBook1 ou AnswerBook2 de la base de données du serveur spécifiée.
del_server -M autre_serveur -P numéro_port_autre_serveur [ -m serveur ] [ -p numéro_port_serveur ]: Supprime un autre serveur de la liste des serveurs connus par le serveur spécifié.
error_off [ -m serveur ] [ -p numéro_port_serveur ]: Désactive le journal des erreurs du serveur.
error_on [ -m serveur ] [ -p numéro_port_serveur ]: Active le journal des erreurs du serveur.
help [ commande]: Affiche l'ensemble des informations relatives à une commande ou à l'ensemble des commandes.
list [ -m serveur ] [ -p numéro_port_serveur ]: Répertorie les collections AnswerBook1 et AnswerBook2 disponibles sur le serveur spécifié. La liste inclut les livres contenus dans ces collections.
list_server [ -m serveur ] [ -p numéro_port_serveur ]: Répertorie les autres serveurs définis pour le serveur spécifié.
menu: Affiche une liste résumée des options de commandes.
modify_server_name -s nouveau_nom_serveur [ -m serveur ] [ -p numéro_port_serveur ]: Modifie le nom du serveur.
modify_server_port -a nouveau_numéro_port_serveur [ -m serveur ] [ [ -p numéro_port_serveur ]: Modifie le numéro de port du serveur.
restart: Redémarre le serveur local AnswerBook2. Exige un accès en tant que root.
rotate_access [ -m serveur ] [ -p numéro_port_serveur ]: Enregistre et réinitialise le journal des accès du serveur.
rotate_error [ -m serveur ] [ -p numéro_port_serveur ]: Enregistre et réinitialise le journal des erreurs du serveur.
scan [ -m serveur ] [ -p numéro_port_serveur ]: Scanne les collections installées localement (AnswerBook1 ou AnswerBook2) et met à jour les collections dans la base de données du serveur indiquée.
start: Démarre le serveur AnswerBook2 local. Exige un accès en tant que root.
start -D: Lance le serveur AnswerBook2 local en mode de débogage. Exige un accès en tant que root.
stop: Arrête le serveur AnswerBook2 local. Exige un accès en tant que root.
view_access [ -m serveur ] [ -p numéro_port_serveur ]: Affiche le contenu du journal des accès du serveur.
view_config [ -m serveur ] [ -p numéro_port_serveur ]: Affiche les paramètres de configuration du serveur.
view_error [ -m serveur ] [ -p numéro_port_serveur ]: Affiche le contenu du journal des erreurs du serveur.

USAGE

quit: Quitte le mode interactif.
q: Quitte le mode interactif.
bye: Quitte le mode interactif.
exit: Quitte le mode interactif.
? [commande]: Aide en mode interactif.
h [commande]: Aide en mode interactif.

EXAMPLES

Exemple 1 Liste des collections AnswerBook2 disponibles sur un serveur

Pour répertorier les collections disponibles sur un serveur appelé foo.com, à l'aide du numéro de port 8888:

exemple% ab2admin -o list -m foo.com -p 8888

Exemple 2 Utilisation du mode interactif pour répertorier les collections

Pour utiliser ab2admin en mode interactif pour la même opération que celle indiquée ci-dessus :

exemple ab2admin
>> list -m foo.com -p 8888

Exemple 3 Installation d'une collection AnswerBook2

Pour installer une collection AnswerBook2 à l'aide de l'utilitaire pkgadd :

exemple# pkgadd -d répertoire_module/SUNWabsdk

La structure de répertoires de la collection sera copiée sur le système (par défaut) dans /opt/answerbooks/.

Exemple 4 Installation d'une collection AnswerBook2 non mise à jour dans la base de données du serveur

Pour installer une collection AnswerBook2 qui a été introduite sur le système (via pkgadd) mais qui n'a pas été mise à jour dans la base de données du serveur :

exemple# ab2admin -o add_coll -d
/opt/answerbooks/english/solaris_2.6/SUNWabsdk

(Remarque : -d chemin doit inclure le fichier collinfo (pour une collection AnswerBook2) ou le fichier ab_cardcatalog (pour une collection AnswerBook1).

Exemple 5 Vérification de la définition d'une collection AnswerBook1

Pour vérifier la définition d'une collection AnswerBook1 :

exemple% cat /opt/SUNWans/ab_cardcatalog
:id=SUNWab_10_4: \ :version=: \ :title=Solaris XGL 3.1 AnswerBook: \ :tocpath=/net/elirium.Eng/export/answerbook/Solaris_2.4/SUNWAxg/toc: \ :pspath=/net/elirium.Eng/export/answerbook/Solaris_2.4/SUNWAxg/ps: \ :indexpath=/net/elirium.Eng/export/answerbook/Solaris_2.4/SUNWAxg/inde

Exemple 6 Vérification de la définition d'une collection AnswerBook2

Pour vérifier la définition d'une collection AnswerBook2 :

exemple% cat/opt/answerbooks/english/solaris_2.6/SUNabsd/collinfo
dwCollections {
  coll.45.4 dwCollection
}
dwSetParam coll.45.4 {
  location /opt/answerbooks/english/solaris_2.6/SUNWabsdk
  title "Solaris 2.6 Software Developer AnswerBook Vol 1"
  type EbtCollection
}

FILES

/var/log/ab2/catalog/local.socat: Fichier catalogue
/var/log/ab2/catalog/remote.socat: Fichier catalogue
/var/log/ab2/catalog/delegate.socat: Fichier catalogue
/var/log/ab2/catalog/libcat.socat: Fichier catalogue
/var/log/ab2/logs/access_8888.log: Journal des accès par défaut
/var/log/ab2/logs/errors_8888.log: Journal des erreurs par défaut
/usr/lib/ab2/dweb/data/config/ab2_collections.template: Base de données des collections AnswerBook2
/var/log/ab2/catalog/ab1_cardcatalog: Base de données des collections AnswerBook1
/usr/lib/ab2/dweb/data/config/admin_passwd: Fichier contenant le nom d'utilisateur et le mot de passe

ATTRIBUTES

Reportez-vous la section attributs(5) pour obtenir une description des attributs suivants :

TYPE D'ATTRIBUT	VALEUR DES ATTRIBUTS
Disponibilité	`SUNWab2u`