Ausführen des Platform Assistant auf dem Mac

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu PAServer: Die Platform Assistant Server-Anwendung

Den "Platform Assistant" können Sie auf dem Mac auf eine der beiden folgenden Weisen starten:

Hinweis:
  • Im Finder können Sie Optionen in einer .config-Datei festlegen.
  • Im Terminal-Fenster können Sie den "Platform Assistant" mit angepassten Optionen starten.
Unter Festlegen von Optionen für den Platform Assistant finden Sie Informationen zum Festlegen von Optionen für PAServer.

Ausführen von "Platform Assistant" im Finder

Aktivieren Sie auf dem Mac im Finder die .app-Datei (PAServer-20.0.app) wie folgt:

  1. Navigieren Sie zum obersten Applications-Ordner.
    Tipps:
  2. Doppelklicken Sie auf PAServer-20.0.app, um den "Platform Assistant" zu starten.
    SelectNewRADPAServer.png

    Hinweis: Informationen zu PAServer Manager finden Sie unter Ausführen von PAServer Manager auf dem Mac.
    Das Terminal-Fenster wird mit dem "Platform Assistant"-Banner und der Passworteingabeaufforderung angezeigt:
    Verbindungsprofil-Passwort <Eingabetaste für kein Passwort>:
 MyMac:~ myname$ /Applications/PAServer-16.0.app/Contents/MacOS/paserver ; exit;
 Platform Assistant Server  Version 7.0.1.40
 Copyright (c) 2009-2015 Embarcadero Technologies, Inc.

 Connection Profile password <press Enter for no password>:
 
 Acquiring permission to support debugging...succeeded

 Starting Platform Assistant Server on port 64211
 
 Type ? for available commands
 >
Tipp: Um die ausführbare Datei paserver im Finder anzuzeigen, klicken Sie mit der rechten Maustaste auf die Datei PAServer 20.0.app, und wählen Paketinhalt anzeigen. Dadurch werden die Verzeichnisse Contents und MacOS im Finder angezeigt. Im Terminal-Fenster werden diese Verzeichnisse immer angezeigt. Die ausführbare Datei paserver befindet sich im Verzeichnis "MacOS":
Applications/PAServer-20.0.app/Contents/MacOS/paserver

Ausführen von paserver in einem Terminal-Fenster

Die Datei paserver ist die ausführbare Befehlszeilendatei für den "Platform Assistant", und der Pfad zu paserver lautet:

 Applications yourname $ /Applications/PAServer-20.0.app/Contents/MacOS/paserver 

Das heißt, dass sich die ausführbare Datei paserver im Paket PAServer-20.0.app im Ordner Contents/MacOS befindet. Sie können die ausführbare paserver-Datei direkt im Terminal-Fenster ausführen.

Die folgende Anleitung zeigt zwei grundlegende Möglichkeiten zum Starten von paserver von der Befehlszeile aus: Durch Eingabe einer einzigen Befehlszeile im Ordner "Applications" oder durch Navigieren zum Ordner "MacOS". Bei dieser Methode haben Sie die Möglichkeit, die Dateieigenschaften im Verzeichnis PAServer-20.0.app/Contents/MacOS, einschließlich von paserver, zu überprüfen.

Beispiel: Eingeben einer einzelnen Befehlszeile im Ordner "Applications"

Im Mac-Terminal-Fenster können Sie mit einem einzigen Befehl den Inhalt der Datei PAServer-20.0.app durchsuchen und paserver starten:

  1. Öffnen Sie auf dem Mac ein Terminal-Fenster, und wechseln Sie mit cd zum obersten "Applications"-Ordner.
    Geben Sie beispielsweise den oder die Anfangsbuchstaben des "Applications"-Ordners ein, und drücken Sie dann die Taste TAB. Wenn ein Verzeichnis und nur ein Verzeichnis vorhanden ist, dessen Name mit den eingegebenen Buchstaben beginnt, wird der Verzeichnisname angezeigt:
    IhrName $ cd /A <TAB>
    IhrName $ cd /Applications <EINGABE>
    Applications IhrName $
    • Geben Sie einen "cd"-Befehl mit den Anfangsbuchstaben der aufeinanderfolgenden Teile des Pfades ein, und drücken Sie nach jeder Eingabe die Taste TAB, um den Teil zu vervollständigen.
    Die komplette Befehlszeile für den Pfad sollte ungefähr wie folgt aussehen:
    Applications IhrName $ /Applications/PAServer\ &20.0.app/Contents/MacOS/paserver
  2. Drücken Sie die EINGABE-Taste.

