Technical Reference Manual - InduSoft

Database Interface
Studio Database Gateway
The Studio Database Gateway is a TCP/IP server that interacts with databases using the Microsoft .Net
Framework. It can run on the same computer that is running the IWS project, or on a different computer. The
Database Gateway Host in the Advanced Settings (see Database Configuration dialog) specifies whether the
gateway will be running on the local computer or not. If you are using the local computer you should enter
either localhost or 127.0.0.1 in the Host name. You do not need to worry about starting or stopping the
gateway because it will be done automatically by IWS tasks. On the other hand, when running the gateway
remotely, you need to start the gateway manually. To do so, copy the files StADOSvr.exe and StADOSvr.ini
from the \BIN folder to the remote computer, and then execute the StADOSvr.exe.
The gateway can be started multiple times for different TCP/IP port numbers. The default port number is
3997, and it is changed by specifying the desired port number in the command prompt (e.g., StADOSvr
1111 ). When running the StADOSvr, it will add the following icon to the system tray:
When you right-click on the icon, the following shortcut menu is displayed:
The Hide option controls whether the Studio Database Gateway window is displayed on the desktop. (The
gateway software runs continuously after you launch it, regardless of whether the window is displayed.) If you
disable the Hide option, then the window is displayed:
Studio Database Gateway
Any failure that occurs during operations with databases will be displayed both in this window and also in the
LogWin window. The messages are reported by exceptions generated by the ADO.NET Provider. (Please refer to
Database Troubleshooting for more information about error messages in the gateway module.)
You can configure the output in this window by using the Log menu:
• Show Log menu option: Shows the IWS Database Gateway log files.
Page 488
InduSoft Web Studio