Working With BART Setup Tool

Target Audience

Administrator (system or application)
Technology consultant

Overview

BART Setup Tool is a user interface of SAP Convergent Charging. It is a command line program that allows you to manage some functions of the SAP CC BART Server system when it is offline. SAP CC BART Server is dedicated to offline acquisition and charging on your SAP CC landscape. This user interface allows you to manage the certificates and key entries used during communications between SAP CC Core Server and client applications using both XML over HTTP and Packets over TCP/IP channels.

This user interface allows you to manage:

The licenses - for all instances of the SAP CC system
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.

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 changes are not immediate and you must restart the unique instance of the BART Server system.

Getting Started

Executing the Program

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.

To launch BART Setup Tool:

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 SAPinst 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.

Connecting and Logging On

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.

Note

Consult the SAP CC Security Guide to get information on communication security and user rights to perform the commands described in this documentation.

Getting Help

You can simply use the help command to list the commands and get help with a particular command.

Example

./setup.sh
./setup.sh license

Commands

Command	Description
certentry import	To import the client certificates from files to the database
certentry export	To export the client certificates from the database to files
certentry delete	To delete the client certificates
certentry list	To list all the client certificates
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 certificate entries
keyentry delete	To delete the key entries
keyentry export	To export the key entries from the database to files
keyentry export_p12	To export the key entries from the database to a PKCS#12 file
keyentry import	To import the key entries from files to the database
keyentry import_p12	To import the key entries from a PKCS#12 file to 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