ACC is a command-line tool (see ARIS Cloud Controller (ACC) Command-Line Tool.pdf) for administrating and configuring an ARIS installation. It communicates with ARIS Agents on all nodes.
Warning
Using ACC commands will deeply affect your system. This requires profound knowledge of the technical ARIS infrastructure and environment. The required know-how can be acquired only by attending the training course ARIS Server Installation, available via Global Education Services. If you use ACC commands without this knowledge or without the services of Software AG, according to the standard Software AG software maintenance agreement, we cannot guarantee proper functioning.
ARIS Cloud Controller (ACC) can be used in three modes:
ACC runs with an interactive shell, allowing you to manually issue commands.
Activated by specifying a command file with the -f command line parameter (see ACC command line parameters below). ACC will execute the commands in the file in the given sequence and exit after execution or if one of the commands fails.
A command file line starting with # will be interpreted as a comment line and ignored by ACC.
You can directly pass a single command to ACC as a command line parameter. The command will be executed and ACC will exit afterwards.
When passing commands directly as an ACC command line parameter, you have to be careful when escaping strings in your command, for example, double-quote-delimited parameters. The operating system command shell will consume the double quotes, leaving your string parameter unescaped. So please escape the quote characters.
If you issue the command in command mode, for example:
set remote.repository.url="http://something.com/repo"
You should enter:
acc.bat -h localhost -u <user name> -pwd <remoteAccessPassword> set remote.repository.url=\"http://something.com/repo\"
If you enter:
acc.bat -h localhost -u <user name> -pwd <remoteAccessPassword> set remote.repository.url="http://something.com/repo"
ACC will return an error message, for example:
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
Use "help" to display a list of available commands.
To get information about the usage of ACC commands, enter help or help <command>.
Windows operating system
To start ACC under a Windows operating system click Start > All Programs > ARIS > Administration > Start ARIS Cloud Controller. If you have changed agent user credentials you must enter the user name and/or the password.
Linux operating system
To start ACC under a Linux operating system, execute the acc10.sh shell script instead. To do so, enter: su -c acc10.sh aris10. After the ARIS Server installation has completed on a Linux operating system, the aris10 user is locked and has no password. Command-line tools (sh files), such as ARIS Server Administrator or ARIS Cloud Controller can only be started by the aris10 user related to the ARIS Agent.
As an ARIS user that has no root privileges, you must make sure that the files have the correct ownership (aris10).