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.
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 :
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 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>.