Information

Created By	Knowledge Migration User

Approval Process Status	Published

Objective

Description

Establishing a Connection – Remote Debugger (Magic xpa 3.x)

The Establish a Connection dialog box includes the following fields:

Field	Description
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: This port number. The port's range that is defined as the TCP/IP protocol parameters in the Communication repository in the Studio ini file. This range should include at least two ports.
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.

Note:

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.

Reference

Attachment

Attachment