You must start a remote connector before executing a scenario.
|
Caution Do not implement a remote import/export connector (IEC) in a production system landscape during the production operation phase. You implement a remote IEC during the implementation project phase to transport data to the SAP CC systems. |
To establish a connection with the CAT Tool user interface, you start a connector by launching an executable file with the following arguments:
The repository path where the scenarios are saved and executed
The port number on which the connector is listening
The repository where the logs are saved
Procedures
Refer to the table below:
|
Environment |
Executable |
Procedures |
|
MS Windows |
iec_remote.bat |
To launch a remote connector program 1. Open a COMMAND window 2. Type: cd <IEC_INSTALL_DIR>\bin 3. Press ENTER 4. Then type: iec_remote.bat <ARGUMENTS> 5. Press ENTER
To stop a connector, close the COMMAND window. |
|
UNIX |
iec_remote.sh |
To launch a remote connector program 1. Open a UNIX console window 2. Type: <IEC_INSTALL_DIR>/bin/iec_remote.sh <ARGUMENTS> 3. Press ENTER
To stop a connector, close the UNIX window. |
Where:
<IEC_INSTALL_DIR> is the installation directory of an import/export connector (IEC) program; Its launch scripts are available in the bin subfolder.
<ARGUMENTS> are the mandatory and optional options to be executed
The description of the command arguments is the following:
[-repositoryDir=<SCN_REP_DIR>] -uri <CCD_URIS> [-port=<IEC_PORT_NB>] [-logDir=<LOG_DIR>]
Where:
<SCN_REP_DIR> is the file directory where the scenarios are stored (by default, under MS Windows: ..\iec-repository; under UNIX: ../iec-repository)
<CCD_URIS> is the comma-separated URIs of the dispatcher instances of SAP CC Core Server; The URI syntax is <PROT>://<HOST_ADDRESS>:<MSG_TCP_PORT> where:
<PROT> is the communication protocol; the possible values are: tcp and tcps (secured channel).
<HOST_ADDRESS> is the hostname or the IP address (IPv4 or IPv6) of the machine hosting the dispatcher instance related to the URI; View the instance map of the SAP CC system.
<MSG_TCP_PORT> is the port number of the host that is dedicated to the dispatcher instance for the communications via the Message TCP technical interface; View the instance map of the SAP CC system.
<IEC_PORT_NB> is the communication port number on which the import/export connector program is listening (by default: 9002) on the host machine; CAT Tool connects to this port to manage the scenarios in the remote connector.
<LOG_DIR> is the directory where the logs are saved; if <LOG_DIR> is not mentioned, the default log directory is the logs subfolder in the scenario repository: under MS Windows: <SCN_REP_DIR>\logs; under UNIX: <SCN_REP_DIR>/logs);
The table below shows some examples to start a remote connector:
|
Environment |
Command |
|
Windows |
iec_remote -repositoryDir=C:\home\job\MyRepository -port=2002 -logDir=c:\home\job\MyLogs |
|
UNIX |
iec_remote -repositoryDir=/home/job/MyRepository -port=2002 -logDir=/home/job/MyLogs |
After a remote connector starts, you can manage the execution of a scenario by using the CAT Tool user interface.
To execute a scenario
Make sure that the remote connector is running; otherwise, CAT Tool displays an error message.
Open CAT Tool to execute a scenario
Import the scenario to be executed from the connector repository
Make sure that the scenario to be executed is selected; otherwise, click the Scenario window, and then select the scenario.
On the Action menu, click Execute. After the scenario has been executed, the message "Activated" appears in the title bar. If the remote connector is not running, an error message is displayed.
Monitor the logs saved by the remote connector
To stop a scenario
On the Action menu, click Stop. After the scenario stops, the message "Stopped" appears in the title bar.
Close the window (COMMAND or UNIX) in which the connector program is running.