ACC est un outil en ligne de commande (Voir document ARIS Cloud Controller (ACC) Command-Line Tool.pdf) pour administrer et configurer une installation ARIS. Il communique avec les ARIS Agents sur tous les nœuds.
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é dans plusieurs modes.
Mode interactif (défaut)
ACC est exécuté avec un interpréteur de commandes interactif, ce qui vous permet d'émettre manuellement des commandes.
Mode batch
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.
Mode de commande
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 un paramètre de ligne de commande, 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 non protégé. Veuillez donc protéger les caractères spéciaux et les guillemets.
Exemples
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
Utilisez "help" pour afficher une liste des commandes disponibles.
Cela concerne également les mots de passe et les noms contenant des caractères spéciaux. Si vous essayez de sauvegarder vos locataires à l'aide de la commande suivante, veillez à protéger les guillemets et le caractère spécial & utilisé dans le mot de passe User&12345.
Si votre nom d'utilisateur ou votre mot de passe comporte un caractère spécial, ajoutez une barre oblique inverse (\) devant le caractère pour que ACC traite le caractère spécial comme une chaîne de caractères. Autrement dit, s'il y a une esperluette (&) dans votre mot de passe, ajoutez une barre oblique inversée avant l'esperluette.
./acc.bat -h localhost -u Clous -pwd g3h31m -p 18011 -c ../generated.apptypes.cfg backup tenant default username=\"admin\" password=\"User\&12345\"
Pour obtenir des informations sur les commandes ACC, saisissez help ou help <commande>.
Système d'exploitation Windows
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.
Système d'exploitation Linux
Pour lancer l'ACC sous un système d'exploitation Linux, exécutez plutôt le script shell acc10.sh. Pour ce faire, saisissez : su -c acc10.sh aris10. Une fois l'installation d'ARIS Server terminée su run système d'exploitation Linux, l'utilisateur aris10 est verrouillé et n'a pas de mot de passe. Les outils de ligne de commande (fichiers sh) tels que ARIS Server Administrator ou ARIS Cloud Controller ne peuvent être démarrés que par l'utilisateur aris10 lié à l'ARIS Agent.
Pour activer l'utilisateur aris10, saisissez passwd -u aris10
Pour saisir interactivement un mot de passe, saisissez passwd aris10
Pour démarrer les outils de ligne de commande, saisissez su -c acc10.sh aris10 ou su -c arisadm.sh aris10
Pour exécuter ces outils de ligne de commande comme utilisateur ARIS qui n'a pas de droits root, vous devez saisir le mot de passe de l'utilisateur aris10.
Pour copier manuellement les fichiers dans le répertoire ARIS, en tant qu'utilisateur aris10, utilisez les commandes : su aris10 et sudo aris10
En tant qu'utilisateur ARIS n'ayant pas de droits root, vous devez vous assurer que les fichiers ont la responsabilité correcte (aris10).
Pour désactiver l'utilisateur aris10, saisissez de nouveau passwd -l aris10