Administrateur de serveur ARIS

L'outil de ligne de commande Administrateur de serveur ARIS est disponible si vous avez installé ARIS Server, ou Outils d'ARIS Administrator(Voir ARIS Client Installation Guide.).

Si vous avez installé ARIS Server, naviguez jusqu'au chemin d'installation ARIS\server\bin\work\work_abs_<s, m ou l>\tools\arisadm, puis exécutez le fichier batch.

Sur les systèmes d'exploitation Linux, ARIS Server Administrator (arisadm.sh) est disponible si le fichier aris10adm-<number>-1.x86_64 a été installé (voir Installation d'ARIS Server - Linux).

Vous pouvez lancer l'administrateur de serveur ARIS d'un ordinateur client quelconque et accéder aux bases de données du serveur.

  1. Cliquez sur Démarrer > Programmes > ARIS > Administration > Administrateur de serveur ARIS 10.0 si vous avez accepté le groupe de programmes suggéré par le programme d'installation. Sous le système d'exploitation Linux, exécutez plutôt le script shell arisadm.sh. L'invite de commande s'affiche et l'administrateur de serveur ARIS est lancé en mode interactif.
  2. Établissez une connexion vers le serveur et le locataire :

    Syntaxe :serveur <nom de serveur>:<numéro de port> <locataire> <nom d'utilisateur> <mot de passe>

    Exemple : server arissrv:1080 default system manager

L'administrateur de serveur ARIS est connecté au serveur.

Entrez help ou help <commande> pour obtenir des informations sur l'utilisation des commandes.

La console Administrateur de serveur ARIS vous permet par exemple d'administrer les bases de données ARIS d'un client ou de sauvegarder ou restaurer la configuration d'un client. Les différentes commandes sont transmises en tant que paramètres de lignes de commande. Le programme vous informe du succès et de l'effet de chaque commande exécutée.

Vous pouvez lancer l'administrateur de serveur ARIS en mode interactif ou en mode lignes de commande depuis tout ordinateur sur lequel un client ARIS est installé. En mode lignes de commande, vous pouvez exécuter automatiquement certaines actions, car ce mode ne propose aucune invite de commande. Si vous vous connectez à l'Administration ARIS en tant qu'un utilisateur système disposant au moins du droit de fonction Administrateur de base de données, vous pouvez administrer toutes les bases de données de ce locataire.

Vous lancez le mode interactif en cliquant sur Démarrer > Programmes > ARIS > Administration > Administrateur de serveur ARIS 10.0.

Vous lancez le mode lignes de commande en ouvrant l'invite de commande à partir du répertoire <répertoire d'installation ARIS>\tools\ArisAdm.

Utilisez les commandes et les options suivantes pour la syntaxe du mode lignes de commande :

<_arisadm><version> [<option>] <commande> [<argument de commande 1>]

ou pour la syntaxe du mode interactif :

<commande> [<argument de commande 1>]

Option

Description

-s <server[:<port>]>

Serveur sur lequel la commande doit être exécutée.

-u <utilisateur> <mot de passe>

Nom d'utilisateur et mot de passe d'un utilisateur système avec des autorisations suffisantes.

-l <nom de fichier>

Active la journalisation de toutes les opérations du programme dans le fichier journal indiqué. Le fichier vous permet de savoir quand une opération a été exécutée et avec quel résultat.

-cf <fichier de commande>

Lance un fichier de commande contenant des commandes exécutables.

-sc <contexte de schéma>

Contexte utilisé par le schéma. ARIS est défini par défaut.

-t <locataire>

Locataire pour lequel la commande doit être exécutée. Par défaut, aucun locataire.

-ssl

Utilise la connexion SSL.

Les parties de la commande qui sont entourées par des [crochets] sont optionnelles. Vous pouvez les utiliser si nécessaire.

Commande

Description et syntaxe

backup

Enregistre une base de données <nomBD> sous forme de fichier adb dans un répertoire <dossierarchive>.

Si la sauvegarde est lancée avec l'option -c, l'enregistrement de la base de données dans le fichier de sauvegarde commence uniquement une fois les opérations en cours (une procédure de fusion ou une importation XML, par exemple) sont terminées.

Syntaxe

backup <nomBD>|-c |all <dossierarchive> [-p <mot de passe pour le cryptage>] [<autrenom>]

backupasn

Extrait l'état correspondant au niveau de liste des modifications <asn> d'une base de données versionnée <dbname> vers un fichier adb dans le répertoire <archivedir>. Vous pouvez sélectionner soit un numéro de liste des modifications <asn> ou 'head' en tant qu'état des données. 'head' représente le dernier état versionné.

Syntaxe

backupasn <dbname>|all <archivedir> <asn>|head [-p <password for encryption>] [<alternatename>]

backupsystemdb

Enregistre en tant que fichier adb la base de données système centrale contenant des données telles que des filtres, des modèles de représentation ou des scripts dans un répertoire <archive>.

Syntaxe

backupsystemdb <archivedir> [<alternatename>]

backupunversioned

