Syntax
MS Windows:
setup.bat instancemap import -clean <FROM_FILE_PATH>
UNIX and Linux:
./setup.sh instancemap import -clean <FROM_FILE_PATH>
| Name | Definition |
|---|---|
-clean |
The flag to force the database import if an instance map is already declared |
<FROM_FILE_PATH> |
The name (and path) of the CSV file that contains a valid instance map to import |
As an SAP CC system administrator, the
For each instance in the system, you declare the technical interfaces
(and corresponding services) that are visible by your external client applications
or systems:
The system configuration is stored into the back-end database system - in the INSTANCE_MAP
table.
Examples
When securing your SAP system landscape, you use this command
to import a map set with the
When working with a multihomed host that has several Ethernet interfaces and devices,
you use this command to bind one system instance (or one of its services) to all the
Ethernet (VLAN) interface.
Consult the SAP CC Application Help
for more user assistance and information.
CSV
You use this command to declare:
the server authentication method that is currently configured for encrypted communications
via each technical interface - you set up the secure modes (off, oneway, or dual).
No SSL/TLS authentication
One-way authentication - use the "oneway" secure mode of SAP Convergent Charging
Two-way authentication (also known as mutual SSL/TLS authentication)
- use the "dual" secure mode of SAP CC
Typically, you change the secure modes of some communication channels.
The corresponding procedures are available in the SAP CC Installation Guide
Note
First you prepare a custom file by exporting the current map definition and by
changing the necessary values in a text editor.
import command allows you
to configure and maintain the declaration of the startup instance map (aka "static" instance
map)
that is created at the installation time.
dual value.
File Format
Use
To work with this command, you must have the Administrator role in your SAP CC user profile.
Refer to the SAP CC 5.0 Security Guide for more user assistance and information about the necessary authorizations.
delete
-
To delete the startup instance map from the databaseexport
-
To export the startup instance map from the database to a fileimport
-
To import the startup instance map into the database
Dummy Example
This dummy example provides you with an overall view of the instance map. The details do not correspond to a real system.
#InstanceId; HCISecure; HCIHost; HCIPort; WSSecure; WSHost; WSPort; ExternalSecure; ExternalHost; ExternalPort; InternalSecure; InternalHost; InternalPort updater#1 ; off ; 127.0.0.1 ; 9000 ; off ; 127.0.0.1 ; 9080 ; ; ; ; ; ; updater#2 ; off ; 127.0.0.1 ; 9001 ; off ; 127.0.0.1 ; 9081 ; ; ; ; ; ; dispatcher#1; off ; 127.0.0.1 ; 9100 ; off ; 127.0.0.1 ; 9180 ; off ; 127.0.0.1 ; 2000 ; off ; 127.0.0.1 ; 2100 dispatcher#2; off ; 127.0.0.1 ; 9101 ; off ; 127.0.0.1 ; 9181 ; off ; 127.0.0.1 ; 2001 ; off ; 127.0.0.1 ; 2101
Consult the user assistance Procedures for Securing an SAP CC System Landscape in the SAP CC 5.0 Installation Guide
To view a complete and up-to-date map of the running instances in your Core Server system:
Tip
As of SP 2, you can view the system status and the instance map with the app Display System Status in your SAP CC 5.0 Cockpit user interface.
| Overview | Application Highlights | Activities and Tasks |
|---|---|---|
|
As of SP 2, Display System Status is an app in the SAP CC Cockpit application that enables the SAP CC administrators and operations team to always have a clear view of the system status and availability. You view and inspect the system instances quickly and efficiently. You ensure that the instances are up and running or restarting smoothly after a system and software maintenance. |
With this app, you can:
|
The file format is CSV (comma separated values). The character encoding UTF-8.
Consider the following definition:
CSV Definition
This comma-separated values file contains the definition of the startup instance map.
Each line is the declaration of an instance in your SAP CC Core Server system.
The value separator is the semicolon (;).
The file has a table structured format. The first commented line defines this structure. This comment line is optional.
Each line must contain the following information sequentially:
InstanceIdHCISecureHCIHostHCIPortWSSecureWSHostWSPortExternalSecure (*)
ExternalHost (*)
ExternalPort (*)
InternalSecure (*)
InternalHost (*)
InternalPort (*)
Where:
InstanceId is the most important identifier of an SAP CC system instance:
INSTANCE_ID uniquelly identifies an instance in the Core Server system.
For example: dispatcher#1 or
updater#1
HCI and WS relate to the
HCI and Web Services (WS)
technical interfaces of SAP CC
External relates to the
Message TCP ultra-speed technical interface
Internal relates to the interinstance communications
and:
| System Communication Settings | |||
|---|---|---|---|
| HTTP Communication Infrastructure (HCI) | Web Services (WS) | Message TCP (*) | |
| External (Client Applications) | Internal (Interinstance Comm.) | ||
|
|
|
|
|
(*) Note In a Core Server system, the updater instances do not handle any communication via the Message TCP technical interface. Do not define these settings in the map. Legend
|
|||
The available technical interfaces depend on the type of the SAP CC system instance. Refer to the SAP CC 5.0 Installation Guide for more user assistance and information about the possible interfaces and instance types to configure in this instance map.
Features and Concepts: SAP CC 5.0 Application Help
Security: SAP CC 5.0 Security Guide
Database: INSTANCE_MAP database table