L'outil de ligne de commande Administrateur ARIS Server est disponible si vous avez installé ARIS Server, ou les Outils d'administrateur ARIS(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, l’administrateur de serveur ARIS (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.
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. Pour ce faire, saisissez : su -c arisadm.sh aris10. L'invite de commande s'affiche et l'administrateur de serveur ARIS est lancé en mode interactif.
Établissez une connexion vers le serveur et le locataire :
Syntaxe : serveur <server name>:<port number> <tenant> <user name> <password>
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 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'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 <ARIS installation directory>\tools\ArisAdm.
Utilisez les commandes et les options suivantes pour la syntaxe du mode lignes de commande :
<_arisadm><version>.exe [<option>] <command> [<command argument 1>]
ou pour la syntaxe du mode interactif :
<command> [<command argument 1>]
Si vous utilisez des valeurs comportant des caractères spéciaux (par exemple, le caractère & dans le mot de passe), placez ces valeurs entre guillemets. Pour plus d'informations, reportez-vous au centre d'aide et de support de votre système d'exploitation.
Sur le serveur, les messages système dans l'administrateur de serveur ARIS sont toujours affichés dans la langue d'installation d'ARIS.
Si vous utilisez par exemple des scripts pour vos sauvegardes quotidiennes, nous vous recommandons instamment de protéger ces scripts au niveau système d'exploitation ou d'entrer les mots de passe de manière cryptée.
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 ARIS Server 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’ARIS Server, 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 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 ARIS Server d’effectuer la maintenance des bases de données. off : Désactive le mode de maintenance et permet à ARIS Server 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 :
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 .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 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 (<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.
Cliquez sur Démarrer > Programmes > ARIS > Administration > Administrateur de serveur ARIS 10.0. La fenêtre de commande MS-DOS s'affiche et l'administrateur de serveur ARIS est lancé en mode interactif.
Avec la commande server, établissez une connexion à l'ARIS Server 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.
Saisissez le mot de passe de l'utilisateur. Dans cet exemple, c'est manager. La connexion est établie.
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.
Ouvrez l'invite de commande à partir du répertoire <ARIS installation directory>\tools\ArisAdm.
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 de l'administrateur de serveur ARIS en entrant help ou help <commande>.