This SAP Product Documentation is the primary help of your SAP CC 5.0 BART Setup Tool user interface.
Depending on your goals, use the quick links or the complete table or contents to view your user-centric information.
If this is your first time using the SAP CC 5.0 BART Setup Tool user interface, get started by working through this topic to familiarize yourself.
BART Setup Tool is a user interface of SAP Convergent Charging. It is a command line program that allows you to setup the SAP CC BART Server system by directly modifying its back-end database (SAP CC BART Database).
This user interface allows you to manage the security settings required to secure communication channels (such as the key pairs for encryption mechanisms).
The use of all the commands is detailed in this documentation.
Important Note
The changes are not immediate and you must restart the unique instance of the SAP CC BART Server system.
Notes
You cannot change all these SAP CC system settings with BART+.
Check that your license is always valid; otherwise, you cannot access to all the commands.
The BART Setup Tool program is available from the SAP CC BART Server system and communicates directly with the SAP CC BART Database system. The launch scripts are available in the installation folder.
1. On the SAP Global Host of the SAP CC BART Server system, open one of the following directories depending on the operating system of the host machine:
<DRIVE>:\usr\sap\<SID>\CAB<SAP_INST_NB>\script\
(MS Windows operating system)
/usr/sap/<SID>/CAB<SAP_INST_NB>/script/
(UNIX, Linux, and other operating systems)
Where <SAP_INST_NB> is the SAP instance number,
a two-digit number automatically assigned to
the unique instance of the SAP CC BART Server system by SAP installer at installation time.
2. Open a system console in this directory.
3. Execute the appropriate launch script with the correct command and arguments. In the console, type:
setup.bat <COMMAND_AND_ARGS> (MS Windows)
./setup.sh <COMMAND_AND_ARGS> (UNIX and Linux)
4. A prompt asks you to enter your administrator credentials. Type your SAP CC user logon.
5. Safely, type your user password. It is not displayed to the console.
6. BART Setup Tool verifies the user authentication and performs your operation.
Note
In a development or test system landscape,
you can directly precise your credentials by adding the -login and -password arguments to the command line:
setup.bat <COMMAND_AND_ARGS> [-login=<USR_LOGON>] [-password=<VISIBLE_USR_PASSWD>]
(MS Windows)
./setup.sh <COMMAND_AND_ARGS> [-login=<USR_LOGON>] [-password=<VISIBLE_USR_PASSWD>]
(UNIX and Linux)
Where <USR_LOGON> and <VISIBLE_USR_PASSWD> are your SAP CC system credentials (logon, password)
as a system or application administrator.
Make sure that you do not use these arguments in a production system landscape. The password is visible in the console.
Recommendation
In a secure environment, SAP SE recommends that you never use the additional -login and -password arguments.
An SAP CC user name and password must authenticate each command (except for the help command).
The user name must correspond to an individual user.
An SAP CC Core Server system, with at least one Dispatcher instance up and running,
must be available in the SAP system landscape to perform authentication.
Note
Consult the SAP CC Security Guide to get information on communication security and user rights to perform the commands described in this documentation.
You can quickly use the help command to list the commands and get help with a
particular command.
Example
In a system console (MS Windows, UNIX, and Linux), just type:
./setup.sh./setup.sh licenseNote
All commands are case insensitive.
| Command | Description | |
|---|---|---|
| certentry import | To import a client certificate from a file into the truststore of the BART Server | |
| certentry export | To export a client certificate from the truststore of the BART Server to a file | |
| certentry delete | To delete a client certificate from the truststore of the BART Server | |
| certentry list | To list all the client certificates from the truststore of the BART Server | |
| certentry link | To link the client certificate to one or several services | |
| certentry unlink | To unlink a client certificate from all the declared services | |
| certentry listLinks | To list all the linked client certificates from the truststore of the BART Server | |
| keyentry delete | To delete a key entry from the database | |
| keyentry export | To export a key entry from the database to separate files | |
| keyentry export_p12 | To export a key entry from the database to a PKCS#12 file | |
| keyentry import | To import a key entry from separate files into the database | |
| keyentry import_p12 | To import a key entry from a PKCS#12 file into the database | |
| keyentry link | To link the key entry to one or several services | |
| keyentry list | To list all the key entries | |
| keyentry unlink | To unlink the key entry from all the declared services | |
| keyentry listLinks | To list all the linked key entries | |
Refer to the SAP CC 5.0 Installation Guide about the tasks you can complete with your BART Setup Tool user interface.
For more information, see the related user assistance and product documentation of SAP Convergent Charging on SAP Help Portal: