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.
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 versiondog 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 versiondogserver. (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 versiondog 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 versiondog 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 versiondog 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 versiondog 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 versiondog 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 versiondog 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 versiondog server. (The value is extracted from the runtime.)
Value: {1024 bis 65535}
Default: 64006
Example: VDogReportingServer_PortRemote=64206
VDogReportingServer_SvrRemote
Computer name of the versiondog 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 versiondogserver 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 versiondog 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 versiondog 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 versiondog 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