Beispiel: Navigieren zum Installationsverzeichnis von paserver (MacOS-Ordner)

Sie müssen zu folgendem PAServer-Verzeichnis navigieren:

 mymac:~ myname$ cd Applications
 mymac:Applications myname$ cd PAServer 16.0
 mymac:PAServer 16.0 myname$

Im Mac-Terminal-Fenster können Sie mit einer Reihe von cd-Befehlen den Inhalt der Datei PAServer-20.0.app durchsuchen und paserver starten:

  1. Verwenden Sie cd-Befehle und die TAB-Taste. Um beispielsweise den Ordner "Applications" (vom Benutzerverzeichnis auf dem Mac aus) zu starten, geben Sie Folgendes ein:
    IhrName $ cd /A <TAB> <EINGABE>
  2. Zeigen Sie den Inhalt des "Applications"-Ordners durch folgende Eingabe an:
    Applications IhrName $ ls
    Im "Applications"-Verzeichnis sollte PAServer-20.0.app angezeigt werden.
  3. Navigieren Sie durch das PAServer 20.0-Paket, indem Sie die Anfangsbuchstaben jedes Ordners eingeben und die Taste TAB drücken:
    Applications IhrName $ cd PAS <TAB>
    Con <TAB>
    Mac <TAB>
    pas <TAB>
    Nun sollte die folgende Befehlszeile angezeigt werden:
    Applications IhrName $ /Applications/PAServer\ <Version>.app/Contents/MacOS/paserver
  4. Drücken Sie die EINGABE-Taste, um den Befehl auszuführen.
  5. Im MacOS-Verzeichnis wird "paserver" angezeigt. Geben Sie folgenden Befehl ein:
    MacOS IhrName $ ./paserver.
    Hinweis: Auf dem Mac müssen Sie jedem Ausführen-Befehl die Zeichen ./ voranstellen.
  6. Drücken Sie die EINGABE-Taste.

Beispiel: Festlegen der Port-Nummer beim Starten von PAServer von der Befehlszeile

Sie können mehrere Instanzen von PAServer ausführen, solange jeder Server eine eindeutige Port-Nummer verwendet.

Fügen Sie die Befehlszeilenoption -port hinzu, wenn Sie PAServer ausführen:

MacOS IhrName $ ./paserver -port=64444

Weitere Informationen finden Sie unter Festlegen von Optionen für den Platform Assistant.

Anmelden beim Platform Assistant

Nach dem Start von paserver zeigt der "Platform Assistant" ein Banner und dann die Passworteingabeaufforderung an:

 Connection Profile password <press Enter for no password>: 
  1. Bei der Passworteingabeaufforderung haben Sie folgende Möglichkeiten:
    • Geben Sie ein Passwort Ihrer Wahl ein, und drücken Sie die EINGABE-Taste. Für die Verbindung zu diesem "Platform Assistant" ist dann dieses Passwort erforderlich.
    • Wenn Sie kein Passwort für die Verbindung zu diesem "Platform Assistant" festlegen möchten, drücken Sie die EINGABE-Taste.
  2. Wird der "Platform Assistant" während einer Sitzung auf dem Mac zum ersten Mal gestartet, wird das Dialogfeld Developer Tools Access angezeigt:
    TakeControl.png
    • Geben Sie das Passwort für den Mac ein, und klicken Sie auf Take Control (Steuerung übernehmen), um das Debuggen mit dem "Platform Assistant" zuzulassen. Dieses Passwort ist dasselbe, das Sie eingeben, wenn Sie sich beim System anmelden; Administratorzugriff ist erforderlich.
      Sie können die Anmeldung entweder mit dem in diesem Dialogfeld angezeigten Benutzernamen fortsetzen oder einen anderen Benutzernamen eingeben.
    • Erneuter Versuch: Wenn Sie nicht das richtige Passwort eingeben oder den Vorgang abbrechen, startet der "Platform Assistant" normal, aber beim nächsten Versuch, eine Anwendung von RAD Studio aus mit dem "Platform Assistant" zu debuggen, werden Sie wieder zur Eingabe des Administratorpassworts aufgefordert.
      Siehe Übernahme der Berechtigung zur Debugging-Unterstützung auf einem Mac.

