7.4.9. Starting a standalone server in debug mode with an external debug server

To debug using the standalone server, execute the following steps (it is assumed that all components of the system run on the same computer):

Start the debug server:

dbgs -port=1970

Start the standalone server that will interact with this debug server:

ibsrv --dbms=mssqlserver --database-server=dbServerName --db-user=dbUser --database-password=dbUserPassword --database-name=docs-db --name=docs-db --data="D:\ss-data\cs-data" --debug=http://localhost:1970

Specifying the --name parameter is critical.

IMPORTANT. Specifying a different infobase name value in the standalone server startup command line and in Designer settings (in the next step) will not allow debugging.

Configure Designer to use the debugger. In the parameter dialog box of Designer where the debugger will operate, do the following:
- Set HTTP debug protocol.
- Specify remote debug server address. It is the address of the debug server started at step 1.
- Specify the infobase name from the --name parameter of the standalone server startup command line. Important: configurations in the standalone server infobase and in the debugger infobase must be completely identical.

Fig. 59. Configuring debugging in Designer

Connect Designer to the standalone server. The configuration in the standalone server database and the infobase to debug must match.
As a last step, you need to ensure that debug items are automatically attached in Designer or attach debug items manually.

If all the actions are executed correctly, it will become possible to debug the application running on the standalone server (both the client and server parts) in Designer.