Working With Admin+

Target Audience

• Administrator (system, application)
• Technology consultant

Overview

SAP CC Admin+ is a user interface of SAP Convergent Charging. It is a console program that allows you to manage local or remote instances of the SAP CC Core Server system and change their configuration parameters. The console program runs in interactive mode to get values and to give you results or prompts for new values.

Use and Tasks

This user interface allows you to:

• Get the list and details about the known instances of the SAP CC Core Server system (see the list command)
• Get the values of the configuration parameters of the SAP CC system (see the get command)
• Set a few configuration parameters for the SAP CC system (see the note below)
• Manage the batch rating groups (see the grouplist command)
• Reset the data caches, SQL connections, and user work sessions
• Troubleshoot the connected SAP CC system (see the dump command)
• Test the connection to the SAP CC system (see the ping command)

The use of all the commands is detailed in this SAP product documentation. Do not forget that you must be connected and logged on to the SAP CC system to access to all the commands.

Getting Started

Executing the Program

In the Microsoft Windows operating system, the administrator opens a CMD/DOS console to type the commands and verify the results. In the Start main menu of MS Windows, select the Execute... submenu and type: cmd in the popup window, which is displayed. Launch the admin+.bat script from the directory:

• SAP CC Core Tool: <DRIVE>:\<INSTALL_DIR>\bin\
• SAP CC Core Server system: <DRIVE>:\usr\sap\<SID>\CCD<INST_NB>\script\

In the UNIX and Linux operating systems, the administrator opens a console to type the commands and verify the results. Launch the admin+.sh script from the directory:

• Core Tool: /<INSTALL_DIR>/bin/
• Core Server system: /usr/sap/<SID>/CCD<INST_NB>/script/

Connecting and Logging On

Admin+ communicates directly with the dispatcher instances of the SAP CC Core Server system via the HTTP Communication Interface (HCI) based on proprietary XML messages sent over HTTP. The messages are always redirected in the background to the master dispatcher instance of the SAP CC system.

To connect to the SAP CC system and get authenticated:

• Once you have started Admin+, type the command host to specify the distant SAP CC system to connect to
  • Enter the name or IP address of the host where a dispatcher instance of the SAP CC system is running. The dispatcher instance can be the master or a slave. Both IPv4 and IPv6 addresses can be specified.
  • Enter the communication port number used by this dispatcher instance
• Use the url command for secure communications
• Type the command user to log on and to be authenticated
  • Enter your user name. The user name must correspond to an individual user.
  • Enter your password

Admin+ displays the prompt ’[<HOST_NAME>] <INST_ID> >’. The program is ready to accept commands.

Working With the Program

Be familiar with the workspace of this console user interface.

Getting Help

You can use the help command to list the commands and get help with a particular command. Type help set to display information about the set command.

Commands

Most of the commands are only available when you are authenticated. You can use the following commands to complete your daily tasks:

