Contact Us
User Interfaces

User Assistance for Technical Operations

Logs Metrics
Param. Admin+ Setup Tool
Monitoring Troubleshooting
Software Maintenance Purging and Archiving
Java WS ERR Notif.

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 commands/arguments and to give you results or prompts for new options. It provides an IT administrator with some troubleshooting tools to resolve problems about SAP CC systems, data refreshing, and SAP CC users.

Use

This user interface allows you to administrate your SAP CC Core Server system depending on both your technical and business requirements:

View Configure Operate
  • System Information
  • Business Information
  • System
  • Data

Business Operations:

  • Trigger the activation process manually (periodic and one-off fees)

Technical Operations:

  • Software Maintenance
  • SAP CC System Management
  • High Availability (HA) Operations
  • Purging and Archiving
  • Troubleshooting

Refer to the regular or exceptionnal tasks that you can perform with Admin+.

Important Note

The changes can be "immediate and temporary" or "differed and permanent". When the changes are differed and permanent, you must manually restart the modified instances of the SAP CC Core Server system.

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.

Note

Admin+ is included in both the SAP CC Core Server and the SAP CC Core Tool software units.

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<SAP_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<SAP_INST_NB>/script/

Note

The following information is set at installation time by the SAPinst user interface:

  • <SID> is the SAP System Identifier, the unique identifier of the SAP CC system in the SAP system landscape; see also the SYSTEM_ID system parameter
  • <SAP_INST_NB> is the SAP Instance Number, a two-digit number automatically assigned to the unique instance of the SAP CC Core Server system; see also the SAP_INSTANCE_NUMBER indicator
  • <INSTALL_DIR> is the installation directory of SAP CC Core Tool

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.

Note

Consult the SAP CC Security Guide about detailed information on communication security and user rights to use the commands and perform the procedures described in this user assistance.

Working With the Program

Be familiar with the workspace of this console user interface.

Refer to the regular or exceptionnal tasks that you can perform.

Getting Help

In the user interface, 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.

What's New in This Document

This section highlights the main changes in this SAP product document. They relate both to new or changed features in the SAP CC software and to documentation enhancements to enrich your SAP user experience continuously.

What's New in SP 2

As of SP 2, consider the new commands:

What's New in SP 1

As of SP 1, consider the new command:

Consider the enhanced command:

  • dump - When enabled, the command triggers the generation of a thread dump file associated to the command execution.

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 audited user operations from the database
delete_user_session To delete a user session
disconnect_client To disconnect a SAP CC charging client application
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 clients
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 number of business accounting transactions (charged items) and subscriber accounts processed in the SAP CC system
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. This technical data relates to the management of the SAP CC Web Services (WS).
purge_job_record To delete all technical data related to job operations performed before a specified date. This technical data relates to the management of the SAP CC Web Services (WS).
purge_object_change_logs To purge object change logs and associated object snapshots from the database
purge_user_operations To purge audited 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 (factory settings)
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 values 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

Tasks

With Admin+ you can complete the following tasks during the project implementation phase or during the production operation phase. These tasks are detailed in the SAP CC Configuration Guide and in the SAP CC Operations Guide.

Viewing Information in SAP CC

Viewing system information Viewing business information

You use the following commands to view and inspect information about the SAP CC system:

  • list the instances and host machines in an instance map

  • get (with a system parameter that configures a technical function or with an indicator): deployed hosts, installation directories, license information, Java and J2EE environment, frontends and backends, file systems, network, security, SAP users. Refer to the SAP CC System Parameter Reference as the complete reference.

    Examples

  • logs


See also:

You use the following commands to retrieve configuration and usage information about the business features, functions, and data.

  • At SAP CC system level:
    Configuration of Business Processes:

    You use the following commands to retrieve information about the business processing:

    • get (with a system parameter that configures a business function)

    		Product Usage Measurement (Platform Global Usage):

    To view and audit the number of business accounting transactions and subscriber accounts processed by the SAP CC system in your SAP system landscape:

  • At data level:

    In an offline charging scenario, you use the following command to view the batch rating groups defined in the SAP CC system:

Configuring SAP CC Systems and Data

Configuring the system Configuring the data

In Admin+, you use the set command to configure the SAP CC Core Server system:

  • Configuring the business processes and functions
    • Changing a system parameter that configures a business function


Reference: Core Server Configuration of the Business Features in the SAP CC Configuration Guide

You don't use Admin+ to configure data. There are two exceptions:

  • configuration of batch rating groups (in an offline charging scenario with SAP CC BART)
  • refresh triggering after tax changes

Business/Custom Data

In an offline charging scenario, you use the following commands to manage the batch rating groups in the SAP CC systems.

In Admin+, you use the following commands to update the SAP CC system when you modified the VAT rates or the VAT rules with Setup Tool:


See also: SAP CC Setup Tool

You cannot use Admin+ to configure the business data and custom data shared with the master data (pricing catalogs, customer master data) such as currencies or public holidays.


References:

Master Data
You cannot use Admin+ to configure the master data of the service provider that offers the digital service or any other marketable service:
  • Pricing catalogs for the customer service to monetize
  • Customer master data such as subscriber accounts, contracts, or subscriber mapping tables


Reference: SAP CC Core Tool Primary Help (SAP site)

In Admin+, you use the set command to configure the SAP CC Core Server system. Consider the following activities:

  • Configuring the processing of a technical function or mechanism by changing some SAP CC system parameters
  • Tuning the performances of some specialized mechanims and functions


Reference: Core Server Configuration of the Technical Features in the SAP CC Configuration Guide

Note

Note that you use the Setup Tool user interface to configure some technical functions that expect some complex configuration settings.


See also: SAP CC Setup Tool Primary Help (SAP site)

You don't use Admin+ to configure the technical data such as SAP CC users.


Reference: SAP CC Core Tool Primary Help (SAP site)

Operating

Processing business operations

In Admin+, you use the following commands to manually trigger the periodic and one-off fees:


See also:

Processing technical operations

In Admin+, you use the following commands to complete your tasks.

Software Maintenance SAP CC System Management High Availability (HA) Operations

You may use Admin+ when implementing a Support Package (SP) or a patch level in your system landscape. Refer to the SAP Notes associated to your target version.

You use the following commands:

You use the following commands:

Monitoring Purging and Archiving Troubleshooting Problems

You cannot use Admin+ to monitor the SAP CC systems.


Reference: Monitoring in the SAP CC Operations Guide

You use the following commands to purge out-of-date business data:

You use the following commands to purge outdated temporary data:

See the section dedicated to troubleshooting operations.

A support specialist from your SAP Support Team or an expert from your operation team can ask you to use Admin+ to perform some actions.

Troubleshooting Problems

As part of the technical operations, you may have to troubleshoot some problems with your user interface or with your SAP CC environment (systems, data, users) in the system landscape.

You use Admin+ to troubleshoot some problems to:

  • retrieve information
  • perform some actions
  • determine the root causes
  • resolve an issue

Troubleshooting Problems With the User Interface

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

Troubleshooting Problems With SAP CC

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

Note

Consult the SAP CC Operations Guide for more troubleshooting information and tasks.

Related Documentation

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

 
SAP CC 4.1 © Copyright 2016 SAP SE or an SAP affiliate company. All rights reserved.