ACC is a command-line tool (see ARIS Cloud Controller (ACC) Command-Line Tool.pdf contained in the downloaded ARIS installation package, ARIS Download Center, or Empower) 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:
Interactive mode (default)
ACC runs with an interactive shell, allowing you to manually issue commands.
Batch mode
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.
Command mode
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 a command line parameter, you must 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 un-escaped. So please escape the quote characters and special characters.
Examples
If you issue the command in command mode, for example:
set remote.repository.url="http://something.com/repo"
You must 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.
This also affects passwords and names containing special characters. If you try to back up your tenants using the following command, make sure to escape the quote characters and the special character & used in the password User&12345.
If your username or password includes any special character, add a backslash (\) before the character for ACC to process the special character as a string. That is, if there is an ampersand (&), in your password, add a backslash before the ampersand.
./acc.bat -h localhost -u Clous -pwd g3h31m -p 18011 -c ../generated.apptypes.cfg backup tenant default username=\"admin\" password=\"User\&12345\"
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.
To unlock the aris10 user, enter: passwd -u aris10
To interactively enter a password, enter: passwd aris10
To start the command-line tools, enter: su -c acc10.sh aris10 or su -c arisadm.sh aris10
To execute these command-line tools as an ARIS user that has no root privileges, you must enter the password of the aris10 user.
To copy files manually into the ARIS directory, as the aris10 user use the commands: su aris10 and sudo aris10
As an ARIS user that has no root privileges, you must make sure that the files have the correct ownership (aris10).
To lock the aris10 user again enter: passwd -l aris10