KB-127196: Configuring the CSC gateway

Configuring the CSC gateway

The CSC gateway enables communication between two TCP/IP networks. It is possible for a client in network A to pose a question on a server that is found in network B via a CSC gateway.

Image: Diagram CSC gateway

Requirements

  • The CSC gateway must be installed on a PC that has access to network A as well as access to network B.
  • Routing is configured only on five relevant server applications.
  • Every time a client application tries to connect, a check is made that it is authorized. All authorized clients are registered in the configuration file on the gateway server.

Note

The incoming and outgoing port for SecureConnect (VDogSecureConnect_Port and VDogSecureConnect_PortRemote) must be identical, otherwise the clients cannot log on to the CSC gateway.

The CSC gateway is configured in the [vdog_cs****]** section.

_n_indicates the server used for the configuration. Enter one of the following values:

  • 1: when using a conventional server
  • 2: when using parallel servers

If for_n_a value is given that is outside the designated range, the section [vdog_cs_{n}_and all of it’s key values will be ignored when the INI file is read.

Key Value

Enabled

Key for activating the CSC gateway functionality

Y/N

Default: N

Example: Enabled=Y

VDogAdminServer_Port

Key for configuring the port where the gateway for the AdminServer routing is situated

{1024 to 65535}

Default: 64001

Example: VDogAdminServer_Port=64201

VDogAdminServer_PortRemote

Key for configuring the port that is used to connect to the octoplant server AdminServer. (The value is extracted from the runtime)

{1024 to 65535}

Default: 64001

Example: VDogAdminServer_PortRemote=64201

VDogAdminServer_SvrRemote

Key for configuring the computer name of the octoplantserver. (The value is extracted from the runtime)

{computer name}

Required field

Example: VDogAdminServer_SvrRemote=vDogServer1

VDogCheckInCheckOutServer_Port

Key for configuring the port where the gateway to the CheckInCheckOutServer Routing is situated.

{1024 to 65535}

Default: 64002

Example: VDogCheckInCheckOutServer_Port=64202

VDogCheckInCheckOutServer_PortRemote

Key for configuring the port via which the octoplant CheckInCheckOutServer can be accessed. (The value is extracted from the runtime.)

{1024 to 65535}

Default: 64002

Example: VDogCheckInCheckOutServer_PortRemote=64002

VDogCheckInCheckOutServer_SvrRemote

Key for configuring the computer name of the octoplant server. (The value is extracted from the runtime)

{computer name}

Required field

Example: VDogCheckInCheckOutServer_SvrRemote=vDogServer1

VDogScheduler_Port

Key for configuring the port where the gateway to the Scheduler routing is situated.

{1024 to 65535}

Default: 64003

Example: VDogScheduler_Port=64203

VDogScheduler_PortRemote

Key for configuring the port via which the Scheduler of the octoplant server can be accessed. (The value is extracted from the runtime.)

{1024 to 65535}

Default: 64003

Example: VDogScheduler_PortRemote=64203

VDogScheduler_SvrRemote

Key for configuring the computer name of the octoplant server. (The value is extracted from the runtime.)

{computer name}

Required field

Example: VDogScheduler_SvrRemote=vDogServer1

VDogOsServer_Port

Key for configuring the port where the gateway for the OsServer Routing is situated.

{1024 to 65535}

Default: 64004

Example: VDogOsServer_Port=64204

VDogOsServer_PortRemote

Key for configuring the port via which the OsServer of the octoplant server can be accessed. (The value is extracted from the runtime.)

{1024 to 65535}

Default: 64004

Example: VDogOsServer_PortRemote=64204

VDogOsServer_SvrRemote

Key for configuring the computer name of the octoplant server. (The value is extracted from the runtime.)

{computer name}

Required field

Example: VDogOsServer_SvrRemote=vDogServer1

VDogReportingServer_Port

Port which the gateway for the ReportingServerRouting waits for.

Value: {1024 bis 65535}

Default: 64006

Example: VDogReportingServer_Port_Port=64206

VDogReportingServer_Port

Port fromwhich the ReportingServer is available from the octoplant server. (The value is extracted from the runtime.)

Value: {1024 bis 65535}

Default: 64006

Example: VDogReportingServer_PortRemote=64206

VDogReportingServer_SvrRemote

Computer name of the octoplant server (The value is extracted from the runtime).

Value: {computer name}

Required field

VDogReportingServer_SvrRemote=vDogServer1

VDogSecureConnect_Port

Port on which the gateway waits for SecureConnect routing.

The value specified here must be identical to the value of VDogSecureConnect_PortRemote.

{1024 to 65535}

Default: 64021

Example: VDogSecureConnect_Port=64221

VDogSecureConnect_PortRemote

Port from which the SecureConnect of the octoplantserver is accessed (The value is extracted from the runtime).

The value specified here must be identical to the value of VDogSecureConnect_PortRemote.

Value: {1024 bis 65535}

Default: 64021

Example: VDogSecureConnect_PortRemote=64221

VDogSecureConnect_SvrRemote

Computer name of the octoplant server. (The value is extracted from the runtime).

Value: {computer name}

Required field

Example: VDogSecureConnect

SvrRemote=vDogServer1

VDogApi_Port

Port at which the gateway listens for API routing.

The value given here needs to be the same as the value that was given for VDogApi_PortRemote.

Value: {1024 bis 65535}

Default: 64023

Example: VDogApi_Port=64223

VDogApi_PortRemote

Port at which the API of the octoplant server can be reached. (Value is read during run time).

The value given here needs to be the same as the value that was given for VDogApi_Port.

Value: {1024 to 65535}

Default: 64023

Example: VDogApi_PortRemote=64223

VDogApi_SvrRemote

Computer name of the octoplant server. (Value is read during run time).

Value: {Computer name}

Mandatory field

Example: VDogAPi_SvrRemote=VDogServer1

IpAddressesClient

Key for configuring the computer name/ IP addresses of participants (= clients) who are permitted to communicate via the gateway. (The value is extracted from the runtime). Multiple entries are separated by a comma. Place holders (?/*) are accepted

{computer name / IP-addresses} are separated by a comma

Required field

Example: IpAddressesClient=10.0.100.1, 10.0.100.2, 10.0.*.3

Implement the following settings in the [Logging] section:

Key Value

DebugLog

Absolute path to the log file. Logging is activated by setting the key

Example: DebugLog=C:vdoggatewaydebug.log

Example configuration

[Logging]
DebugLog=C:vdoggatewaydebug.log
[SimaticNet]  Enabled=N
[vdog_cs1]  Enabled=Y  VDogAdminServer_SvrRemote=vDogServer1  VDogOsServer_SvrRemote=vDogServer1  VDogCheckInCheckOutServer_SvrRemote=vDogServer1  VDogScheduler_SvrRemote=vDogServer1  VDogReportingServer_SvrRemote=vDogServer1  VDogSecureConnect_SvrRemote=VDogServer1  IpAddressesClient=10.0.100.1,10.0.100.2,10.0.*.3
[SimaticNet]  Enabled=N
[vdog_cs2]  Enabled=Y  VDogAdminServer_Port=64201  VDogAdminServer_SvrRemote=vDogServer2  VDogCheckInCheckOutServer_Port=64202  VDogCheckInCheckOutServer_SvrRemote=vDogServer2  VDogScheduler_Port=64203  VDogScheduler_SvrRemote=vDogServer2  VDogOsServer_Port=64204  VDogOsServer_SvrRemote=vDogServer2  IpAddressesClient=10.0.100.1,10.0.100.2,10.0.*.3

Last update: September 15, 2023

Related Articles

IMPRINT | PRIVACY POLICY | COOKIE POLICY

Privacy Preference Center