Create a Connection Profile

From RAD Studio
Jump to: navigation, search

Go Up to Tools Options Dialog Box

This wizard enables 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. You need to create connection profiles:

  • To build, run and debug applications for 64-bit Windows (if your development PC runs 32-bit Windows), Mac OS X and iOS.
  • To run and debug 32-bit and 64-bit Windows 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 Wizard

To invoke this 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 or the iOS Simulator target platforms, select the OS X platform here. OS X is an intermediate platform which allows you to build, run, debug, and deploy not only Mac OS X 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 Terminal window
  • ipconfig on the PC command window

The target machine is typically the target platform for the cross-platform application, but in the case of iOS apps, the remote machine is the Mac (not the iOS Simulator or 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