Running the Platform Assistant on a Mac

You can start the Platform Assistant on the Mac in either of the following ways:

  • Double-click RAD PAServer <version>.app in the Finder (graphically)
    For example: RAD PAServer XE5.app
  • Run the paserver executable using the Terminal window (command line)
Notes:

Using the Finder to Run the Platform Assistant

In the Finder on the Mac, activate the .app file (RAD PAServer <version>.app) as follows:

  1. Navigate to the top-level Applications folder.
    Tip: If you used another installation path, go to the appropriate directory.
  2. Double-click RAD PAServer <version>.app to start the Platform Assistant.
    SelectNewRADPAServerV2.png

    The Terminal window appears, displaying the Platform Assistant banner and the password prompt:
    Connection Profile password <press Enter for no password>:
PAServer sign-on message
Responding to the password prompt is described in Signing On to the Platform Assistant.
Tip: To see the paserver executable in the Finder, right-click the RAD PAServer <version>.app file and select Show Package Contents. This displays the Contents and MacOS directories in the Finder. In the Terminal window, these directories are always shown. The paserver executable resides in the MacOS directory:
Applications/RAD PAServer <version>.app/Contents/MacOS/paserver

Running paserver in a Terminal Window

The file named paserver is the command-line executable for the Platform Assistant, and the path to paserver is:

 /Applications/RAD PAServer <version>.app/Contents/MacOS/paserver 

That is, the paserver executable resides in the Contents/MacOS folder inside the package RAD PAServer <version>.app. You can directly run the paserver executable in the Terminal window.

The following procedures illustrate two basic ways to start paserver on the command line: by entering a single command line from the Applications folder, or by navigating to the MacOS folder. This method gives you the opportunity to review the file properties in the PAServer <version>.app\Contents\MacOS directory, including paserver.

Example: Entering a Single Command Line from the Applications Folder

On the Mac Terminal window, you can use a single command to drill down into the contents of the RAD PAServer <version>.app file and start paserver:

  1. Open a Terminal window on the Mac, and cd to the top-level Applications folder.
    For example, enter the initial letter or letters of the Applications folder, and then press the Tab key. If there is one and only one directory whose name begins with the letters you type, the directory name appears:
    yourname $ cd /A <Tab>
    yourname $ cd /Applications <Return>
    Applications yourname $
    • Enter a cd command containing the initial letters of successive portions of the path, and press the Tab key after each entry to complete that portion.
    When you complete the path, your command line should look like this:
    Applications yourname $ /Applications/RAD\ PAServer\ <version>.app/Contents/MacOS/paserver
  2. Press Return.

Example: Navigating to the Installed Location of paserver (MacOS Folder)

On the Mac Terminal window, you can use a series of cd commands to drill down into the contents of the RAD PAServer <version>.app file, and start paserver:

  1. Use cd commands and the Tab key. For example, to open the Applications folder (starting at the user home location on the Mac), enter:
    yourname $ cd /A <Tab> <Return>
  2. Display the contents of the Applications folder by entering:
    Applications yourname $ ls
    You should see RAD PAServer <version>.app in the Applications directory.
  3. Navigate into the RAD Paserver <version> package by entering the initial letters of each folder and pressing the Tab key, as follows:
    Applications yourname $ cd RAD <Tab>
    Con <Tab>
    Mac <Tab>
    pas <Tab>
    You should see the command line as follows:
    Applications yourname $ /Applications/RAD\ PAServer\ <version>.app/Contents/MacOS/paserver
  4. Press Return to execute the command.
  5. In the MacOS directory, you should see paserver. Enter:
    MacOS yourname $ ./paserver.
    Note: On the Mac, you must prefix any run command with the characters './'.
  6. Press Return.

You can also add command-line options when you run paserver, such as:

MacOS yourname $ ./paserver -port=64444

For more information, see Setting Options for the Platform Assistant.

Signing On to the Platform Assistant

After you start paserver, the Platform Assistant displays its banner, followed by its password prompt:

 Connection Profile password <press Enter for no password>: 
  1. At the password prompt, choose one of the following:
    • To require a password for connecting to this Platform Assistant, enter a password of your choice, and press Enter.
    • If you do not want to require a password for connecting to this Platform Assistant, press Enter.
  2. If this is the first time you start the Platform Assistant during a session on the Mac, the Mac displays the Developer Tools Access dialog box:
    Developer Tools Access is trying to take control of another process.
    Type your password to allow Developer Tools Access to make changes.
Enter the administrator password for the Mac (typically the password you enter when you log on to the system) to allow debugging with the Platform Assistant.
If you fail to provide the correct password or if you cancel, the Platform Assistant starts normally, but the next time that you try to debug an application from RAD Studio using the Platform Assistant you are prompted again for the administrator password. See Acquiring Permission to Support Debugging on a Mac.

After you follow these steps, you see the following two lines in the Terminal window:

Starting Platform Assistant Server on port 64211 
>

The > command prompt indicates that the Platform Assistant is in "listening" mode on the specified port (64211 by default). You can enter the h command (type "h" and press Enter) to see the list of available commands along with a description. To quit the Platform Assistant, enter the q command.

Connection Issues

Running PAServer if the Mac Firewall is Enabled

If the firewall on your Mac is enabled, you see the following message after "Acquiring permission for debugging" when you start PAServer on the Mac:

 Do you want the application "paserver" to accept incoming network connections?"

Even if you click "Allow" here, PAServer cannot connect from your development system to the Mac. You need to specifically permit PAServer using one of the following solutions:

Solution 1: Disable the firewall on the Mac. Use the following steps:

  1. On the Mac, open System Preferences in the Apple menu.
  2. Select Security & Privacy and then the Firewall tab.
  3. Click the Lock icon in the lower left corner.
  4. Click the Turn Off firewall button.
  5. Click the Lock icon and close the Security & Privacy window.

Solution 2: Specifically allow PAServer access through the firewall on the Mac. Use the following steps:

  1. On the Mac, open System Preferences in the Apple menu.
  2. Select Security & Privacy and then the Firewall tab.
  3. Click Firewall Options. (If this button is disabled, click the Lock icon in the lower left corner.)
  4. Click the + sign and navigate to the Applications folder.
  5. Select RAD PAServer <version>.app and then click Add. This adds the RAD PAServer <version>.app bundle to the apps listed in FireWall Options.
  6. To add the paserver binary:
    1. Click the + sign.
    2. Type Command-Shift-G.
    3. In Go to the folder:, enter the full path to paserver. For example:
      /Applications/RAD PAServer <version>.app/Contents/MacOS
    4. The contents of the MacOS directory is displayed. Locate and double-click paserver. This adds the paserver binary to the apps listed in FireWall Options.
  7. Click the Lock icon and close the Security & Privacy window.

See also Running the Platform Assistant on a Mac.

Connecting to a PAServer When the Port Is in Use

You might see this error if you try to run PAServer on the Mac and the socket is in use (perhaps by an instance of PAServer that is already running or has becoming inaccessible):

Message: Could not bind socket. Address and port are already in use.

The solution is to do any one of the following:

  • Use the existing instance of PAServer.
  • Stop the existing instance of PAServer.
  • Kill the existing instance of PAServer, as follows:
    1. In terminal window, enter: ps -a.
    2. Find the instance of PAServer and its PID number.
    3. Enter: kill <pid>.

See Also