Command	Definition
?	To view the help
admin_sql_connection	To disconnect from or to force the reconnection of the selected instances of the SAP CC system with a selected instance of the database system
debug	To activate the debug mode of the program
delete_file_to_bulkload	To delete the existing database file entry that is linked to a file to bulk load
delete_object_change_logs	To purge object change logs and associated object snapshots from the database
delete_user_operations	To purge user operations from the database
delete_user_session	To delete a user session
dump	To display a thread dump related to one or multiple instances of the SAP CC system
exit	To exit the program
fetch_client_statistics	To display service time statistics for one or several connected SAP CC charging client(s)
get	To view the values of an SAP CC system parameter, a parameter list, or indicators
get_files_to_bulkload	To view the list of files that are not yet bulk loaded
groupadd	To add a new batch rating group
groupdel	To delete an existing batch rating group
grouplist	To list the batch rating groups
groupmod	To change an existing batch rating group
h	To view the help
help	To view the help
host	To specify the distant SAP CC system to connect to
id	To view the current SAP CC user and the host information
list	To view the list of server instances of the connected SAP CC system and communication settings
list_clients	To display the list of connected SAP CC charging clients
login	To authenticate the SAP CC user
logs	To view the last log or trace messages from a logging destination of the SAP CC system
metriclist	To get the list of metrics relating to the filter set as an argument
normal	To reactivate the normal mode of the program
output	To redirect the output to a file and the console
ping	To ping the SAP CC system or specified instances
purge_change_lists	To delete the transported change lists created before a specified date
purge_idempotency	To trigger the purge of all the idempotency table entries older than the specified date
purge_job_record	To delete all technical data related to job operations performed before a specified date
purge_object_change_logs	To purge object change logs and associated object snapshots from the database
purge_user_operations	To purge user operations from the database
quit	To exit the program
rc	To reset the provisioning cache (former subscription cache)
refresh_raters	To update the data cache of all the rater instances of the SAP CC system
refresh_sql_connections	To force the update of the connections to the database
refresh_tax_cache	To update the VAT rate cache of the rater and updater instances
refresh_transerv_list	To update the EZTax transaction/service types list of the updater instances
refresh_vat_rules_cache	To update the VAT rule cache of the rater and the updater instances
reset	To reset an SAP CC system parameter to its default value
search_user_session	To view the list of user sessions currently open
server	To manage the SAP CC Core Server system
set	To change the value of an SAP CC system parameter
start_activation	To trigger the periodic or one-off fees of all the subscriptions (see recurring rates and one-shot rates)
start_cache_warmup	To start the cache warm-up mechanism
start_cleanup	To trigger the cleanup process of all the provider contracts or subscriptions which are involved in session-based charging operations or in prerating operations (deprecated)
start_contract_activation	To activate the periodic/one-off fees of all the provider contracts
start_purge_allowances	To purge expired allowances which have exceeded the retention period
start_trace_session	To start a tracing session for a specific subscriber account
stop_activation	To stop the activation process of subscriptions
stop_cleanup	To stop the running cleanup processed by the connected SAP CC system
stop_contract_activation	To stop the activation process of provider contracts
stop_purge_allowances	To stop a purge operation of expired allowances which have exceeded the retention period
unlockpc	To unlock a provider contract stored in SAP CC (customer master data)
unlockpcs	To unlock a set of provider contracts
unlocksub	To unlock a subscription
unlocksubs	To unlock a set of subscriptions
url	To specify the distant SAP CC system from its URL
user	To authenticate the SAP CC user

Troubleshooting Problems

You may have to troubleshoot some problems with your user interface or with your SAP CC environment (systems, data, users) in the system landscape.

Troubleshooting Problems With the User Interface

To troubleshoot problems that relate to the SAP CC user interface, you can:

• Activate the debug mode to view messages exchanged with the connected SAP CC system

Troubleshooting Problems With SAP CC

To troubleshoot problems that relate to the SAP CC system landscape, consider the following tasks:

• SAP CC system:
  • To ping the SAP CC system or specified instances
  • To enable the log and trace functions with the set command
  • To view the last log or trace messages from a logging destination of the SAP CC system
  • To update the data cache of all the rater instances of the SAP CC system
  • To start the cache warm-up mechanism
• SAP CC master data: To unlock a provider contract stored in SAP CC (customer master data)
• SAP CC users: To delete a user session

Related Documentation

For more information, see the related product documentation of SAP Convergent Charging in SAP Help Portal:

Primary Help	Secondary Help
SAP CC Setup Tool Primary Help SAP CC Core Tool Primary Help (SAP site) SAP CC System Parameter Reference	SAP CC Operations Guide about system administration and maintenance activities with Admin+ SAP CC Configuration and Implementation Guide about customizing activities and system configuration (notification policy) SAP CC Installation Guide
SAP CC BART+ Primary Help	SAP CC Application Help SAP CC Security Guide