Sauvegarde une base de données <dbname> sous forme de fichier non versionné ADB dans un répertoire <archivedir>.

Syntaxe

backupunversioned <dbname> <archivedir>

copy

Copie une base de données de <fromdbname> vers <todbname>.

Syntaxe

copy <fromdbname> <todbname>

createdb

Crée une nouvelle base de données ARIS portant le nom <dbname>.

Syntaxe

createdb <dbname> [versioned]

delete

Supprime la base de données <dbname>. Si vous avez choisi l'option force, la base de données sera supprimée même si des utilisateurs y sont connectés.

Syntaxe

delete <dbname>|all [force]

dropversions

Supprime toutes les versions d'une base de données <dbname> jusqu'à la version <new min version>.

Syntaxe

dropversions <dbname> <new min version>

encrypt

Encode les mots de passe <password> pour une utilisation dans des fichiers batch.

Syntaxe

encrypt <password>

exit

Quitte le mode interactif.

exportscript

Exporte un script du type <MACRO|REPORT|REPORTTEMPLATE|SEMCHECK|PROFILE> avc l'identificateur <scriptid> dans un répertoire d'exportation <exportdirectory>.

Syntaxe

<MACRO|REPORT|REPORTTEMPLATE|SEMCHECK|PROFILE> <scriptid> <exportdirectory>

help

help retourne une vue d'ensemble de toutes les commandes avec description de syntaxe et paramètres possibles. help <command> retourne cette aide pour la commande saisie.

Syntaxe

help [<commande>]

importfilter

Importe un filtre de méthode <importfile>.

Syntaxe

importfilter <importfile>

importscript

Importe un script <importfile> du type <MACRO|REPORT|REPORTTEMPLATE|SEMCHECK|PROFILE> dans la catégorie indiquée <categoryname>.

Syntaxe

importscript <MACRO|REPORT|REPORTTEMPLATE|SEMCHECK|PROFILE> <importfile> <categoryname>

indexstate

Affiche l'état de l'index de données interne de recherche dans le cloud.

Syntaxe

indexstate <Nom de base de données>

interactive

Lance le programme en mode interactif.

kill

Met fin à la connexion <IDsession> du locataire actuel.

Syntaxe

kill <sessionid>|all

killtask