Nach Ausführung dieser Schritte werden im Terminal-Fenster die beiden folgenden Zeilen angezeigt:


Starting Platform Assistant Server on port 64211 
>

Die Eingabeaufforderung > gibt an, dass sich der Platform Assistant im Empfangsmodus für den angegebenen Port (standardmäßig Port 64211) befindet. Geben Sie den Befehl h ein (geben Sie "h" ein, und drücken Sie die EINGABE-Taste), um die Liste der verfügbaren Befehle zusammen mit einer Beschreibung anzuzeigen. Geben Sie den Befehl q ein, um den "Platform Assistant" zu beenden.

Verbindungsprobleme

Ausführen von PAServer bei aktivierter Mac-Firewall

Wenn auf dem Mac die Firewall aktiviert ist, wird beim Start von PAServer auf dem Mac nach "Berechtigung zur Debugging-Unterstützung wird übernommen" folgende Meldung angezeigt:

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

Auch wenn Sie hier auf "Allow" (Zulassen) klicken, kann PAServer keine Verbindung von Ihrem Entwicklungssystem zu dem Mac herstellen. Sie müssen PAServer ausdrücklich die Verwendung einer der folgenden Lösungen einräumen:

Lösung 1: Deaktivieren der Firewall auf dem Mac. Gehen Sie dazu folgendermaßen vor:

  1. Öffnen Sie auf dem Mac im Apple-Menü Systemeinstellungen.
  2. Wählen Sie Sicherheit und dann die Registerkarte Firewall.
  3. Klicken Sie auf das Schloss-Symbol in der linken unteren Ecke.
  4. Klicken Sie auf die Schaltfläche Stopp.
  5. Klicken Sie auf das Schloss-Symbol, und schließen Sie das Fenster Sicherheit.

Lösung 2: Zulassen, dass PAServer durch die Firewall auf den Mac zugreift. Gehen Sie dazu folgendermaßen vor:

  1. Öffnen Sie auf dem Mac im Apple-Menü Systemeinstellungen.
  2. Wählen Sie Sicherheit und dann die Registerkarte Firewall.
  3. Klicken Sie auf Firewall. (Wenn diese Schaltfläche deaktiviert ist, klicken Sie auf das Schloss-Symbol in der linken, unteren Ecke.)
  4. Klicken Sie auf das Plus-Zeichen (+), und navigieren Sie zum Applications-Ordner.
  5. Wählen Sie PAServer-20.0.app, und klicken Sie dann auf Hinzufügen. Dadurch wird PAServer <Version>.app den in den FireWall-Optionen aufgeführten Apps hinzugefügt.
  6. So fügen Sie die binäre paserver-Datei hinzu:
    1. Klicken Sie auf das Pluszeichen (+).
    2. Drücken Sie die Tasten BEFEHL-UMSCHALT-G.
    3. Geben Sie in Gehe zum Ordner: den vollständigen Pfad zu paserver ein. Zum Beispiel:
      /Applications/PAServer <Version>.app/Contents/MacOS
    4. Der Inhalt des MacOS-Verzeichnisses wird angezeigt. Suchen Sie paserver, und doppelklicken Sie darauf. Damit wird die binäre paserver-Datei den Apps in den FireWall-Optionen hinzugefügt.
  7. Klicken Sie auf das Schloss-Symbol, und schließen Sie das Fenster Sicherheit.

Siehe auch Ausführen des Platform Assistant auf dem Mac.

Herstellen einer Verbindung zu einem PAServer, wenn der Port verwendet wird

Möglicherweise wird der folgende Fehler angezeigt, wenn Sie versuchen, PAServer auf dem Mac auszuführen und der Socket verwendet wird (vielleicht von einer Instanz von PAServer, die bereits ausgeführt wird oder auf die nicht mehr zugegriffen werden kann):

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

Führen Sie zur Lösung dieses Problems einen der folgenden Schritte aus:

  • Verwenden der vorhandenen Instanz von PAServer.
  • Anhalten der vorhandenen Instanz von PAServer.
  • Beenden der vorhandenen Instanz von PAServer wie folgt:
    1. Geben Sie im Terminalfenster ps -a ein.
    2. Suchen Sie die Instanz von PAServer und deren PID-Nummer.
    3. Geben Sie folgenden Befehl ein: kill <pid>.

Siehe auch