ARIS Server Administrator

L'outil de ligne de commande ARIS Server Administrator est disponible si vous avez installé serveur ARIS ou les outils ARIS Administrator. (Voir Technical Help client ARIS Installation Guide. Vous pouvez ouvrir ou télécharger des documents et l'aide technique à partir du site Web Documentation. La documentation figure également dans le package d'installation ARIS disponible dans le Centre de téléchargement ARIS.

Si vous avez installé serveur ARIS, 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, l’ARIS Server Administrator (arisadm.sh) est disponible si le fichier aris10adm-<number>-1.x86_64 a été installé (voir Installation d'serveur ARIS - Linux).

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

  1. Cliquez sur Démarrer > Programmes > ARIS > Administration > ARIS Server Administrator 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. Pour ce faire, saisissez : su -c arisadm.sh aris10. L'invite de commande s'affiche et l'ARIS Server Administrator est lancé en mode interactif.

  2. Établissez une connexion vers serveur ARIS et le locataire :

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

    Exemple : server arissrv:1080 default system manager ou server arissrv:443 default system manager -ssl

L'ARIS Server Administrator est connecté au serveur.

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

La console Administrateur de serveur ARIS Server Administrator vous permet d'effectuer une sauvegarde ou de restaurer une configuration de locataire ou de gérer les bases de données ARIS d'un client, par exemple. 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'ARIS Server Administrator 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 > ARIS Server Administrator 10.0.

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

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

<_arisadm><version>.exe [<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 <user> <password>

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

-l <file name>

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.

-enc IBM<code page number>

Spécifie une page de code pour afficher correctement les caractères diacritiques. Si vous ne saisissez pas de paramètre d'option, le jeu de caractères original d'IBM PC 437 est utilisé.

Si les caractères diacritiques, tels que é, ó ou ñ utilisés en espagnol, en portugais ou en français sont affichés sous la forme é, ó ou ñ, entrez l'option -enc IBM850.

Si le problème survient dans d'autres langues, essayez d'autres numéros de page de code, par exemple :

850 Multilingue (DOS-Latin-1), Europe de l'Ouest

720 alphabet arabe

737 alphabet grec

775 alphabet estonien, lituanien et letton

852 Langues slaves (Latin-2), Europe centrale et de l'Est

855 alphabet cyrillique

857 alphabet turc

-cf <command file>

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

-sc <schema context>

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

-t <tenant>

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

-ssl

Utilise la connexion SSL.

Remplacez le texte entouré de <chevrons> par vos valeurs individuelles. Les parties de la commande qui sont entourées par des [crochets] sont optionnelles. Vous pouvez les utiliser si nécessaire. Les commandes par défaut sont indiquées ci-dessous. Les commandes avancées sont décrites dans les documents s'y rapportant 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>

clearchartdata

Supprime les données statistiques qui sont utilisées, par exemple, pour générer les graphiques affichés dans Administration ARIS > Graphiques > Modélisation. Vous pouvez supprimer les données statistiques pour une ou toutes les bases de données entièrement ou avant une certaine date. La date doit être indiquée sous la forme jj/mm/aaaa.

Syntaxe

clearchartdata <dbname> [date]

<dbname> : Si vous saisissez le nom d'une base de données, seules les données statistiques de cette base de données spécifique sont supprimées.

all : Supprime les données statistiques de toutes les bases de données de ce locataire.

date : Supprime les données statistiques à partir d'une certaine date [jj/mm/aaaa].

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 <sessionid> 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

maintainancemode

Indique le mode de maintenance actuel. maintenancemode on empêche serveur ARIS de mettre à jour automatiquement les bases de données. Cela peut vous aider à réduire le temps d'arrêt après une mise à jour d’serveur ARIS, car les travaux de maintenance qui prennent du temps sont automatiquement arrêtés pour toutes les bases de données. Si vous utilisez cette option, veillez à exécuter manuellement la commande maintain pour les bases de données liées, si nécessaire. Si vous sélectionnez maintenancemode off, tous les travaux de maintenance de la base de données sont exécutés à nouveau.

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

Syntaxe

maintainacemode on|off

no parameter : Signale le mode actuel.

on : Active le mode de maintenance et empêche serveur ARIS d’effectuer la maintenance des bases de données.

off : Désactive le mode de maintenance et permet à serveur ARIS d’effectuer automatiquement la maintenance des bases de données.

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. Utilisez l'option -fv (forward versioning) pour stocker les versions de la base de données uniquement pour les versions d'ARIS antérieures à 10.0.14.

Syntaxe

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

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 Méthode ARIS sur le serveur actuel sont remplacés par un symbole par défaut basé sur la méthode.

  • USERDEF_CONTENT_MODELS

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

  • USERDEF_CONTENT_ATTRS

    Les attributs personnalisés qui ne sont pas autorisés par 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. Utilisez l'option -fv (forward versioning) pour stocker les versions de la base de données uniquement pour les versions d'ARIS antérieures à 10.0.14.

Syntaxe

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

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.

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 (<package d'installationARIS>..\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.

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. Utilisez l'option -fv (forward versioning) pour stocker les versions de la base de données uniquement pour les versions d'ARIS antérieures à 10.0.14.

Syntaxe

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

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 serveur ARIS 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 (<package d'installationARIS>..\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

  1. Cliquez sur Démarrer > Programmes > ARIS > Administration > ARIS Server Administrator 10.0. La fenêtre de commande MS-DOS s'affiche et l'ARIS Server Administrator est lancé en mode interactif.

  2. Avec la commande server, établissez une connexion à l'serveur ARIS pertinent :

    Syntaxe

    server <server name>[:<port number>] <tenant> <user name>

    Les éléments de la commande qui apparaissent entre crochets sont facultatifs, ce qui signifie que vous pouvez les utiliser en cas de besoin.

    Exemple

    server arissrv.eur.ag:80 default system

    Le système demande le mot de passe.

  3. Saisissez le mot de passe de l'utilisateur. Dans cet exemple, c'est manager. La connexion est établie.

  4. Entrez la commande pour la réorganisation de la base de données United Motor Group :

    reorg "United Motor Group"

La base de données est réorganisée. Les éléments supprimés sont répertoriés.

Réorganisation en mode lignes de commande

  1. Ouvrez l'invite de commande à partir du répertoire <ARIS installation directory>\tools\ArisAdm.

  2. Entrez le paramètre de ligne de commande :

    Syntaxe

    arisadm<version> -s <server name> -t <tenant> -u <user name> <password> reorg <database name>

    Exemple

    arisadm.bat -s arissrv.eur.ag -t default -u system manager reorg "United Motor Group"

La base de données est réorganisée. Les éléments supprimés sont répertoriés.

Vous obtiendrez des informations sur les commandes ARIS Server Administrator en entrant help ou help <commande>.