Arrête l'activité du serveur <IDtâche> sur l'instance <IDinstance> (par exemple, un rapport qu'il est impossible de terminer).

Syntaxe

killtask <instance id> <task id> [force]

Pour obtenir les identifiants <instanceid> et <taskid>, utilisez la commande surveiller.

list

Répertorie toutes les bases de données enregistrées du locataire. Par défaut, seules les bases de données du contexte de schéma actuel seront répertoriées. Lorsque vous sélectionnez l'option all, toutes les bases de données sont affichées (p. ex. également les bases de données BO).

Syntaxe

list [all]

lockdb

Verrouille la base de données portant le nom <dbname> ou toutes les bases de données. Aucun utilisateur ne peut plus se connecter.

Syntaxe

lockdb <dbname>|all

maintain

Lance la recréation des indices de recherche (Cloud Search) pour la base de données ARIS indiquée ou toutes les bases de données ARIS. Étant donné que l'exécution de cette commande peut être très longue, il est recommandé de ne l'exécuter que si une erreur se produit et que vous prévoyez une période de maintenance correspondante.

Syntaxe

maintain <dbname>|all

migrate

Migre une base de données ARIS 7.1 ou 7.2 <dbname> à partir d'un fichier ADB <archive> ou migre tous les fichiers ADB dans un répertoire <archivedir>. Pour migrer une seule base de données, vous avez besoin du mot de passe de l'utilisateur système system. Pour migrer plusieurs bases de données, les mots de passe doivent être transmis en mode lignes de commande pour chaque base de données.

Syntaxe

migrate [<archive>|<archivedir>]|<systempassword>

Monitor

Affiche toutes les activités du locataire en cours, comme la sauvegarde, l'exportation XML etc.

rename

Renomme la base de données <olddbname> en <newdbname>. Si vous avez choisi l'option force, la base de données sera supprimée même si des utilisateurs y sont connectés.

Syntaxe

rename <olddbname> <newdbname> [force]

reorg

Réorganise sémantiquement la base de données <dbname> ou toutes les bases de données, c.-à-d. supprime tous les objets et les définitions de liaisons qui n'apparaissent dans aucun modèle.

Les options disponibles :

  • CXNDEFS_IN_MATRIX_MODELS

    Les définitions de liaison pour lesquelles il n'existe pas de valeur ne sont pas supprimées lorsqu'elles sont utilisées dans des modèles de type Modèle de matrice.

  • USERDEF_CONTENT_SYMBOLS

    Les symboles personnalisés qui ne sont pas autorisés par la méthode ARIS sur le serveur actuel sont remplacés par un symbole standard basé sur la méthode.

  • USERDEF_CONTENT_MODELS

    Les modèles personnalisés qui ne sont pas autorisés par la méthode ARIS sur le serveur actuel sont supprimés.

  • USERDEF_CONTENT_ATTRS

    Les attributs personnalisés qui ne sont pas autorisés par la méthode ARIS sur le serveur actuel sont supprimés.

  • NO_DEFS

    Si vous ne définissez pas une option, les définitions d'objets pour lesquelles aucune valeur n'existe sont supprimées par défaut.

Syntaxe

<dbname>|toutes [options]

restore

Restaure une base de données <dbname> à partir d'un fichier adb <archive> ou restaure tous les fichiers adb/bdb d'un répertoire.

Syntaxe

restore <archive>|<archivedir> [<dbname>] [-p <password for decryption>] [-b <bucket ID>]

restoresystemdb

Restaure la base de données système centrale contenant des données telles que des filtres, des modèles de représentation et des scripts à partir d'un fichier de sauvegarde de base de données système (ADB) <archive>. Vous pouvez également mettre à jour la base de données système avec la commande updatesystemdb.

Syntaxe

restoresystemdb <archive>

restoreunversioned

Génère une base de données non versionnée <dbname> à partir d'un fichier adb <archive> d'une base de données versionnée. Restaure également des bases de données d'après plusieurs fichiers ADB/BDB dans un répertoire.

Syntaxe

restoreunversioned <archive>|<archivedir> [<dbname>] [-p <password for decryption>]

restoreversioned

Génère une base de données versionnée <dbname> à partir d'un fichier adb <archive> d'une base de données non versionnée. Restaure également des bases de données d'après plusieurs fichiers ADB/BDB dans un répertoire. Si l'option -no_baseline est spécifiée, aucune initiale n'est créée dans l'archive.

Syntaxe

restoreversioned <archive>|<archivedir> [<dbname>] [-p <password for decryption>] [-no_baseline]

schemacontext

Modifie le contexte de schéma du locataire actuel. Il est donc possible d'enregistrer des bases de données ARIS Optimizer. Les valeurs possibles sont aris et bo.

Syntaxe

schemacontext <new schema context>

server

Modifie le ARIS Server actuel.

Syntaxe

server <server[:<port>]> <tenant> <user> [<password>] [-ssl]

sessions

Affiche toutes les connexions de base de données du locataire actuel.

Syntaxe

sessions [byuser|bydatabase]

set

Affiche ou modifie les paramètres du locataire. Si aucun paramètre n'est entré, toutes les configurations sont affichées. Si seul le mot <key> est entré, toutes les configurations sont supprimées. Si <key> est entré avec <value>, les configurations sont modifiées en conséquence.

Syntaxe

set [<key>] [<value>]

setindexbucket

Précise l'ID de bucket pour une base de données.

Syntaxe

setindexbucket <dbname> <bucket ID>

setindexrank

Définit la plage d'index initiale pour une base de données <dbname>. Plus la plage <rank> est élevée, plus l'index est démarré tôt pendant le démarrage de Cloud Search. La plage est un chiffre, par exemple 5.

Syntaxe

setindexrank <dbname> <rank>

statistic

Retourne le nombre de tous les objets de la base de données.

Syntaxe

statistic <dbname>|all

threaddump

Déclenche un thread dump sur l'instance <IDinstance>. Un ID d'instance peut faire référence à un exécutable, comme abs <s, m ou l> ou report <s, m ou l>, voire à un type d'exécutable, comme abs ou report.

Le thread dump est consigné dans le journal threaddump.log.

Syntaxe

threaddump <IDinstance>

unlockdb

Déverrouille la base de données portant le nom <dbname> ou toutes les bases de données.

Syntaxe

unlockdb <dbname>|all

updatesystemdb

Après avoir installé une mise à jour, mettez à jour la configuration système de chaque locataire opérationnel (filtres, modèles de représentation et scripts) en prenant pour base la base de données système fournie (ARIS_DVD/Content/SystemDB/*.adb). Tout contenu que vous avez créé est conservé.

Syntaxe

updatesystemdb <archive>

Vous pouvez exécuter la commande pour plusieurs locataires en même temps.

userwipeout

Efface l'identification utilisateur d'un ou plusieurs utilisateurs supprimés d'une ou de toutes les bases de données. Les attributs Last modifier (dernier modificateur), Créateur et le nom de l'utilisateur dans les descriptions de la liste des modifications sont définis à inconnu.

Syntaxe

userwipeout <dbname>|all [<user>][,<user>]

version

Affiche les versions des programmes et bibliothèques en cours d'utilisation.

Dans l'exemple suivant, une base de données est réorganisée, en supprimant tous les objets et toutes les liaisons sans valeur qu'elle contient.

Avertissement

Si vous utilisez une bibliothèque d'objets, vous ne devriez réorganiser des bases de données que lorsque chaque définition d'objet possède au moins une valeur dans un modèle de vue d'ensemble. Si des éléments déjà créés pour une utilisation ultérieure ne sont pas présents dans les modèles, il seront supprimés lors de la consolidation.

Réorganisation en mode interactif

Réorganisation en mode lignes de commande

Vous obtiendrez des informations sur les commandes de l'administrateur de serveur ARIS en entrant help ou help <commande>.