Les administrateurs de serveurs gèrent les serveurs et les locataires d'un système ARIS et sont donc responsables du côté technique du système :
Administrateurs techniques
Les administrateurs techniques de serveurs administrent en général les serveurs physiques de l'environnement informatique, comme les serveurs de bases de données et les serveurs Web. En outre, ils peuvent également exécuter des tâches étendues en assumant le rôle des administrateurs de sites. Pour ce faire, ils doivent disposer des autorisations des différents rôles d'administrateur ou s'identifier comme utilisateur système (Définition de l'utilisateur 'system', Définition d'un utilisateur système) de bases de données.
Administrateur ARIS de l'Administration ARIS
L'utilisateur superuser est créé automatiquement. Les droits de fonctions Gestion des utilisateurs, Gestion des licences et Administrateur de configuration lui sont affectés par défaut. Il peut activer ce droit de fonction pour d'autres utilisateurs. Les utilisateurs de type superuser n'utilisent pas de licence. Ils gèrent l'administration système, mais ne peuvent pas utiliser de produits ARIS en raison de sa licence. Son mot de passe par défaut est superuser. Il est conseillé de modifier le mot de passe par défaut afin d'empêcher tout accès non autorisé. Le mot de passe du superuser est très important, puisque c'est le seul utilisateur qui ne peut pas être supprimé. À l'exception du nom d'utilisateur, toutes les données utilisateur peuvent être modifiées.
Les utilisateurs et les autorisations sont gérés de manière centralisée pour tous les produits ARIS dans l'Administration ARIS. Les autorisations et les filtres affectés dans ARIS Architect dans l'onglet Administration par base de données déterminent l'accès aux données dépendant des rôles.
Cliquez sur ARIS > Administration.
Administration ARIS offre aussi des outils de commande en ligne pour l'administration.
ARIS offre une série d'outils de ligne de commande pouvant être utilisés pour effectuer des opérations administratives.
Il y a toujours au moins deux locataires, le locataire par défaut et le locataire maître. La plupart des opérations de ligne de commande nécessitent l'authentification de l'utilisateur. L'utilisateur fourni doit avoir des permissions suffisantes pour effectuer l'opération demandée, par exemple, la création, lecture, mise à jour ou suppression d'un locataire ne peut être effectuée que par des administrateurs du locataire maître.
chemin d'installation ARIS >/server/bin/work/word_umcadmin_< votre taille d'installation, par exemple, s,m ou l>/tools/bin pour les systèmes d'exploitation Windows®
et
chemin d'installation ARIS >/cloudagent/bin/work/word_umcadmin_< votre taille d'installation, par exemple, s,m ou l>/tools/bin pour les systèmes d'exploitation Linux
Les outils de ligne de commande suivants sont fournis :
Pour plus d'informations sur les paramètres et les commandes, veuillez saisir le nom de l'outil suivi de /? ou -?, par exemple y-datadump.bat -?.
Pour les systèmes d'exploitation Unix, veuillez utiliser :
Administrateurs de serveur ARIS
Les administrateurs d'ARIS Server surveillent le système et gèrent ARIS Server et les données des locataires au moyen de différents outils :
La surveillance des ressources physiques est importante pour que ARIS continue de fonctionner correctement. Vous pouvez surveiller le système à l'aide de l'interface ACC ou des commandes ACC.
Espace de fichier
Surveiller le système de fichiers de l'installation ARIS. Lorsque l'usage dépasse 85 %, augmentez l'espace disque.
Si l'espace est consommé par l'usage normal de l'application, par exemple, de nombreuses bases de données, de nombreux documents, etc., l'espace disque disponible doit être augmenté. Vérifiez si vous pouvez libérer de l'espace disque. Vous pouvez supprimer les fichiers journaux obsolètes (voir le guide ARIS Cloud Controller (ACC)). Vérifiez aussi que des vidages de tas ont été créés. Ils peuvent utiliser une grande quantité d'espace disque. Il existe un répertoire dans lequel il est recommandé de porter une attention particulière à l'espace disque (/home/ARIS/cloudagent/work/work_cloudsearch_l/rsindex/). La taille de dossier dépend de la taille et de la structure des données utilisateur ARIS qui sont effectivement enregistrées dans le système de gestion de base de données connecté. Nous recommandons d'augmenter l'espace disque disponible si l'espace disque utilisé dépasse 75 % de l'espace disque disponible.
Si Stockage de documents ARIS est beaucoup utilisé, ces exécutables doivent être aussi activement surveillés. Selon le nombre et la taille des éléments de document, il peut être nécessaire d'augmenter régulièrement l'espace disque disponible.
Utilisation de mémoire
Chaque exécutable a un paramètre de configuration JAVA-Xmx. Il doit être surveillé si l'utilisation de la mémoire augmente avec le temps.
Les pics ne sont pas un problème s'ils ne dépassent pas la limite. Si le système souffre sur une période prolongée, par exemple lorsque l'utilisation de la mémoire est supérieure à 70 % pendant plus d'une heure, vérifiez les cas d'utilisation se produisant rarement. Ils pourraient expliquer la consommation élevée de mémoire. Cela peut être :
Si la limite définie de consommation de mémoire est dépassée, il y a deux mesures possibles :
Pour les installations de serveur ARIS avancées, Software AG recommande fortement de demander un service d'installation par Global Consulting Services. Vous pouvez commander ces services auprès de votre représentant Software AG
Charge CPU
Un niveau continuellement élevé d'utilisation du CPU peut être un indicateur qu'il pourrait être nécessaire d'augmenter les capacités du système ou de monter en puissance.
Pour la charge CPU, les mêmes arguments s'appliquent que dans le cas de l'utilisation des tas relativement aux pics. Ainsi, si une charge CPU élevée est détectée (> 60 % pendant plus d'une heure), il faut d'abord analyser si de courts pics ou des cas d'utilisation exceptionnelle pourraient expliquer la situation. Si tel est le cas, aucune action directe n'est nécessaire.
Si la limite définie d'utilisation du CPU est dépassée, il y a deux mesures possibles :
Pour les installations de serveur ARIS avancées, Software AG recommande fortement de demander un service d'installation par Global Consulting Services. Vous pouvez commander ces services auprès de votre représentant Software AG
Taille de la partition de thread
Pour la plupart des exécutables, les paramètres ajpNumWorkerThreads et httpNumWorkerThreads sont définis. Ces valeurs doivent être surveillées.
Si elles dépassent régulièrement 80 % du paramètre de configuration de l'exécutable, elles doivent être augmentées an ajoutant un nouvel exécutable du même type.
Pour les installations ARIS Server avancées, Software AG recommande fortement de demander un service d'installation par Global Consulting Services. Vous pouvez commander ces services auprès de votre représentant Software AG
Outil de ligne de commande ARIS Server Administrator
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 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. 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
Syntaxe
server <nom de serveur>[:<numéro de port>] <client> <nom d'utilisateur>
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.
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
Syntaxe
arisadm<Version> -s <nom de serveur> -t <client> -u <nom d'utilisateur> <mot de passe> reorg <nom de base de données>
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>.
Outil de ligne de commande
ARIS Cloud Controller (ACC)
ACC est un outil en ligne de commande pour administrater et configurer une installation ARIS. Il communique avec les ARIS Agents sur tous les nœuds.
Pour démarrer ACC sous un système d'exploitation Windows, cliquez sur Démarrer > Tous les programmes > ARIS > Administration > ARIS Cloud Controller. Si vous avez changé les informations d'identification de l'utilisateur pour l'agent, vous devez saisir le nom d'utilisateur et/ou le mot de passe.
Pour lancer l'ACC sous un système d'exploitation Linux, exécutez plutôt le script shell acc10.sh. L'ACC est disponible si vous avez copié et installé le fichier rpm aris10-acc-<nombre> dépendant du système d'exploitation Linux.
Entrez help ou help <commande> pour obtenir des informations sur l'utilisation des commandes.
Avertissement
Utiliser les commandes ACC affecte profondément votre système. Cela exige une connaissance approfondie de l'environnement et de l'infrastructure ARIS techniques. Le savoir-faire nécessaire peut être acquis uniquement en suivant la formation ARIS Server Installation, disponible via Global Education Services. Si vous utilisez les commandes ACC sans ces connaissances ou sans les services de Software AG, conformément au contrat de maintenance logicielle Software AG, nous ne pouvons pas garantir un fonctionnement adéquat.
ARIS Cloud Controller (ACC) peut être utilisé en trois modes :
ACC est exécuté avec un interpréteur de commandes interactif, ce qui vous permet d'émettre manuellement des commandes.
Activé en spécifiant un fichier de commande avec le paramètre de ligne de commande -f (voir paramètres de ligne de commande ACC ci-dessous). ACC exécutera les commandes dans le fichier dans la séquence indiquée et se fermera après l'exécution ou si une des commandes échoue.
Une ligne de fichier de commande commençant par # sera interprétée comme une ligne de commentaire et ignorée par ACC.
Vous pouvez directement passer une commande unique à ACC sous forme de paramètre de ligne de commande. La commande sera exécutée et ACC se fermera ensuite.
Lorsque vous passez des commandes comme paramètre de ligne de commande ACC, vous devez faire attention lorsque vous protégez des chaînes dans votre commande, par exemple des paramètres délimités par guillemets doubles. La commande de système d'exploitation shell consommera les guillemets doubles, laissant votre paramètre de chaîne sans protection. Veuillez donc protéger les caractères de guillemet.
Si vous émettez une commande en mode de commande, par exemple :
set remote.repository.url="http://something.com/repo"
Vous devez saisir :
acc.bat -h localhost -u <user name> -pwd <remoteAccessPassword> set remote.repository.url=\"http://something.com/repo\"
Si vous saisissez :
acc.bat -h localhost -u <user name> -pwd <remoteAccessPassword> set remote.repository.url="http://something.com/repo"
ACC renverra un message d'erreur, par exemple :
line 1:52 mismatched character '<EOF>' expecting '\n'
Invalid or erroneous command "set remote.repository.url=http://something.com/repo ": line 1:30 extraneous input ':' expecting EOF
Après l'installation d'ARIS Server deux locataires sont disponibles.
L'infrastructure de locataire maître gère les utilisateurs administratifs et tous les autres locataires.
Le locataire par défaut est disponible pour une utilisation opérationnelle. Si vous avez besoin de locataires opérationnels supplémentaires pour fournir différents ensembles de bases de données, d'utilisateurs, de configurations ou de méthodes ARIS, vous pouvez facilement les créer. Les autres locataires nécessitent un nouvel ensemble de licences ARIS. Les licences doivent être uniques à tous les locataires.
Si vous avez installé un ARIS Server avec un système de gestion des bases de données externe, tous les locataires créés en plus sont aussi disponibles. Si vous allez créer des locataires supplémentaires pour ARIS 10.0 dans le but de migrer des données d'ARIS 9.8.7 ou d'une version ultérieure, assurez-vous d'utiliser des noms identiques dans les deux versions d'ARIS.
Les administrateurs peuvent gérer les locataires de différentes façons :
Veuillez vous assurer de gérer les utilisateurs et les licences pour tous les locataires.
Outil de ligne de commande
Stockage de documents ARIS
Stockage de documents ARIS offre une série d'outils de ligne de commande pouvant être utilisés pour effectuer des opérations administratives.
chemin d'installation ARIS >/server/bin/work/word_adsadmin_<votre taille d'installation, par exemple, s, m ou l>/tools/bin pour les systèmes d'exploitation Windows®
et
chemin d'installation ARIS>/cloudagent/bin/work/work_adsadmin_<votre taille d'installation, par exemple, s, m ou l>/tools/bin pour les systèmes d'exploitation Linux
Veuillez utiliser y-admintool.bat pour les systèmes d'exploitation Windows et y-admintool.sh pour les systèmes d'exploitation Unix.
Utilisation générale
Options |
Description |
---|---|
-?, -h, --help |
Affiche l'aide, par défaut : false |
-s, --server |
URL du Stockage de documents ARIS |
-t, --tenant |
ID du locataire. La valeur par défaut est default. |
-umc, --umcserver |
URL de la Gestion des utilisateurs |
Commandes |
Description |
Paramètres |
---|---|---|
adjustTimestamps |
Modifie l'horodatage défini lors de la création et de la mise à jour des documents et des dossiers. L'horodatage est modifié pour tous les documents et dossiers d'un locataire. Usage : adjustTimestamps [options] |
--password (-p) <MOT DE PASSE> Le mot de passe par défaut est manager. --user (-u). Le nom d'utilisateur par défaut est system. * -offset Décalage à ajouter (+) ou à retirer (-) en minutes, par exemple : "-210". La valeur par défaut "0". |
anonymize |
Rend anonymes les informations d'utilisateur pour les documents et dossiers Usage : anonymize [options]
Compatible avec le RGPD. Le règlement général européen de protection des données (RGPD, en anglais GDPR, General Data Protection Regulation) protège les droits en lien avec les données à caractère personnel des individus au sein de l'Union européenne. Il réglemente aussi l'exportation des données personnelles à l'extérieur de l'UE. Le RGPD est un règlement du Parlement européen, du Conseil de l'Union européenne et de la Comission européenne. |
--password (-p) <MOT DE PASSE> Mot de passe de l'éditeur. Le mot de passe par défaut est manager. Par défaut, aucun droit d'accès n'est défini dans le Stockage de documents ARIS. Tous les utilisateurs ont accès à tous les dossiers, y compris le dossier racine, et aux documents. Vous pouvez limiter l'accès à différents dossiers du Stockage de documents ARIS, pour que tous les utilisateurs du Stockage de documents ARIS ne puissent pas accéder à tous les dossiers et à leur contenu. Veuillez tenir compte des points suivants : Si vous supprimez un seul utilisateur de la liste des utilisateurs ou des groupes d'utilisateurs qui ont accès au dossier puis que vous rendez anonymes les données du dossier, toutes les actions en lien avec les données du dossier sont rendues anonymes. Autrement dit, l'anonymisation n'affecte pas que les données de l'utilisateur supprimé. Avant de supprimer un utilisateur, obtenir son ID d'utilisateur dans les détails d'utilisateur dans la gestion des utilisateurs. * -n, --name Nom de l'utilisateur ou du groupe d'utilisateurs * -type, --type Type de l'utilisateur ou du groupe d'utilisateurs -u, --user Nom d'utilisateur Mot de passe de l'éditeur. Le mot de passe par défaut est system. Le nom d'utilisateur est remplacé par la chaîne anonymous. |
bulkimport |
Importe tous les fichiers et dossiers d'un répertoire spécifié dans le Stockage de documents ARIS. La structure de dossier de la source est maintenue. Usage : bulkimport [options] Vous pouvez aussi importer d'importants jeux de données dans le Stockage de documents ARIS au moyen d'un rapport. Pour ce faire, veuillez contacter votre service local des ventes Software AG.
|
-a, --attributes Crée des métadonnées pour chaque document chargé, par exemple : "description:chargement initial pour l'étape de migration|labels:big data,externe,projet|source:sharepoint". Cet exemple montre comment spécifier l'attribut Description et que des attributs personnalisés sont créés si les attributs requis ne sont pas disponibles par défaut (titre, description, balises, propriétaire). Le caractère | sert à séparer les valeurs. De ce fait, il ne peut pas être utilisé à l'intérieur d'une valeur. --password (-p) <MOT DE PASSE> Mot de passe de l'éditeur. Le mot de passe par défaut est manager. --repository (-r) <nom du référentiel>. Le référentiel par défaut est le référentiel de portail utilisé dans Stockage de documents ARIS ou dans la vue de référentiel dans ARIS Connect. La valeur par défaut est portal. Vous ne devez spécifier le référentiel par défaut qui si vous n'utilisez pas le référentiel par défaut. Un autre référentiel pourrait être le référentiel ARIS Risk & Compliance Manager par exemple. -sw, --stopwatch Permet l'évaluation des performances pour l'importation en série de documents et dossiers. La valeur par défaut est false. --user (-u) <NOM D'UTILISATEUR> Nom d'utilisateur de l'éditeur. Le nom d'utilisateur par défaut est system. -deltaimportfile Importation des modifications : Importation delta : si des erreurs se sont produites lors de l'importation, le fichier importerrors.log est généré dans le répertoire de travail actuel, ../tools/bin/importerrors.log. Pour importer les documents répertoriés dans le fichier journal, veuillez saisir ce qui suit : |
|
|
-deltaimportfile "./importerrors.log". Dans ce cas, le paramètre de chemin est ignoré et seuls les fichiers disponibles dans le fichier importerrors.log sont importés. -logfile Définit le nom du fichier journal si vous utilisez le paramètre loglevel, par exemple %LOGS%adsimport.log. Si rien n'est défini, mais que la journalisation est activée (via le paramètre loglevel), le fichier adsimport.log est enregistré dans le répertoire de travail actuel. La valeur par défaut est adsimport.log. -loglevel Définit le niveau de log pour l'importation en série de documents. Utilisez standard pour ne consigner que les noms des documents et leurs ID. Utilisez hyperlinks pour consigner également les liens HTTP des documents. La valeur par défaut est none. * -path Chemin vers le répertoire devant être utilisé pour l'importation en série de documents (p. ex. C:/importation/documents/). La structure de répertoire du dernier dossier indiqué est reprise dans le référentiel du stockage de documents Stockage de documents ARIS. Exemple : Si le dossier source présente la structure C:/import/documents/dossier1/dossier2, l'exécution de l'outil de ligne de commande avec l'option -path génère la structure documents/dossier1/dossier2 dans Stockage de documents ARIS. |
|
|
-overwrite Si cette option est activée (-overwrite true), les documents et dossiers sont supprimés et nouvellement créés en fonction de la structure de répertoire spécifiée. * -path Chemin vers le répertoire à utiliser pour l'importation en série de documents (par exemple, C:/import/documents/). La structure de répertoire du dernier dossier indiqué est reprise dans le référentiel du stockage de documents Stockage de documents ARIS. Exemple : Si le dossier contenant les documents à importer présente la structure C:/import/documents/dossier1/dossier2, l'exécution de l'outil de ligne de commande avec l'option -path génère la structure documents/dossier1/dossier2 dans Stockage de documents ARIS. -toplevelfolder Si cette propriété est activée, le dossier supérieur défini à l'aide du paramètre -path est ignoré lors de l'importation. Si les documents à importer se trouvent dans un dossier mydocs et si le chemin /mydocs/dossier1/dossier2, par exemple, est utilisé avec cette option, seule la structure de dossier subordonnée au niveau mydocs sera reprise dans le stockage de documents Stockage de documents ARIS lors de l'importation et sera créée directement sous le répertoire racine. Si cette propriété n'est pas définie - cas par défaut - le dossier supérieur sera également repris dans le référentiel du stockage de documents Stockage de documents ARIS, c'est-à-dire que l'ensemble de la structure /mydocs/dossier1/dossier2 sera créée sous le répertoire racine. La valeur par défaut est false. |
deleteAccessPrivileges |
Supprime toutes les restrictions d'accès d'un dossier défini. Usage : deleteAccessPrivileges [options] |
--folderId (* -f) ID du dossier requis pour la suppression de tous les droits d'accès. --password (-p) <MOT DE PASSE> Le mot de passe par défaut est manager. --user (-u). Le nom d'utilisateur par défaut est system. --user (-u) <NOM D'UTILISATEUR> Nom d'utilisateur de l'éditeur. Le nom d'utilisateur par défaut est system. -orphandata Supprime les droits d'accès appartenant aux groupes d'accès supprimés. La valeur par défaut est false. -passon Supprime hiérarchiquement les droits d'accès dans le dossier. La valeur par défaut est false. |
exportConfig |
Exporte la configuration du Stockage de documents ARIS. Usage : exportConfig [options] |
--file (-f) Fichier de configuration. La valeur par défaut est adsConfig.properties. --password (-p) <MOT DE PASSE> Le mot de passe par défaut est manager. --user (-u). Le nom d'utilisateur par défaut est system. |
importConfig |
Met à jour la configuration du Stockage de documents ARIS de ce locataire. Usage : importConfig [options] |
--file ( -f) Fichier de configuration à importer. La valeur par défaut est adsConfig.properties. --password (-p) <MOT DE PASSE> Le mot de passe par défaut est manager. --user (-u). Le nom d'utilisateur par défaut est system. |
reindex |
Réindexe la base de données Stockage de documents ARIS. Usage : reindex [options] |
--password (-p) <MOT DE PASSE> Le mot de passe par défaut est manager. --user (-u). Le nom d'utilisateur par défaut est system. |
thumbnails |
Crée des miniatures pour les images. Usage : thumbnails [options] |
--password (-p) <MOT DE PASSE> Mot de passe de l'éditeur. Le mot de passe par défaut est manager. --repository (-r) <nom du référentiel>. Le référentiel par défaut est le référentiel de portail utilisé dans Stockage de documents ARIS ou dans la vue de référentiel dans ARIS Connect. La valeur par défaut est portal. Vous ne devez spécifier le référentiel par défaut qui si vous n'utilisez pas le référentiel par défaut. Un autre référentiel pourrait être le référentiel ARIS Risk & Compliance Manager par exemple. --user (-u) <NOM D'UTILISATEUR> Nom d'utilisateur de l'éditeur. Le nom d'utilisateur par défaut est system. |
Exemple
y-admintool.bat -s http://my_aris_host.com:1080 -umc http://my_aris_host.com:1080 -t default bulkimport -u system -p manager -path d:\my_documents
Outil de ligne de commande
Process Governance
Process Governance offre une série d'outils de ligne de commande pouvant être utilisés pour effectuer des opérations administratives.
Pour éviter les inconsistances de données et la perte possible de données, vous ne devez pas effectuer les activités suivantes en parallèle (pas plus manuellement que de façon programmée) :
- Supprimer toute instance de processus Process Governance, version de processus ou processus
- Archiver des instances de processus Process Governance
- Sauvegarder/restaurer un locataire (contenant des données Process Governance ou Stockage de documents ARIS)
<chemin d'installation ARIS>/server/bin/work/work_apg_<votre taille d'installation, par exemple, s, m ou l>/tools/bin pour les systèmes d'exploitation Windows®
et
<chemin d'installation ARIS>/cloudagent/bin/work/work_apg_<votre taille d'installation, par exemple, s, m ou l>/tools/bin pour les systèmes d'exploitation Linux.
Les outils de ligne de commande suivants sont fournis :
Cet outil de ligne de commande est appelé par y-ageclitool.bat or y-ageclitool.sh et configure l'environnement comme nécessaire.
Pour plus d'informations sur les paramètres et les commandes, veuillez saisir le nom de l'outil suivi de /? ou -?, par exemple y-ageclitool.bat/?.
Pour les systèmes d'exploitation Unix, veuillez utiliser :
Cet outil de ligne de commande est appelé par y-ageclitool.bat or y-ageclitool.sh et configure l'environnement comme nécessaire.