Establishing a Connection – Remote Debugger (Magic xpa 4.x)
The Establish a Connection dialog box includes the following fields:
|
|
Activity monitor only
|
This check box controls whether a full debug will be enabled or just the Activity Monitor. Note: A full debug is only possible when attaching to a remote engine that is running the same project loaded in the Studio.
|
Host name
|
The host name of the TCP/IP of the remote server.
|
Port number
|
The port number you specified as the Remote Debugger Port for the runtime engine. To debug a remote computer, the following ports needs to be opened on that machine:
|
User
|
The user name is used for authentication according to the system logon setting as defined in the Magic.ini file.
|
Password
|
The password is used for authentication according to the system logon setting as defined in the Magic.ini file.
|
When you click OK, the engine will attempt to establish a connection. The user and password transferred to the Runtime engine will be encrypted.
After the connection, Magic xpa authentication is done as follows:
-
The Studio passes the username and password entered in the connection screen to the Runtime engine being debugged.
-
The Runtime engine authenticates the user according to the system logon method defined in the Magic.ini file.
-
If the authentication fails, a “User authentication failed” error is displayed in the Studio and the Studio returns to the connection screen.
-
If the authentication succeeds and there is a right assigned to the Remote Debugger Right application property, the Runtime engine checks whether the user has this right.
-
If the user does not have the right, the “User authentication failed” error is displayed in the Studio and the Studio returns to the connection screen.
|
-
If no host name or IP is provided, Magic xpa assumes that you are referring to the localhost.
-
Once a connection is established, no other Studio will be able to debug this application.
-
if there are two Runtime engines running at the same time on the server machine, they need to have different port numbers set up. Otherwise, you can only debug one of them.
|
Enable Remote Debugger environment setting
Remote Debugger Right
Detaching from the Remote Application