Create a Connection Profile

From RAD Studio
Jump to: navigation, search

Go Up to Connection Profile Manager

This wizard allows you to create a connection profile (a named set of properties describing a connection to an instance of the Platform Assistant running on a remote machine). A connection profile is required in the following situations:

  • To build, run and debug applications for 64-bit Windows (if your development PC runs 32-bit Windows), 64-bit Linux, macOS and iOS.
  • To run and debug 32-bit, 64-bit Windows, and 64-bit Linux applications remotely.
  • To deploy applications using the Deployment Manager. However, you do not need a connection profile to use the Deployment Manager for Android.

Opening the Connection Profile Wizard

To open the wizard, do any of the following:

Using the Wizard

Profile information page

Item Description

Profile name

Specify the name for the connection profile you are creating. Profile names must be valid filenames as determined by System.IOUtils.TPath.HasValidFileNameChars.


Select the platform where the target instance of the Platform Assistant server is running.

If you need a connection profile for either the iOS Device - 32 bit, iOS Device - 64 bit or the iOS Simulator target platforms, select the macOS platform here. macOS is an intermediate platform which allows you to build, run, debug, and deploy not only macOS applications, but iOS applications as well.

Set as default for the selected platform

Makes the new profile the default for the selected platform.

  • For the 32-bit Windows and 64-bit Windows platforms, this checkbox is hidden; the Windows platforms do not have a default profile.
  • If you select a platform for which there is no default, the checkbox becomes checked, and you cannot uncheck it.
  • If you select a platform that already has a default, the checkbox automatically becomes unchecked (you can set the new platform as the default by double-clicking the profile name on the Connection Profile Manager page).

Remote machine information page

Item Description

Remote machine (IP address or Machine name)

Enter either the hostname (name of the machine as known on the network using standard DNS lookup) or the IP address of the target machine. To determine the IP address of the target machine, enter any of the following commands:

  • i on the PAServer console on the target machine
  • ifconfig on the Mac or Linux Terminal window
  • ipconfig on the PC command window

For a multi-device application, the remote machine is typically the actual target platform, but in the case of iOS apps, the remote machine is the Mac (not the iOS Simulator or the iOS Device).

Port number

Port number used when connecting to the Platform Assistant server on the target machine.


Password that was set for the instance of the Platform Assistant server to which this profile will connect.

Connection Profile password <press Enter for no password>:
You can also set the password by including the -password=<password> option in your command to run paserver.
  • Do not enter a password if no password was set for the paserver to which this connection profile connects.
  • To browse for an existing encrypted password file (.passfile), click the ellipsis [...]. You create a .passfile by using the g option when you run the paserver (Platform Assistant) on the target machine.

Test Connection

Attempts to establish a connection to the target machine, using the specified Remote machine (IP address or Machine name) and Port number. Displays a message indicating success or failure. The connection succeeds only if the Platform Assistant server is running on the target machine first.

See Also