Connection Profile Manager

From RAD Studio
Jump to: navigation, search

Go Up to Environment Options


Tools > Options > Environment Options > Connection Profile Manager
Project Manager | right-click a platform in Target Platforms | Edit Connection

Displays the existing connection profiles and enables you to create and manage connection profiles.

A connection profile is a named set of properties that define a connection to an instance of the Platform Assistant server running on a remote machine.

On this page, for each platform that has an associated connection profile, one profile is the default profile, which appears in bold type. Windows platforms do not have a default profile.

To create a connection profile, use this dialog box.

To associate a connection profile to a target platform on a project, use the Platform Properties dialog box. To open Platform Properties, right-click the target platform node on the Project Manager and choose Properties.

When You Must Use a Connection Profile

Connection profiles are required for the following instances in application development:

  • You need a connection profile to run or debug applications remotely. This allows you to run and debug applications that target 64-bit Windows (when on a 32-bit Windows development PC), Mac OS X or iOS.
    • You do not need a connection profile to run or debug Android applications.
  • You need a connection profile to use the Deployment Manager to deploy applications that target 64-bit Windows (when on a 32-bit Windows development PC), Mac OS X or iOS.
    • You do not need a connection profile to use the Deployment Manager to deploy applications for Android. RAD Studio deploys Android applications locally.
    • You can deploy applications without a connection profile if you do not use the Deployment Manager.
Note: To connect to a target platform, you must install and run the Platform Assistant server on the target platform, or on an intermediate platform that supports the target platform. That is, to connect to an iOS device (the target platform), you need the Platform Assistant server running on a Mac (the intermediate platform).

Filenames and File Extension for Connection Profiles

Profile names have few restrictions other than that they must be valid filenames, as determined by System.IOUtils.TPath.HasValidFileNameChars. Duplicated profile names result in an error (from the attempted Add, Copy, Rename, or Import).

The profile file extension is .profile, which is added automatically when the profile is saved as a file.

Examples of names for a connection profile:

  • MyFirstOSXApp
  • Gr8daZ!

Each profile you have defined is saved as a .profile file in your Application Data folder (as returned by DesignIntf.IDesigner170.GetAppDataDirectory), such as the following folder on Windows 7:

C:\Users\<username>\AppData\Roaming\Embarcadero\BDS\17.0

Connection Profile Manager Panel

Item Description

Profiles

Lists the connection profiles that have been defined, along with their associated platform. Boldface indicates the default profile for a platform.

  • To set a default profile for a platform, right-click the profile and select Set as Default.
  • To edit a profile, select it in the Profiles list, make changes to the Profile Properties, and then click OK (without the OK, your changes are not saved).

Clicking one of the profiles enables the buttons for managing a profile (Copy, Rename, Delete, and Export).

Profile Properties

Displays the current settings in the selected connection profile.

Platform

Displays the designated platform for the selected connection profile. The designated platform is the platform where the target instance of the Platform Assistant server is running. If you change the platform on this page, the position of the profile in the list of profiles might change accordingly.

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 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.

Host name

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, use the following commands as appropriate:

  • On the PAServer console on the target machine:
    • i
  • On the Mac Terminal window:
    • ifconfig
    Or select Apple menu > System Preferences > Network.
  • On the PC command window:
    • ipconfig

Port number

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

Password

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 Host 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.

Add

Launches the Create a Connection Profile wizard so that you can create a connection profile to connect to the target machine and specify the properties of the connection profile. The keyboard equivalent is pressing the Insert key on the keyboard while the Profiles list is in focus.

Copy

Prompts you for a new profile name and copies the currently selected settings of the profile to the new profile.

Rename

Prompts you for a new profile name and renames the currently selected profile to the new name. Any projects using the existing profile are updated to the new profile name.

Delete

Prompts you for confirmation and, if accepted, deletes the currently selected profile. You can also delete a profile by pressing the Delete key on the keyboard while the Profiles list is in focus.

Export

Prompts you for a filename and saves the profile to that location (the default file name is "<ProfileName>.profile").

Import

Prompts you for a .profile filename and imports the contained profile into the IDE.

See Also