Home

Einrichten des Panels

1. MIIEIDCCA3SgAwIBAgWWAL4AGZKhkL5SWMAOGCSqGSIb3DQEBBQUAMIGKMASWCOYD VQQGEwWJSVTELMAkGA1UECBMCTIYxFDASBgNVBAcT CO5vdm9zaWJpcnNrMRIWEAYD VQQKEwIQY XJhbGxlbHMxDjJAMBgNVBAsTBVBsZXNrMQO0wCwY DVQQDEwRhYmVsMSU w IwYJKoZIhveNAQKBFhZhYmVseWFIdkBwYXJhbGxIbHMuY29tMB4XDTASMDQyODAZz NDMxMloXDTEWMDQyODAZNDMxMlowgYoxCzAJBgNVBAYTAIJVMQswCQYDVQQIEWsO VjJEUMBIGA1 UEBxMLTm92b3NpYmlyc2sxEj AQBgNVBAoTCVBhcmF sbGVsczEOMAwG A1UECxMFUGxic2sxDTALBgNVBAMTBGFIZWwxJT AjBgkahkiG9wOBCQEWFMFIZWX5 YWV2QHBhemF sbGVscy5jb20wggEIMAOGCSqGSlb3DQEBAQUAA4IBDwAwggEKAoIB AQDIsIx5nXTQTvoic3GgW4HH5n5P0Cz95Z9XNtCykwvOM2HdhMeNvde1 NYDvkipa FHzVPEH7eBgjAsHR4y1J4zVGAs2KiJFOWS1 vi5YAVMOJ7Ysyz8WLPOPQWTmUoMEM aEOP7m788tphL328chdPJTjICF6w9FKzddzrvdek04o0jp2cRO6fFMH7WJPcajvh 132 Einrichten ber Remote API 3EuYpc7xBNC6Wf8Gk 6tB5kCCe7wpHyXsc 7ve9 7nn30p6rUXypBNHY mLujMCtSg0l K2xOCaSsCwkeUQ4mpxrr5IK7yM07b322vNZBiMT HV8DnaOW DPIcEIFI8NmOVJovub dG5wdXopA 6seCQLaf95IVULrAgMBAAGijgflwge8wHQY DVROOBBYEFLSg4V0zc0i0 pRFtcygailgz5ikCMIG BgNVHSMEgbcwgbSAFLSg4V0zcO0i0pRFtcygaiTgz5ikC oYGQpIGNMIGKMQswCQY DVQQGEwJSVTELMAkGA1UECBMCTIYxFDASBgNVBAcTCO 5y dm9zaW JpcnNrMRIWEAYDVQQKEwlQYXJhbGxlbHMxDjAMBgNVBAsTBVBsZXNrMQO0w CwYDVQQDEwRhYmVsMSUwlwYJKoZlhvcNAQkKBFhZhYmVseWFidkBwYXJhbGxlbHMu Y29tggkAvgAbMqGQvnAwDAY DVROTBAUWAWEB zANBgkqhkiG2wOBAQUFAAOCAQEA dEkV4DZMr7Rp0dlYqDpdviGu7FE 7R5u87Mz3E9cT Apycbg4KT
2. 2uursssnnnnnennnnnnnennnnennennnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nn ern 150 Einrichten ber CLI 207 ber die Panel Befehlszeilenschnittstelle CL 1 CETE EE P A PEA DOE A ETTE NR TEE EA 208 Einriehten des Panelsz an Dr E EA E AAE AE E A A T EE E E AEEA 209 Initialisierung des Panels 444444444004nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nn ennn nanna 210 Installation des Lizenzschl ssels uu 000uuunnnnnenaannnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 211 Branding deS Pane yrs E E ESAN 211 BNS K nfiguration h 2 ae eaa a a aeaa a aa EAEE Eia 213 Installation von SSL Zertifikaten uuuuunnnansnnennnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 220 Erstellen von DOMAINS uuuuasenunsnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nen 222 Erstellen von Subdomains uuuuussssasnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 223 Verf gbare APS Kataloge definieren 240srsn0unnnnonnnnnennnnnnnnnnnnnnnnnnnnnnnnnn nn 224 Installieren von Anwendungen 2uurs224s0nnennnnnnnennnnennennnnnnnnnnnnnnn nn nnnnnnnnnnnnnnnnnnn nn 225 4 Einleitung Einleitung In diesem Abschnitt Typographische Konventionen uu sss44 seen Feedba k nee ee Typographische Konventionen Vor der Verwendung dieses Handbuchs sollten Sie die darin verwendeten Konventionen kennen Mit den folge
3. Nu Console WriteLine Password Administrator password x Console WriteLine FileName Upload file name return Verifies the remote Secure Sockets Layer SSL certificate used for authentication ServicePointManager ServerCertificateValidationCallback new RemoteCertificateValidationCallback RemoteCertificateValidation Request request new Request request XmlSchemaValidation XmlSchemaValidation try XmlDocument result request UploadFile filename Einrichten ber Remote API 159 PrintResult result catch I Exception e Console WriteLin Request error 0 e Message The following method is invoked by the RemoteCertificateValidationDelegate private static bool RemoteCertificateValidation object sender X509Certificate certificate X509Chain chain sslPolicyErrors if sslPolicy SslPolicy SslPolicy Errors Errors L Errors RemoteCertificateNotAvailable return true Console WriteLine Certificate error 0 sslPolicy Errors Do not allow this client to communicate with unauthenticated servers return false M private static void XmlSchemaValidation object sender ValidationEventArgs e Console WriteLine Validation error 0 e Message static void PrintResult XmlDocument document XmlTextW
4. Parsing and validating packet Pi private XmlDocument ParseAndValidate TextReader xml string schemaUri XmlSchemaSet schemas new XmlSchemaSet schemas Add null schemauUri XmlReaderSettings settings new XmlReaderSettings if XmlSchemaValidation null settings ValidationEventHandler new ValidationEventHandler XmlSchemaValidation settings ValidationType ValidationType Schema settings ValidationFlags XmlSchemaValidationFlaqgs ProcessSchemalocation settings Schemas schemas XmlDocument document new XmlDocument using XmlReader reader XmlTextReader Create xml settings 158 Einrichten ber Remote API document Load reader return document private XmlDocument GetResponse HttpWebRequest request using HttpWebResponse response HttpWebResponse request GetResponse using Stream stream response GetResponseStream using TextReader reader new StreamReader stream return ParseAndValidate reader OutputValidationSchema class Program static void Main string args if args Length lt 4 Console WriteLine Usage ParalLelSpaNelapirpcclient lt Hostname gt lt Login gt lt Password gt lt FileName gt Console WriteLine Console WriteLine Hostnam The Panel s host name Console WriteLine Login Administrator login
5. Anwendungspaket aus der die Anwendung installiert werden soll Identifiziert entweder durch die Information name version release oder durch die Paket ID Diese Daten erhalten Sie wenn Sie die verf gbaren Pakete abrufen Wenn Sie die verf gbaren Pakete abrufen erhalten Sie eine detaillierte Liste mit den Anwendungspaketen die in das Panel importiert werden sowie den ben tigten IDs Ziel Domain oder Subdomain Installationseinstellungen Diese sind anwendungsspezifisch es k nnen auch Anwendungen ohne Installationseigenschaften oder Einstellungen vorhanden sein Die Panel API unterst tzt nicht die Informationsabfrage von Anwendungseinstellungen Sie sollten diese abfragen indem Sie die API des APS Katalogs http www apsstandard org r doc aps catalog 1 1 api index htm verwenden oder indem Sie die Metadaten Datei des Pakets parsen Eine Beschreibung des APS Formats finden Sie in den APS Format Spezifikationen unter http www apsstandard org providers documentation berblick zu Setupvorg ngen 47 Verf gbare APS Kataloge definieren Die Liste mit den APS Katalogen die in der Konfigurationsdatei definiert wird wird aus den folgenden zwei Gr nden angegeben 1 Anwendungen aus diesen Katalogen k nnen direkt ber die Panel API auf einer Domain installiert werden Hinweis Es ist nicht m glich Anwendungen aus einem APS Katalog zu installieren die nicht in der Konfigurationsdatei aufgelistet werden 2 Diese
6. 1 0 Operator 0 utput Result rom PA level F t output I ar a 1 1 Debug info Ein Antwortpaket enthalt entweder die Antwort von bestimmten Operatoren oder den Fehler der Panel Anwendung die in dem Systemknoten system wiedergegeben wird Detaillierte Informationen zu den Bedeutungen der Knoten system und output finden Sie in dem Abschnitt Fehlerhandling auf Seite 63 Um die Struktur der Antworten zu analysieren bendtigen Sie das Schema agent output xsd Dieses Schema z hlt die Antwortdatentypen f r alle Operatoren auf die von einer bestimmten Version von API RPC unterst tzt werden und gibt zudem die Ausgabeschemata an die mit diesen Operatoren bereinstimmen Innerhalb eines jeden operator Elements eines Antwortpakets ist ein typischer Antwortdatentyp enthalten das ein result Element oder oder mehrere beinhaltet Dieses Element wird ber complex type dargestellt und beinhaltet typischerweise den Typ resultType der in dem Schema common xsd wie folgt definiert wird lt xs complexType name resultType gt lt xs sequence gt lt xs element name status type result_status gt lt xs element gt lt xs element name errcode type unsignedInt minOccurs 0 gt lt xs element gt 62 Einrichten ber Remote API lt xs element name errtext type xs string minOccurs 0 gt lt xs element gt lt xs sequence gt lt xs complexType gt Das result Element kann
7. Console WriteLine Protocol API RPC protocol version Console WriteLine Request Request file path xml return Verifies the remote Secure Sockets Layer SSL certificate used for authentication ServicePointManager ServerCertificateValidationCallback new RemoteCertificateValidationCallback RemoteCertificateValidation Request request new Request request XmlSchemaValidation XmlSchemaValidation request Hostname args 0 10 49 8 120 request Login ehe M Sexclaatin p request Password args 2 setup za corocol aegqe Sig 7 1 0 220 8 string packet args 4 request xml try XmlDocument result request Send packet PrintResult result catch Exception e Console WriteLine Request error 0 e Message The following method is invoked by the RemoteCertificateValidationDelegate private static bool RemoteCertificateValidation object sender X509Certificate certificate X509Chain chain SslPolicyErrors sslPolicyErrors Einrichten ber Remote API 79 if sslPolicyErrors SslPolicyErrors RemoteCertificateNotAvailable return true Console WriteLine Certificate error 0 sslPolicyErrors Do not allow this client to communicate with unauthenticated servers return false if private static void XmlSchemaValid
8. lt add gt lt domain gt lt packet gt Dieses Paket berichtet ber das Ergebnis der add Operation und der ID und GUID von der gerade erstellten Domain Code Beispiel using System using System Net using System Text using System IO using System Xml using System Xml Schema using System Security Cryptography X509Certificates using System Net Security namespace PanelApiRpcClient public class Request Public interface Vee public string Hostname localhost Panel Hostname fOWOLLae starne LOGA aCei OCNA if Administrator s Login public string Password admin passwd Administrator s Password owlollike Geist Drrosocol 1 6 2 0 API RPC Version Protocol Handler for receiving information about document type definition DTD XML Data Reduced XDR schema and XML Schema definition language XSD schema validation errors public ValidationEventHandler XmlSchemaValidation null public Request 76 Einrichten ber Remote API public string AgentEntryPoint get return https 4 Hostname 8443 enterprise control agent php public string InputValidationSchema get return https 4 Nu Hostname 8443 schemas rpc Protocol agent input xsd public string OutputValidationSchema get return https 4 NN Hostname 8443
9. lt locale gt de DE lt locale gt lt initial setup gt lt smb gt lt packet gt 92 Einrichten ber Remote API Struktur des Antwortpakets Der initial_setup Knoten des ausgegebenen XML Pakets ist wie folgt strukturiert SMBinitialSetupOutputType r resultType Result status ok error Error code if error occurred ee n Error message if error occurred u 8 o amp result erforderlich Verpackt die vom Server abgerufene Antwort Datentyp resultType common xsd status erforderlich Gibt den Ausf hrungsstatus der Operation an Datentyp string Zul ssige Werte ok error errcode erforderlich falls die Operation fehlschl gt Gibt den Fehlercode wieder Datentyp integer errtext erforderlich falls die Operation fehlschl gt Gibt die Fehlermeldung wieder Datentyp string Operations spezifische Fehler 1003 Initialisierungsfehler des Agent Engines Das Panel ist bereits initialisiert 1019 ung ltiger Werte Das angegebene Gebietsschema ist nicht verf gbar Einrichten ber Remote API 93 Antwort Beispiele Eine positive Antwort vom Server sieht wie folgt aus lt packet version 1 6 2 0 gt lt smb gt lt initial_setup gt lt result gt lt status gt ok lt status gt lt result gt lt initial_setup gt lt smb gt lt packet gt Die folgende negative Antwort wird vom Panel empfangen falls es bereits initialis
10. wobei lt languagecode2 gt ein zweistelliger Code bestehend aus Kleinbuchstaben ist der von ISO 639 1 abgeleitet wurde und lt country regioncode2 gt ist ein zweistelliger Code bestehend aus Gro buchstaben der von ISO 3166 abgeleitet wurde Beispiel Der L ndercode f r Deutsch ist Germany de DE Beispiele 1 Mit dem folgenden Befehl initialisieren Sie das Panel und konfigurieren das Administrator Passwort jskekekHTD bzw die E Mail Adresse johndoe example com Auf Linux Unix init_conf init passwd jskekekHTD email johndoe example com Auf Windows init_conf init passwd jskekekHTD email johndoe example com 2 Mit dem folgenden Befehl initialisieren Sie das Panel konfigurieren das Administrator Passwort P4 w0rd und die E Mail Adresse fischer example com und f r das Panel den L ndercode Deutsch Deutschland Auf Linux Unix init_conf init passwd P4 wOrd email fischer example com locale de DE Auf Windows init _conf init passwd P4 w0rd email fischer example com locale de DE Einrichten ber CLI 211 Installation des Lizenzschl ssels Um einen Panel Lizenzschl ssel ber die Panel Befehlszeilenschnittstelle CLI zu installieren sollten Sie diesen zuerst in den Computer mit dem Panel hochladen und dann mit dem 1icense Dienstprogramm installieren Befehl Um eine Lizenz zu installieren f hren Sie einen Befehl in dem folgenden Format aus license lt i
11. Hinweis Weitere Informationen zur Erstellung von Containern und zu Konfigurationsoptionen finden Sie im Referenzhandbuch Parallels Containers f r Linux verf gbar im Parallels Technology Network http www parallels com ptn documentation virtuozzo Verteilung des Panels 23 Zum Beispiel k nnen Sie mithilfe der unten aufgef hrten Befehle folgende Vorg nge durchf hren 1 erstellen Sie einen Container mit der ID 444 mit der IP 192 0 2 44 basierend auf dem Standard Betriebssystem Template das in der globalen Konfigurationsdatei von Parallels Containers definiert wurde 2 legen Sie Grenzwerte und Limits f r folgende Parameter fest nicht austauschbaren Kernel Speicher privater oder m glicherweise privater Speicher Anzahl der Dateien ge ffnet durch alle Container Prozesse Speicherplatz und die Gesamtanzahl an Disk Inodes Dateien Verzeichnisse symbolische Links fest die ein Container zuweisen kann 3 speichern Sie Grenzwerte Limits in der Konfigurationsdatei des Containers 4 aktivieren Sie die Verwaltung des Containers unter Verwendung eines Webbrowsers deaktivieren Sie die Offline Verwaltung mithilfe der Option offline management no Hinweis Es ist u erst wichtig dass Sie diese Option exakt wie im obigen Beispiel verwenden Andernfalls k nnen Sie nicht ber den Webbrowser auf das Panel zugreifen vzctl create 444 ipadd 192 0 2 44 vzctl set 444 save kmemsize 24299200 26429120 privvmpages
12. Parallels Panel Handbuch f r Entwickler Bereitstellungshandbuch Parallels Small Business Panel 10 2 Parallels Inhalt Einleitung 4 Typographische Konventionen 24uusrnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennnnnnnennnnnnnennn nn nnnn nn 4 Feedback er En nn lie 5 ber dieses Handbuch 6 Anmerkungen zum Bereitstellungsworkflow 8 Verteilung des Panels 9 Einzelplatz VErteilung er aan Hin EE TERREA 10 Release lD bfr gen 2u 2 arara raa o a aar ARANEAE UNEA iR CERE RAin 11 Liste mit den Produktkomponenten abfragen ssssssssssesssssrrsssrrssriinssirnsstinnnstinnnnrennnnnnn 12 Installieren des Panels un24400u4nnnnnannnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnannnnnnnannennnnannnnnnnen 14 Installer CLI Befehle Gek rzt 22022400nnn0nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nn 15 Installationsskript Linux Unix 22usernnnnenennnnnnnennnnnnnnnnnnnnnnnnnnnnnennnnnnnennnnnnnnnnnnnnannn nn 18 Verteilung in einer Parallels Containers Umgebung 24444440044n400nnnnnnnnnnnnnnnnnnnnnnnannnn 20 Parallels Containers f r Unix uersssessssennsnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nenn 21 Parallels Containers f r Windows ccesceceecceceeeeeeaeeeeeeeeseaeeecaaeeseaeeseeeeseaeessaeeseneeenaees 25 Einrichten eines Mirrors mit dem Dienstprogramm Rsync uuu 2444ssssnnnnnnnnnnnnnnnnnnnnn nn nnnn nn 27
13. lt aps gt lt packet gt ANTWORTPAKET lt packet version 1 6 2 0 gt lt aps gt lt install gt lt result gt 200 Einrichten ber Remote API lt status gt error lt status gt lt errcode gt 1023 lt errcode gt lt errtext gt The IP address associated with this domain is already used by another domain for SSL support implementation lt errtext gt lt result gt lt install gt lt aps gt lt packet gt Verf gbare Pakete abrufen Verwenden Sie die aps get packages list Operation um Informationen zu Anwendungspaketen abzurufen die zur Installation auf Domains Subdomains zur Verf gung stehen lt packet version 1 6 2 0 gt lt aps gt lt get packages list gt lt get packages list gt lt aps gt lt packet gt In diesem Abschnitt Struktur des Abfrage Pakets uu 4444444444HHnnnn Hanne nnnnnnnnnnnnnannnnnnnnnnnannnnnnnnnn 200 Beispiele f r Abfragen uun444444444nnnnnnnnnannnnnnnnnnnnnnnnnannnnnnnnnnnnnnnnnnnnn nenn 201 Struktur des Antwortpakets sn 202 Abfrage und Antwort Beispiele 44444444440nnnnnnnnnnnnnnnnnnnnnnnnnn nennen 204 Struktur des Abfrage Pakets Der get packages list Knoten ist wie folgt strukturiert APSPackagesListinputType ofen Filter packages to be 1 0 retrieved Einrichten ber Remote API 201 filter erforderlich Filtert die Pakete deren Informationen abgefragt wer
14. sb Append sampfile sb Append filename sb Append Path GetFileName uploadfile sb Append sb Append r n sb Append Content Type sb Append application octet stream sb Append r n sb Append r n string postHeader sb ToString byte postHeaderBytes Encoding UTF8 GetBytes postHeader Build the trailing boundary string as a byte array ensuring the boundary appears on a line by itself byte boundaryBytes Encoding ASCII GetBytes r n boundary r n FileStream fileStream new FileStream uploadfile FileMode Open FileAccess Read Einrichten ber Remote API 157 long length postHeaderBytes Length fileStream Length boundaryBytes Length request ContentLength length Stream stream request GetRequestStream stream Write postHeaderBytes 0 postHeaderBytes Length Write out the file contents byte buffer new Byte checked uint Math Min 4096 int fileStream Length int bytesRead 0 while bytesRead fileStream Read buffer 0 buffer Length 0 stream Write buffer 0 bytesRead Write out the trailing boundary stream Write boundaryBytes 0 boundaryBytes Length XmiDocument result GetResponse request return result Private interface
15. lt packet version 1 6 2 0 gt lt dns gt lt add_rec gt lt type gt CNAME lt type gt lt host gt www lt host gt lt value gt ns amp lt domain amp gt lt value gt lt add_rec gt lt dns gt lt packet gt DNS Zone erstellt auf example com Domainerstellung wird den folgenden Ressourceneintrag RR enthalten www NSns macht ns example com zum Alias f r example com MX Record Template lt packet version 1 6 2 0 gt lt dns gt lt add_rec gt lt type gt MX lt type gt lt host gt lt value gt exchange amp lt domain amp gt lt value gt lt opt gt 0 lt opt gt lt add_rec gt lt dns gt lt packet gt 110 Einrichten ber Remote API DNS Zone erstellt auf example com Domainerstellung wird den folgenden Ressourceneintrag RR enthalten example com MX 0 exchange example com macht mail example com zum wichtigsten Mailserver f r die Domain example com PTR Record Template lt packet version 1 6 2 0 gt lt dns gt lt add_rec gt lt type gt PTR lt type gt lt host gt amp lt ip amp gt lt host gt lt value gt community lt value gt lt opt gt 24 lt opt gt lt add_rec gt lt dns gt lt packet gt DNS Zone erstellt auf example com Domainerstellung gehostet auf IP 192 0 2 12 wird den folgenden Ressourceneintrag RR enthalten 192 0 2 12 24 PTR community example com macht die Domain community example com zu dem Domain Pointer f r das Subnetz 192
16. lt value gt admin lt value gt lt setting gt lt setting gt lt name gt admin_name lt name gt lt value gt admin lt value gt lt setting gt lt setting gt lt name gt admin_password lt name gt lt value gt P4 wOrd lt value gt lt setting gt lt setting gt 192 Einrichten ber Remote API lt name gt admin_email lt name gt lt value gt admin example com lt value gt lt setting gt lt setting gt lt namestitle lt name gt lt value gt Project X Blog lt value gt lt setting gt lt setting gt lt name gt blog_descr lt name gt lt value gt Project X Blog lt value gt lt setting gt lt setting gt lt name gt locale lt name gt lt value gt en US lt value gt lt setting gt lt settings gt lt install gt lt aps gt lt packet gt Das folgende Paket installiert die Anwendung LinkPoint Paket ID auf dem Server 5 auf einer Subdomain Die folgende Abfrage ist nur m glich wenn Anwendungen installiert werden die keine Datenbank erfordern und f r die es keine Einstellungen gibt lt packet version 1 6 2 0 gt lt aps gt lt install gt lt subdomain name gt subdomain example com lt subdomain name gt lt package id gt 5 lt package id gt lt install gt lt aps gt lt packet gt 193 Einrichten ber Remote API Struktur des Antwortpakets Der install Knoten des ausgegebenen XML Pakets ist wie folgt strukturiert result APSInstallOutputType
17. 362144 392912 numfile 12000 12000 diskspace 5117880 5242880 diskinodes 350000 370000 offline management no 2 Starten Sie den neu erstellten Container vzctl start lt CT_ID gt 3 Installieren Sie das Panel Template in dem Container vzpkg install lt CT_ID gt lt ppsmbe Name des Templates gt sas Beispiel Der folgende Befehl installiert sowohl die Kern und Zusatz Komponenten des Panels vzpkg install 444 ppsmbel0 ppsmbel0 extended gt So klonen Sie einen Container F hren Sie den Befehl im folgenden Format aus vzmlocal C CT List CT List lt source_CT_ID gt lt dst_CT_ID gt lt dstCT_private gt lt dstCT_root gt Sie m ssen die Quell Container ID lt source_CT_ID gt und die Ziel Container ID lt dest_CT_ID gt angeben Optional k nnen Sie den Private Area Path des Ziel Containers lt dstCT_private gt und den root Pfad lt dstCT_root gt angeben dies erm glicht Ihnen die standardm ig festgelegten Pfade vz private lt dst CT ID gt und vz root lt dst_CT_ID gt zu berschreiben Weitere Informationen zu Befehlsoptionen finden Sie im Referenzhandbuch Parallels Containers f r Linux verf gbar im Parallels Technology Network http www parallels com ptn documentation virtuozzo Beispiel So klonen Sie einen Container der mithilfe des Panels wahrend des vorigen Vorgangs erstellt wurde 24 Verteilung des Panels vzmlocal C 444 445 Verteilung des Panels 2
18. Befehl Mit dem folgenden Befehl erstellen Sie einen Domain Account domain lt create c gt lt domain name gt hosting true ip lt ip address gt login lt FTP login gt passwd lt FTP password gt wobei FTP login gt und lt FTP password gt den Login und das Passwort des FTP Accounts enthalten der zum Hochladen und zum Bearbeiten des Webcontents der auf der erstellten Domain gehosteten Website verwendet wird Beispiel Der folgende Befehl erstellt die Domain example com die auf der IP Adresse 192 0 2 33 gehostet wird mit den FTP Account Anmeldeinformationen johndoe und P4 wOrd Auf Linux Unix domain create example com hosting true ip 192 0 2 33 login johndoe passwd P4 w0rd Auf Windows domain exe create example com hosting true ip 192 0 2 33 login johndoe passwd P4 w0rd Einrichten ber CLI Erstellen von Subdomains Um einen Subdomain Account zu erstellen verwenden Sie das subdomain Dienstprogramm Erstellen von regul ren Subdomains Befehl Mit dem folgenden Befehl erstellen Sie eine Subdomain subdomain lt create c gt lt subdomain prefix gt domain lt parent domain name gt ftp_user native login lt FTP login gt passwd lt FTP password gt wobei der Teil ftp user native login lt FTP login gt passwd lt FTP password gt 223 verantwortlich ist fur das Erstellen eines neuen Subdomain spezifischen FTP Accounts im Gegensatz zu dem Standardverhalten
19. XML Abfrage Paket Die Funktion erstellt ein Abfrage Paket des Typs Request siehe oben validiert dieses versendet eine Anfrage an das Panel und gibt das resultierende XML Paket wieder Die Funktion verifiziert das Remote SSL Zertifikat um den Server zu authentifizieren Sofern der Server nicht authentifiziert werden konnte kommt false zur ck Ereignishandler bei Validierungsfehlern Die Funktion gibt das Antwortpaket PrintResult ByVal document As XmlDocument Objekt an die Konsole aus XmlDocument Die Client Anwendung kann von der Befehlszeile wie folgt gestartet werden PanelApiRpcClient 192 0 2 168 admin login admin passwd 1 6 2 0 e requests request xml Das Abfrage Paket wird in der request xm1 Datei verarbeitet lt xml version 1 0 encoding UTF 8 gt 82 Einrichten ber Remote API lt packet version 1 6 2 0 gt lt domain gt lt add gt lt gen setup gt lt name gt example com lt name gt lt ip_address gt 192 0 2 48 lt ip_address gt lt gen_setup gt lt hosting gt lt vrt_hst gt lt property gt lt name gt ftp_login lt name gt lt value gt fp 1 6se4fdf0 lt value gt lt property gt lt property gt lt name gt ftp_password lt name gt lt value gt qweqwe lt value gt lt property gt lt ip_address gt 192 0 2 48 lt ip address gt lt vrt_hst gt lt hosting gt lt add gt lt domain gt lt packet gt Das Antwortpaket das vom Server em
20. aps xsd Falls nicht angegeben wird das im Paket definierte Standardpr fix verwendet application default prefix Element in dem Paket APP META xm1 Datei database optional Beinhaltet eine Reihe an Daten die die Eigenschaften einer Datenbank beschreiben die f r die Anwendung erstellt werden sofern notwendig Datentyp APSDatabaseInputType aps xsd sehen Sie die Typdefinition unten Falls f r eine Anwendung eine Datenbank erforderlich ist und das database Element nicht in der Abfrage angegeben wurde wird diese automatisch mit dem Namen Benutzer Login und automatisch generierten Passwort erstellt Datenbankserver MySQL PostgreSQL oder Microsoft SQL Server wird automatisch ausgew hlt um besser die Anwendungsanforderungen zu erf llen 188 Einrichten ber Remote API settings optional Beinhaltet eine Auflistung mit Installationseinstellungen f r die Anwendung Datentyp APSSettingsInputType aps xsd sehen Sie die Typdefinition unten Muss vorhanden sein wenn die zu installierende Anwendung ber Einstellungen verf gt die Metadaten Datei f r das Anwendungspaket APP META xm1 beinhaltet mindestens ein Element setting Der package Knoten wird durch den Typ APS dentifierType aps xsd dargestellt und seine grafische Darstellung ist wie folgt APSldentifierType package E release vendor eee d zu nn a 1 1 Einrichten ber Remote API 189 name
21. aps gt lt packet gt Beispiel A Eine positive Antwort vom Server sieht wie folgt aus lt packet version 1 6 2 0 gt lt aps gt lt get packages list gt lt result gt lt status gt ok lt status gt lt filter id gt 1 lt filter id gt lt package gt lt name gt phpWiki lt name gt lt version gt 1 3 11 lt version gt lt release gt 44 lt release gt lt vendor gt phpwiki sourceforge net lt vendor gt lt packager gt parallels com lt packager gt lt id gt 1 lt id gt lt package gt lt result gt Einrichten ber Remote API 205 lt result gt lt status gt ok lt status gt lt filter id gt 2 lt filter id gt lt package gt lt name gt PinnacleCart lt name gt lt version gt 3 6 1 lt version gt lt release gt 570 lt release gt lt vendor gt www pinnaclecart com lt vendor gt lt packager gt www pinnaclecart com lt packager gt lt id gt 2 lt id gt lt package gt lt result gt lt get packages list gt lt aps gt lt packet gt Antwort B Folgende Antwort wird empfangen wenn keine APS Pakete auf dem Server vorhanden sind lt packet version 1 6 2 0 gt lt aps gt lt get packages list gt lt result gt lt status gt ok lt status gt lt result gt lt get packages list gt lt aps gt lt packet gt Beispiel 2 Dieses Paket ruft Informationen zu allen APS Paketen mit den IDs 12 und 13 ab lt packet version 1 6 2 0 gt lt aps gt lt get packages list gt
22. e install everything _ODER e install component Komponentel install component Komponente2 install component KomponenteN andere Optionen beinhalten die Konfigurationen von Proxy Einstellungen das Installationsprotokoll und so weiter Weitere Details finden Sie im Abschnitt Installer CLI Befehle auf Seite 15 Beispiele Linux Unix 1 Mithilfe des folgenden Befehls installieren Sie Parallels Small Business Panel 10 2 Release ID ist PPSMBE 10 2 0 ber den Mirror des Servers der ber HTTP auf dem Host ppsmbe mirror example com zur Verf gung steht Die Installationsdateien werden vor bergehend unter tmp ppsmbe gespeichert und der Statusbericht der Installation wird an die E Mail Adresse admin example com versendet Die installierten Komponenten sind die Basispakete des Panels der PostgreSQL Server und der Spamfilter von SpamAssassin T parallels_installer source http ppsmbe mirror example com target tmp ppsmbe select release id PPSMBE_10_2_0 install component base install component postgresql install component spamassassin notify email admin example com 2 Mit den folgenden Befehlen wird die Installation alle verf gbaren Produktkomponenten werden installiert von Parallels Small Business Panel 10 2 Release ID PPSMBE 10 2_0 ber den Parallels Update Server abgeschlossen Eine Ausgabedatei des Installers wird im XML Format erstellt Verteilung des
23. erforderlich Gibt den Namen des Anwendungspakets an Datentyp string version optional Gibt die Version der Anwendung an Datentyp string release optional Gibt die Paket Release an Datentyp string vendor optional Beinhaltet Informationen ber den Anbieter der Anwendung Datentyp string packager optional Gibt den Namen des Packagers Verpacker des Anwendungspakets an Datentyp string Das Paket muss in einer gek rzten oder erweiterten Form angegeben werden reduced beinhaltet nur den Namen der Anwendung und die aktuellste Version und Release die installiert wurde extended beinhaltet alle Paketdetails Name Version Release Anbieter und Packager Verpacker Der database Knoten wird durch den Typ APSDatabaselnputType aps xsd dargestellt und die grafische Darstellung ist wie folgt APSDatabaselnputTyp D 190 Einrichten ber Remote API name erforderlich Gibt den Namen der Datenbank an Sollte in dem System eindeutig sein Datentyp string login erforderlich Gibt den Login Namen des Datenbankbenutzers an Sollte in dem System eindeutig sein Datentyp string password erforderlich Gibt das Passwort des Datenbankbenutzers an Datentyp string Der settings Knoten wird durch den Typ APSSettingsInputType aps xsd dargestellt und seine grafische Darstellung ist wie folgt APSSettingsinputType r APSSettingInputType Senos DCE BET i settings E H setting
24. if curl_errno ch echo n n n cURL error number curl_errno ch echo n ncURL error curl_error ch curl_close ch fclose fp return uploadFile realpath FILENAME gt Einrichten ber Remote API 155 Dateien mit NET hochladen Diese NET Quellcode l dt Dateien auf das Panel hoch Ersetzen Sie die Werte der Variablen Hostname Login Password und Protocol durch die Parameter der Panel Instanz Ver ndern Sie den Wert der Variablen Filename in den vollst ndigen Namen der Datei die hochgeladen werden soll Filename Vollst ndiger Name der Datei die hochgeladen werden soll Hostname Die IP Adresse oder der Name des vom Panel verwalteten Servers Login Login Name des Panel Administrators Password Passwort des Panel Administrators Protocol Version des API RPC Protokolls using System using System Net using System Text using System IO using System Xml using System Xml Schema using System Security Cryptography X509Certificates using System Net Security namespace ConsoleApplication1 public class Request Public interface public string Filename tmp myfile sh Upload file name public string Hostname localhost The Panel s host name public string Login admin Administrator Login public string Password setup Administrator Password PUbIRIC HS i
25. install Backup Manager f r die PVC Neuinstallation install Sprachpaket f r Deutsch install Sprachpaket f r Japanisch install Sprachpaket f r Spanisch install Sprachpaket f r Russisch install Sprachpaket f r Franz sisch install Sprachpaket f r Italienisch install Sprachpaket f r Chinesisch China install Sprachpaket f r Chinesisch Taiwan install Sprachpaket f r Niederl ndisch Verteilung des Panels 13 atmail install Atmail Webmail Unterst tzung 14 Verteilung des Panels Installieren des Panels Um Parallels Small Business Panel zu installieren f hren Sie den folgenden Befehl im folgenden Format aus parallels_installer lt Quell Optionen f r Pakete gt select release id lt ID gt lt Installationsoptionen f r Komponenten gt andere Optionen wobei Quell Optionen f r Pakete geben Sie den Ort an wo das Installationsprogramm die Panel Pakete f r die Installation finden kann lt Quell Optionen f r Pakete gt source lt URL gt alls Sie einen Mirror des Panel Update Servers verwenden _ODER source lt Pfad gt alls Sie ein lokales Dateisystem verwenden _ODER Keine falls Sie die Installation ber den Panel Update Server durchf hren Installationsoptionen auf Seite 12 f r Komponenten definiert welche Panel Komponenten installiert werden sollen lt Installationsoptionen f r Komponenten gt
26. lt del_rec gt lt dns gt lt packet gt ANTWORTPAKET lt packet version 1 6 2 0 gt lt dns gt lt del _rec gt lt result gt lt status gt error lt status gt lt errcode gt 1013 lt errcode gt lt errtext gt DNS record does not exist lt errtext gt lt id gt 1 lt id gt lt result gt lt result gt lt status gt error lt status gt lt errcode gt 1013 lt errcode gt lt errtext gt DNS record does not exist lt errtext gt lt id gt 2 lt id gt lt result gt lt result gt lt status gt error lt status gt lt errcode gt 1013 lt errcode gt lt errtext gt DNS record does not exist lt errtext gt lt id gt 3 lt id gt 127 128 Einrichten ber Remote API lt result gt lt result gt lt status gt error lt status gt lt errcode gt 1013 lt errcode gt lt errtext gt DNS record does not exist lt errtext gt lt id gt 4 lt id gt lt result gt lt result gt lt status gt error lt status gt lt errcode gt 1013 lt errcode gt lt errtext gt DNS record does not exist lt errtext gt lt id gt 5 lt id gt lt result gt lt del_rec gt lt dns gt lt packet gt Installation von SSL Zertifikaten Um ein SSL Zertifikat zu installieren erstellen Sie ein XML Abfrage Paket mit dem certificate install Kontrollknoten lt packet version 1 6 2 0 gt lt certificate gt lt install gt FERTIGEN lt certificate gt lt packet gt In die
27. lt add _rec gt lt add_rec gt lt dns gt 108 Einrichten ber Remote API Beispiele f r Abfragen NS Record Template lt packet version 1 6 2 0 gt lt dns gt lt add _rec gt lt type gt NS lt type gt lt host gt lt value gt ns amp lt domain amp gt lt value gt lt add_rec gt lt dns gt lt packet gt DNS Zone erstellt auf example com Domainerstellung wird den folgenden Ressourceneintrag RR enthalten example com NS ns example com macht ns example com zum Nameserver des Hosts example com Das Abfrage Paket f gt zu dem DNS Zonen Template einen Eintrag hinzu der provider dns server example com zu einem Nameserver f r eine Domain macht lt packet version 1 6 2 0 gt lt dns gt lt add_rec gt lt type gt NS lt type gt lt host gt lt value gt provider dns server example com lt value gt lt add_rec gt lt dns gt lt packet gt Ein Record Template lt packet version 1 6 2 0 gt lt dns gt lt add_rec gt lt type gt A lt type gt lt host gt mail lt host gt Einrichten ber Remote API 109 lt value gt amp lt ip amp gt lt value gt lt add_rec gt lt dns gt lt packet gt DNS Zone erstellt auf example com Domainerstellung gehostet auf IP 192 0 2 12 wird den folgenden Ressourceneintrag RR enthalten mail example com A 192 0 2 12 definiert die IP Adresse 192 0 2 12 f r den Host mail example com CNAME Record Template
28. lt domain gt festlegt canonica lt domain name gt Gibt einen kanonischen server dns a cname www 1 lt subdomain_ Namen oder einen canonical ns lt domain gt name gt lt domai Platzhalter zur Erstellung n gt eines CNAME Record Templates an PTR Record Parameter und Beispiel lt subdomain_na Gibt den Namen des Hosts So f gen Sie einen neuen an f r den die PTR Eintrag hinzu der lt domain gt Eintragseinstellungen zu dem Domain Name Pointer f r bernommen werden 217 Gibt eine IP Adresse und eine Subnetzmaske oder einen Platzhalter zur Erstellung eines das Subnetz lt ip gt 16 macht server dns a ptr subnet lt ip gt 16 subnet lt IP_address gt lt subnet_mask gt lt ip gt lt subn et_mask gt SRV Record Parameter und Beispiel PTR Record Templates an Gibt den Namen des Hosts an f r den die Record Einstellungen Srv lt subdomai n name gt bernommen werden 0 50 Gibt die Priorit t des SRV Records 0 h chste Priorit t 50 die niedrigste srv prio rity srv weig 0 50 Gibt das relative Gewicht des ht SRV Records unter den Records mit derselben Priorit t an 0 niedrigste 50 h chste srv port 0 65535 Gibt den Port an auf dem der Service zur Verf gung gestellt wird srv targ lt host gt Gibt den kanonischen Hostnamen der Maschine an die den Service bereitstellt So f gen
29. lt filter gt lt package id gt 12 lt package id gt 206 Einrichten ber Remote API lt package id gt 13 lt package id gt lt filter gt lt get packages list gt lt aps gt lt packet gt Folgende negative Antwort wird empfangen falls das Paket mit der angeforderten ID nicht existiert lt packet version 1 6 2 0 gt lt aps gt lt get packages list gt lt result gt lt status gt error lt status gt lt errcode gt 1013 lt errcode gt lt errtext gt Package does not exist lt errtext gt lt filter id gt 12 lt filter id gt lt result gt lt result gt lt status gt error lt status gt lt errcode gt 1013 lt errcode gt lt errtext gt Package does not exist lt errtext gt lt filter id gt 13 lt filter id gt lt result gt lt get packages list gt lt aps gt lt packet gt KAPITEL 6 Einrichten uber CLI Dieses Kapitel konzentriert sich auf das Einrichten des Panels Uber die Befehlszeilenschnittstelle des Panels Abk CLI Command Line Interface Der Abschnitt ber die Panel Befehlszeilenschnittstelle CLI auf Seite 208 gibt einen Einblick in die CLI Basics Der Abschnitt Einrichten des Panels auf Seite 209 beschreibt im Detail welche Befehle ausgef hrt werden sollten um die Panel Setup Operationen durchzuf hren In diesem Kapitel ber die Panel Befehlszeilenschnittstelle CLI uuueneennnn 208 Einrichten des Panels rassi eek nn en re ee Re 209 208 Einr
30. lt host gt lt value gt provider dns server example com lt value gt lt add_rec gt lt add_rec gt 112 Einrichten ber Remote API lt type gt A lt type gt lt host gt mail lt host gt lt value gt amp lt ip amp gt lt value gt lt add_rec gt lt add_rec gt lt type gt CNAME lt type gt lt host gt www lt host gt lt value gt ns amp lt domain amp gt lt value gt lt add_rec gt lt add rec gt lt type gt MX lt type gt lt host gt lt value gt exchange amp lt domain amp gt lt value gt lt opt gt 0 lt opt gt lt add_rec gt lt add_rec gt lt type gt PTR lt type gt lt host gt amp lt ip amp gt lt host gt lt value gt community lt value gt lt opt gt 24 lt opt gt lt add_rec gt lt add_rec gt lt type gt TXT lt type gt lt host gt about lt host gt lt value gt Delivered by the best provider lt value gt lt add_rec gt lt add_rec gt lt type gt SRV lt type gt lt host gt _LDAP _tcp lt host gt lt value gt 192 0 2 4 lt value gt lt opt gt 5 25 220 lt opt gt lt add_rec gt lt dns gt lt packet gt Einrichten ber Remote API 113 Struktur des Antwortpakets Der add_rec Knoten des ausgegebenen XML Pakets ist wie folgt strukturiert result erforderlich Verpackt die vom Server abgerufene Antwort Datentyp resultType common xsd status erforderlich Gibt den Ausf hrungsstatus der Operation an Daten
31. module parser receiver Pucynok 3 Struktur von clientseitigen Anwendungen Die Abbildung zeigt wie eine Client Anwendung strukturiert werden kann und wie diese Struktur die Datenverarbeitung beeinflusst Jedes Modul dieser Beispiel Anwendung ist f r einen bestimmten Task verantwortlich d h 1 Der XML Paket Generator akzeptiert den Befehl von der Anwendungs GUI oder eines Drittanbieter Moduls Der XML Paket Generator enth lt einen Command to XML Konverter f r jeden bekannten Befehl Das Format des resultierenden XML Pakets stimmt mit der API RPC Version berein die von der Client Anwendung unterst tzt wird Der HTTP Paket Sender empf ngt das XML Paket Das Paket enth lt keine Informationen ber den Zielserver und die Zugangsdaten das HTTP Paket sollte daher diese Einstellungen speichern oder sollte diese On demand erhalten Der HTTP Paket Sender erstellt einen HTTP Header mit den Anmeldeinformationen des Panel Benutzers und sendet das Paket an den Panel API RPC Server via API RPC Protokoll Der HTTP Paket Empf nger erh lt das resultierende HTTP Paket von der Serverseite entfernt den HTTP Header und gibt die reine XML Antwort an den XML Paket Parser weiter Der XML Paket Parser analysiert den Ausf hrungsstatus in dem XML Antwortpaket und erstellt eine entsprechende Fehlernachricht falls die Antwort negativ ist Es sendet anschlie end die extrahierten und verarbeiteten Daten an die GUI oder an das anfragende Modul z
32. una ee RE 125 122 Einrichten ber Remote API Struktur des Abfrage Pakets Ein XML Abfrage Paket ber das ein DNS Eintrag gel scht wird beinhaltet den del_rec Kontrollknoten der wie folgt strukturiert ist dnsSelectionFilter Type del_rec template filter erforderlich Gibt die Filterregel an Datentyp dnsSelectionFilterType Ans _input xsd Falls dieses Feld lt filter gt leer ist werden alle Record Templates gel scht id optional Gibt die ID des Templates f r den Ressourceneintrag an das gel scht werden soll Datentyp id_type common xsd template erforderlich Gibt die zu l schenden Record Templates an Datentyp none Einrichten ber Remote API 123 Beispiele f r Abfragen Dieses Abfrage Paket l scht aus dem DNS Zonen Template den Eintrag mit der ID 7 lt packet version 1 6 2 0 gt lt dns gt lt del _rec gt lt filter gt lt id gt 7 lt id gt lt filter gt lt template gt lt del_rec gt lt dns gt lt packet gt Dieses Abfrage Paket l scht aus dem DNS Zonen Template die Eintr ge mit der ID 1 5 lt packet version 1 6 2 0 gt lt dns gt lt del_rec gt lt filter gt lt id gt 1 lt id gt lt id gt 2 lt id gt lt id gt 3 lt id gt lt id gt 4 lt id gt lt id gt 5 lt id gt lt filter gt lt template gt lt del_rec gt lt dns gt lt packet gt Dieses Paket entfernt alle Eintr ge aus dem DNS Zonen Template lt packet v
33. 0 2 12 24 TXT Record Template lt packet version 1 6 2 0 gt lt dns gt lt add_rec gt lt type gt TXT lt type gt lt host gt about lt host gt lt value gt Delivered by the best provider lt value gt lt add_rec gt lt dns gt lt packet gt DNS Zone erstellt auf example com Domainerstellung wird den folgenden Ressourceneintrag RR enthalten about TXT Delivered by the best provider Einrichten ber Remote API 111 f gt eine Textbeschreibung Delivered by the best provider zu der Domain about example com hinzu SRV Record Template lt packet version 1 6 2 0 gt lt dns gt lt add_rec gt lt type gt SRV lt type gt lt host gt _LDAP _tcp lt host gt lt value gt 192 0 2 4 lt value gt lt opt gt 5 25 220 lt opt gt lt add_rec gt lt dns gt lt packet gt DNS Zone erstellt auf example com Domainerstellung wird den folgenden Ressourceneintrag RR enthalten _LDAP tcp SRV 525 220 192 0 2 4 bringt einen Client des LDAP Dienstes dazu auf der Domain example com eine SRV Suche von 192 0 2 4 durchzuf hren Mehrere Eintr ge Records hinzuf gen Das folgende Abfrage Paket f gt alle Eintr ge aus den obigen Beispielen auf einmal hinzu lt packet version 1 6 2 0 gt lt dns gt lt add_rec gt lt type gt NS lt type gt lt host gt lt value gt ns amp lt domain amp gt lt value gt lt add_rec gt lt add_rec gt lt type gt NS lt type gt
34. 209 Einrichten des Panels Der Abschnitt beschreibt im Detail welche Befehle ausgef hrt werden sollten um die Panel Setup Operationen durchzuf hren In diesem Abschnitt Initialisierung des PanelSs 22444000044444nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 210 Installation des Lizenzschl ssels 222000022 22 eneennnnnnnennnnnneennnnnnnennnnnneen 211 Branding GOS FANGS ds coat Oo dats seen eek 211 BNS K hliguralionzsenseah a a ar uber 213 Installation von SSL Zertifikaten uu nuuusnnnenennanennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 220 Erstellen von Domains usnuuuusnsensnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn anne 222 Erstellen von Subdomains uu220u0 0nunnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn anne 223 Verf gbare APS Kataloge definieren u44444444nnnnnnnnnnnnnnnnnnnnannnnnnnnn 224 Installieren von Anwendungen uss44444444nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nennen 225 210 Einrichten ber CLI Initialisierung des Panels Um das Panel ber die Befehlszeilenschnittstelle CLI zu initialisieren verwenden Sie bitte das Dienstprogramm init conf Befehl Der folgende Befehl initialisiert das Panel init_conf init email lt email gt passwd lt password gt locale lt locale code gt Der lt locale code gt folgt dem RFC 1766 Standard in dem Format lt languagecode2 gt lt country regioncode2 gt
35. Abfrage Paket mit dem aps import package Kontrollknoten lt packet version 1 6 2 0 gt lt aps gt lt import package gt lt import package gt lt aps gt lt packet gt In diesem Abschnitt Struktur des Abirage Pakels a uncs cn 163 Beispiele f r Abfragen es len 164 Struktur des Antwortpakets u 165 Antwort Beispiele u u n nennen 166 Struktur des Abfrage Pakets Ein XML Abfrage Paket f r den Import von APS Paketen in das Panel enth lt den import package Kontrollknoten und ist wie folgt strukturiert I APSPackagelmportinputType import package I ess F filename filename erforderlich Gibt den Namen des Konfigurationspakets an die auf den Server hochgeladen wird Datentyp string Der Wert sollte dem Namen der tempor ren Datei entsprechen die in der upload Antwort siehe Seite 160 indem upload result file Element wiedergegeben wird 164 Einrichten ber Remote API Beispiele f r Abfragen Abfrage Pakete die Konfigurationsdateien von APS Paketen in das Panel importieren die zuvor auf den Server hochgeladen wurden sehen wie folgt aus Auf Linux Unix lt packet version 1 6 2 0 gt lt aps gt lt import package gt lt filename gt usr local psa tmp li 8FZruf lt filename gt lt import package gt lt aps gt lt packet gt Auf Windows lt packet version 1 6 2 0 gt lt aps gt lt import package gt lt filename gt C
36. Ablaufen Expire und Minimum werden unver ndert beibehalten lt packet version 1 6 2 0 gt lt dns gt lt set gt lt soa gt lt ttl gt 115200 lt ttl gt lt refresh gt 21600 lt refresh gt lt retry gt 900 lt retry gt lt soa gt lt set gt lt dns gt lt packet gt 104 Einrichten ber Remote API Struktur des Antwortpakets Der set Knoten des ausgegebenen XML Pakets ist wie folgt strukturiert result erforderlich resultType extension Ferrtext y Verpackt die vom Server abgerufene Antwort Datentyp resultType common xsd status erforderlich Gibt den Ausf hrungsstatus der Operation an Datentyp string Zul ssige Werte ok error errcode erforderlich falls die Operation fehlschl gt Gibt den Fehlercode wieder Datentyp integer errtext erforderlich falls die Operation fehlschl gt Gibt die Fehlermeldung wieder Datentyp string Einrichten ber Remote API 105 Antwort Beispiele Eine positive Antwort vom Server sieht wie folgt aus lt packet version 1 6 2 0 gt lt dns gt lt set gt lt result gt lt status gt ok lt status gt lt result gt lt set gt lt dns gt lt packet gt Die folgende negative Antwort wird empfangen falls ein Wert viel zu gro ist ABFRAGE PAKET lt packet version 1 6 2 0 gt lt dns gt lt set gt lt soa gt lt refresh gt 4320000000 lt refresh gt lt soa gt l
37. Class End Namespace e Message ByVal document As XmlDocument 88 Einrichten ber Remote API Einrichten ber Remote API 89 Einrichten des Panels Dieser Abschnitt erkl rt ausf hrlich wie jeder Setup Vorgang des Panels ber die Remot API durchgef hrt wird In diesem Abschnitt Initialisierung des Panels 2 44000004444nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nennen 89 Installation des Lizenzschl ssels sss022222222000eeesnnnnnnnnnnnnnenennnnnnnnnnnnnnnn 94 DNS Konfig rati ON ee ar ee era ee 100 Installation von SSL Zertifikaten uuusssssassssnnnnnnneesnnnnnnnnnnnnnnnennnnnnnnnnnnnnnn 128 Erstellen von DomM ins en a kaekln kaum 135 Erstellen von Subdomains u 222220002222nnnennnnnnnennnnnnnennnnnnnennnnnnn nennen 141 Verf gbare APS Kataloge definieren uuuuunn4444nnnnnnnnnnnnnnnnennnnnnnnennnnnnnnn 146 Installieren von Anwendungen uss444444444nnnnnnnnnnnnnnnnnnnnnnnnnnannnnnnnnnnnnnn 150 Initialisierung des Panels Um das Panel per API RPC zu initialisieren f hren Sie das XML Abfrage Paket mit dem smbiinitial_setup Kontrollknoten aus lt packet version 1 6 2 0 gt lt smb gt lt initial_setup gt lt initial_setup gt lt smb gt lt packet gt In diesem Abschnitt Struktur des Abfrage Pakets 44444444440RRnnnnnnnnnnnnnnnnnnnnannnnnnnnnnnnnnnnnnnnnn 90 Beispiele f
38. Dateien mit NET hochladen u nuuuunnenennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn anne anne 155 Struktur des Antwortpakets u nen een 160 Antwort Beispiele nennen anna 161 Dateien mit CURL hochladen Um eine Datei hochzuladen befolgen Sie bitte die folgenden Schritte 1 Erstellen Sie eine SSH_Verbindung zu dem Unix Server auf dem sich die Datei befindet 2 Geben Sie den folgenden String in die Unix Shell ein curl k F myfile install log H HTTP_AUTH_LOGIN admin H HTTP_AUTH_PASSWD password https panel ip 8443 enterprise control agent php Argumente curl Legt fest dass cURL http curl haxx se verwendet wird Sie m ssen diesen Client auf den Unix Maschine installieren k Die SSL Verbindung wird verwendet F myfile install log Die Datei install log soll hochgeladen werden Sie k nnen mehrere Dateien in einem einzigen Paket hochladen H HTTP_AUTH_LOGIN admin Gibt den Login des Panel Administrators an Ersetzen Sie den Admin Wert durch Ihren Panel Login 152 Einrichten ber Remote API H HTTP_AUTH_PASSWD password Gibt das Passwort des Panel Administrators an Ersetzen sied en Passwort Wert durch Ihre Passwort f r den Zugang zum Panel https panel ip 8443 enterprise control agent php Gibt die Adresse des Panel Servers an Ersetzen Sie den Wert lt panel ip gt durch die IP Adresse des Servers 3 Dr cken Sie die EINGABETASTE Einrichten ber Remote API 153 Date
39. Identifier des DNS Eintrags Datentyp integer data erforderlich falls die Operation erfolgreich abgeschlossen wird Beinhaltet eine Reihe von Ressourceneintragsdaten type erforderlich Gibt den Typ des DNS Eintrags an Datentyp string Zul ssige Werte A NS CNAME MX PTR TXT SOA AXFR SRV host erforderlich Gibt den Namen des Hosts an der vom DNS verwendet wird Datentyp string value erforderlich Gibt den Wert an der mit dem Wert host verkn pft wird Datentyp string Der Wert enth lt die Platzhalter lt domain gt oder lt ip gt die durch echte IP Adressen Hostnamen ersetzt werden wenn eine DNS Zone nach der Erstellung der Domain erstellt wird opt optional Beinhaltet optionale Informationen ber den DNS Eintrag Datentyp string 118 Einrichten ber Remote API Antwort Beispiele Die folgende Antwort wird empfangen falls das DNS Zonen Template keinen einzigen Ressourceneintrag enth lt ABFRAGE PAKET lt packet version 1 6 2 0 gt lt dns gt lt get_rec gt lt filter gt lt template gt lt get_rec gt lt dns gt lt packet gt ANTWORTPAKET lt packet version 1 6 2 0 gt lt dns gt lt get_rec gt lt dns gt lt packet gt Die folgende Antwort enth lt eine Beschreibung des Standard DNS Zonen Templates des Panels ABFRAGE PAKET lt packet version 1 6 2 0 gt lt dns gt lt get_rec gt lt filter gt lt template gt lt get_rec
40. Installer Konfigurationsdatei welche die Panel Produkte beschreibt ppsmbe inf3 Parallels Installer Konfigurationsdateien die unterschiedliche Versionen des Panels und weitere Komponenten beschreiben gt So erstellen Sie einen Mirror f r das Panel 1 Melden Sie sich an dem Server an auf dem der Mirror eingerichtet werden soll 2 Erstellen Sie ein Verzeichnis in dem die Dateien abgelegt werden sollen Zur Veranschaulichung nennen wir dieses Verzeichnis destination directory 3 F hren Sie die folgenden Befehle aus um einen Mirror einzurichten Mit diesem Befehl k nnen Sie das Verzeichnis PPSMBE WIN 10 2 0 aus dem Parallels Updates Repository in das Verzeichnis destination directory herunterladen rsync au delete rsync rsync autoinstall win parallels com autoinstall PPSMBE WIN _10 2 0 destination directory Mithilfe diesen Befehls k nnen Sie die Parallels Installer Konfigurationsdateien herunterladen 32 Verteilung des Panels rsync auv delete rsync rsync autoinstall win parallels com autoinstall products inf3 autoinstall ppsmbe inf3 destination_directory 4 Bearbeiten Sie die Parallels Installer Konfigurationsdateien um festzulegen welche Produkte Versionen und Plattformen vom Mirror unterst tzt werden sollen a Bearbeiten Sie die Datei products inf3 und entfernen Sie alle product Elemente bis auf die mit der ID ppsmbe Lassen Sie auch das product Element mit de
41. Katalog die in der Abfrage angegeben wird nicht in der Konfigurationsdatei des APS Katalogs auf Seite 146 aufgelistet wird Es trifft auch auf die F lle zu in denen die URL in der Abfrage sich von der URL in der Konfigurationsdatei in kleinen Details unterscheidet Zum Beispiel Der URL fehlt der nachgestellte Schr gstrich der aber in der Konfiguration des APS Katalogs angegeben wurde lt packet version 1 6 2 0 gt lt aps gt lt download package gt lt result gt lt status gt error lt status gt lt errcode gt 1013 lt errcode gt lt errtext gt Catalog with URL http apscatalog com does not exist lt errtext gt lt result gt lt download package gt lt aps gt lt packet gt Folgende negative Antwort wird empfangen wenn die URL des APS Katalogs nicht aufgel st werden kann lt packet version 1 6 2 0 gt lt aps gt Einrichten ber Remote API 173 lt download package gt lt result gt lt status gt error lt status gt lt errcode gt 1023 lt errcode gt lt errtext gt Could not resolve host apscatalog co No data record of requested type lt errtext gt lt result gt lt download package gt lt aps gt lt packet gt Folgende negative Antwort wird empfangen wenn die Konfigurationsdatei des APS Katalogs auf Seite 146 ein ung ltiges Format aufweist lt packet version 1 6 2 0 gt lt aps gt lt download package gt lt result gt lt status gt error lt status
42. Kataloge werden dem Panel Benutzer auf dem Bildschirm Applikationen amp Skripte angezeigt und Benutzer k nnen die Anwendungen selbst installieren APS Katalog ist der allgemeine Name des Dienstes der auf folgende Weise angegeben werden kann APS Katalog unter apscatalog com http apscatalog com Offizieller APS Katalog der von Parallels unterst tzt wird Hinweis Es ist wichtig dass apscatalog com in der Konfiguration angegeben wird wenn Websites mit APS Anwendungen zu dem Panel Backup Restore migriert werden Benutzerdefinierter APS Katalog ein lokaler Mirror des Dienstes der innerhalb der Hostingumgebung bereitgestellt wurde und Zugang zu bestimmten Anwendungen bietet Weitere Informationen dar ber wie Sie einen lokalen Mirror eines APS Katalogs implementieren finden Sie in der Dokumentation zum APS Standard Diese Dokumentation k nnen Sie sich ber die offizielle Website http www apsstandard org providers documentation herunterladen In den folgenden F llen sollten Sie verf gbare APS Kataloge definieren a Bei der Bereitstellung des Panels k nnen Sie Anwendungen von Ihrem benutzerdefinierten APS Katalog aus installieren F gen Sie in diesem Fall einen Eintrag f r Ihren Katalog zu der Konfigurationsdatei hinzu b Sie wollen dass Panel Benutzer nur auf Ihren benutzerdefinierten APS Katalog zugreifen oder parallel zu denen die vom Panel standardm ig bereitgestellt werden In diesem Fall k nnen Sie
43. L EE setting erforderlich Beinhaltet eine Definition von Anwendungseinstellungen Datentyp APSSettingInputType aps xsd Informationen zu den Namen von Anwendungseinstellungen und m gliche Werte sollten von der Metadaten Datei des Anwendungspakets angefragt werden APP META xml die setting Elemente Die Abfrage muss das setting Element f r jede Anwendungseinstellung enthalten ohne den Standardwert in der Metadaten Datei des Anwendungspakets name erforderlich Gibt die Einstellungs ID an Sollte der Einstellungs ID in APP META xml setting id entsprechen Datentyp string value erforderlich Gibt den Einstellungs Wert an Datentyp string Einrichten ber Remote API 191 Beispiele f r Abfragen Das folgende Paket installiert die Anwendung Serendipity auf der Domain example com mit allen erforderlichen Parametern lt packet version 1 6 2 0 gt lt aps gt lt install gt lt domain name gt example com lt domain name gt lt package gt lt name gt serendipity lt name gt lt version gt 1 1 2 lt version gt lt release gt 33 lt release gt lt vendor gt s9y org lt vendor gt lt packager gt parallels com lt packager gt lt package gt lt database gt lt name gt s9DB lt name gt lt login gt s9user lt login gt lt password gt s9password lt password gt lt database gt lt settings gt lt setting gt lt name gt admin_p_name lt name gt
44. Mirrors von Linux Unix Distributionen erstellen 44044244400nnnnnnnennennnnennennnnennnnnnnn 28 Mirrors von Windows Distributionen erstellen 24404444440n ne nnnnennennnnennnnnnnennennnnn 31 berblick zu Setupvorg ngen 33 Initialisierung des Panels z0ssrn44004nnnnnnnennnnnnnnnnnnnenennnnnnnnnnnnn neuen onen TE nenn 34 Installation des Lizenzschl ssels 444444444404HHnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nn nnn nn 35 Branding des Paneis ernai soana 24 2 ea gr Banned 36 Anpassen von Service Links uurss0unsssennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnsnnnnnnnnnnnnnnnnnnnnnn 36 BNS KORNgUrAlOn ns rennen rear 40 Andern des SOA Record Templates 2444s44snnnonnnnnnnnnnnnnnnnnnnnnnnnn namens nn 41 Einrichten von Templates f r Ressourceneintrage Resource Records 41 Installation von SSL Zertifikaten uursssrsnsnnnnennnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 42 Erstellen von Domains und Subdomains 2 us440rsnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 43 Installieren von Anwendungen nuusessnnneessnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nn nnn nn 45 Importieren eines Anwendungspakets 244ssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennnnnnnennnnnnnennnnnn 46 Installieren einer Anwendung 4usersnneeennnnnnnnnnnnnnnnnnnn
45. Paketk rpers ist der en smb Operator lt status gt ok lt status gt ee Die eingeschachtelten Zeilen weisen darauf hin dass lt initial_ setup gt lt smb gt die Panel Initialisierung erfolgreich war lt packet gt Der abschlie ende Tag des Pakets 56 Einrichten ber Remote API Validierung von Paketen Der Panel API RPC Server besteht aus einer Reihe von Agents oder Operatoren die vom Agent Engine verwaltet werden Jeder Agent ist ein logischer Block der f r die Verarbeitung einer bestimmten Befehlsgruppe verantwortlich ist und der Agent Engine dient als Paketverteiler Desweiteren wird der Agent Engine mit verschiedenen Sets von XML Schemadateien assoziiert Jedes Set berichtet an eine bestimmte API RPC Version Ein Einsprungspunkt zu jeder Version ist die agent_input xsd Datei die alle Eingangsschemata derselben Version referenziert Der Panel API RPC Server funktioniert wie folgt Zuerst berichtet das reine XML Paket ohne HTTP Header an den Agent Engine Der Agent Engine ruft die AP RPC Version von dem Paket Header ab w hlt das entsprechende Set an XML Schmata aus und wechselt in das richtige agent_input xsd Schema Dieses Schema validiert das Operator Level des Pakets nachdem jeder Operator Abschnitt des Pakets mit dem passenden Folgeschema validiert wurde APIRPC server Agent Engine validates the agent_input xsd input agent_input xsd incoming XML packet using t
46. Registrierungsdienste f r Domain Namen an Sie verkaufen CA Zertifikate Sie k nnen die Links anpassen indem Sie die Konfigurationsdatei des Panels smb ini entsprechend bearbeiten Sobald die erforderliche Anpassung in der Konfigurationsdatei vorgenommen wurde kann sie auf eine beliebige Anzahl von Panel Instanzen hochgeladen werden und so die standardm ig voreingestellte Konfiguration ersetzen Hierzu sind keine besonderen Mittel notwendig bitte verwenden Sie daher die Standardbefehle Die Konfigurationsdatei des Panels Speicherort Auf Linux Unix SPRODUCT_ROOT admin smb application config smb ini Auf Windows plesk dir admin smb application config smb ini plesk_dir ist eine Umgebungsvariable die das Panel Installationsverzeichnis angibt Konfiguration von Service Links marketplace panelAndAddonsLicensesStore http example com panel store url http example com marketplace shop userpacksUrl http example com panel userpacks buySslCertificatesUrl http example com certificates registerDomainsUrl http example com certificates Standardm ig beinhaltet die Konfigurationsdatei diesen Abschnitt nicht daher m ssen Sie manuell den Abschnittstitel hinzuf gen marketplace und die folgenden Strings je nachdem welche Funktionen angepasst werden soll falls die URL des Online Shops ge ndert werden soll ber den das Panel und die
47. Sho p Benutzer gt Benutzer Accounts der Link Parallels Zus tzliches Benutzerpaket kaufen Marketplace Sho Assistent Erste Schritte gt Benutzer der P Link Zus tzliches Benutzerpaket kaufen E Mail gt E Mail Adressen der Link Zus tzliches Benutzerpaket kaufen Einstellungen gt Verwaltung von Lizenzschl sseln der Link Marketplace besuchen und Benutzerpakete kaufen Einstellungen gt SSL Zertifikate gt SSL Zertifikate myplesk com hinzuf gen der Button SSL Zertifikate kaufen Websites amp Domains der Button myplesk com Domain Namen registrieren 38 berblick zu Setupvorg ngen Hinweis Bitte beachten Sie den Unterschied Marketplace Application Catalog ist ein Service der eine detaillierte Liste mit den verf gbaren Anwendungen bereitstellt Der Marketplace Online Shop for Applications ist ein Service ber den Lizenzen f r diese Anwendungen verkauft werden Die URLs von Anwendungskatalogen inkl Application Marketplace k nnen individuell angepasst werden siehe hierzu auch den Abschnitt Verf gbare APS Kataloge definieren auf Seite 47 In den folgenden F llen sollten Sie die URLs ver ndern die sich beim Anklicken ffnen Sie verkaufen als Parallels Partner Lizenzen f r das Panel und die Add ons Sie verkaufen als Parallels Partner Benutzerpakete f r das Panel Sie verkaufen als Parallels Partner Lizenzen f r Anwendungen die ber das Marketplace erh ltlich sind Sie bieten
48. Sie einen SRV Record f r lt domain gt zum DNS Zonen Template hinzu der SIP Protokoll Verbindungen verarbeitet die auf den Server sipserver sample com verweisen am TCP Port 5060 Die Priorit t hier ist O und das Gewicht ist 5 server dns add srv srv service sip srv target host sipserver sample com srv protocol TCP srv port 5060 srv priority 0 srv weight 5 et host srv prot TCP UDP Gibt den Serviceprotokoll an ocol srv serv lt service gt Gibt den symbolischen Namen ice des Services an TXT Record Parameter und Beispiel Gibt eine Textbeschreibung an Um den DNS Record im TXT Typ 218 Einrichten ber CLI domain lt subdomain_ Gibt den Namen des Hosts an anzugeben geben Sie folgendes name gt f r den die This record is used to implement Eintragseinstellungen the Senders Policy Framework bernommen werden and DomainKeys specifications f r den Host policy lt domain gt an server dns a txt This record is used to implement the Senders Policy Framework and DomainKeys specifications domain policy Records im DNS Zonen Template berschreiben Um ein DNS Zonen Template zu berschreiben verwenden Sie den Befehl im folgenden Format server_dns lt set s gt lt record_1 gt lt record_2 gt lt record_N gt wobei das lt record gt Format ist lt type gt lt host gt lt value gt lt option gt Das hei t das lt r
49. SresponseXml gt xpath packet domain get result as SresultNode echo Domain id string resultNode gt id N echo string resultNode gt data gt gen info gt name string resultNode gt data gt gen info gt dns ip address NND Nu Nu 2 gt C Client Anwendung Die folgenden Code Beispiele stellen eine einsatzbereite Client Anwendung dar die in C geschrieben wurde Kommentare Die Request Klasse versendet ein Abfrage Paket an den vom Panel verwalteten Server per HTTP und empfangt das Antwortpaket Es enthalt die folgenden Elemente public string Hostname Beinhaltet den Host Namen IP Adresse des vom Panel verwalteten Servers an den das Abfrage Paket versendet wird StandardmaBig handelt es sich dabei um localhost public string Login Beinhaltet den Login des Panel Administrators Standardm ig handelt es sich dabei um admin 72 Einrichten ber Remote API public string Password publie Sicwilmg Prooroc public ValidationEventHandler XmlSchemaValidation public string AgentEntryPoint publie STELAE InputValidationSchema PUCES OutputValidationSchema public XmlDocument Send Xml Document public XmlDocument Send Stream public XmlDocument Send string private HttpWebRequest SendRequest string private XmlDocument ParseAndValidate TextReader string private XmlDocument GetRespons HttpWebRequest Beinhaltet das Pass
50. ZAS53B3ltsAQv2 yjXnkT Qw2 lbXusW OxhGpWC0z58jScyqNW HkvheUrgbyllOOakKs9vAayi3mA0T O1cB1vnAgmB8puV6ldEKuvUimgbJhiGlpqTiL 2 YgSnkGhRuYlxuFB6U8WPgrUN UMtOlinQtUsxMJCghMA3T8cODGon4ugZ0cCUmDfpkStl3j UuoxulSX2I8xmUQtGe 2Q sUQaWgJhe4RDoth6w7 E9GE8733W GhC1 mljxyJMx4vmu4ofLAWN6XUzJJ3eC7s P34vOGq sqxG U BbUu71 A lt content gt lt ip_address gt 192 0 2 14 lt ip address gt lt install gt lt certificate gt lt packet gt Einrichten ber Remote API 133 Struktur des Antwortpakets Der install Knoten des ausgegebenen XML Pakets ist wie folgt strukturiert r resultType Result status ok ferror i 7 ee Error code if error occurred t Error message if error occurred result erforderlich Verpackt die vom Server abgerufene Antwort status erforderlich Gibt den Ausf hrungsstatus der Operation an Datentyp string Zul ssige Werte ok error errcode erforderlich falls die Operation fehlschl gt Gibt den Fehlercode wieder Datentyp unsignedint errtext erforderlich falls die Operation fehlschl gt Gibt die Fehlermeldung wieder Datentyp string 134 Einrichten ber Remote API Antwort Beispiele Die positive Antwort von dem Server sieht wie folgt aus lt packet version 1 6 2 0 gt lt certificate gt lt install gt lt result gt lt status gt ok lt status gt lt result gt lt install gt lt certificate gt lt packet gt Negative Antworten vom Server k
51. angegeben Beispiele 1 Der folgende Befehl erstellt die Subdomain news example com und ein physisches Verzeichnis httpdocs news f r den Inhalt der Subdomain subdomain exe create news domain example com hst_type virt 2 Der folgende Befehl erstellt die Subdomain blog example com auf einem bereits existierenden Verzeichnis httpdocs news Nach der Erstellung ist der WordPress Blog Engine ber die URL http blog example com erreichbar subdomain exe create blog domain example com hst_type virt www_root httpdocs wordpress create_phys false Verf gbare APS Kataloge definieren Um die benutzerdefinierte Konfigurationsdatei des APS Katalogs zu importieren verwenden Sie den Befehl im folgenden Format aps lt import config ic gt lt file name gt Die Konfigurationsdatei sollte sich in einem der folgenden Verzeichnisse befinden Einrichten ber CLI 225 Das tempor re Verzeichnis des Panels opt psa tmp auf Debian usr local psa tmp auf anderen Linux Unix Systemen plesk dir tmp auf Windows Das tempor re Verzeichnis des Betriebssystems tmp auf Linux Unix C WINDOWS Temp auf Windows Weitere Einzelheiten zu dem Format der Konfigurationsdatei finden Sie in dem Abschnitt Konfigurationsdatei von APS Katalogen auf Seite 49 Beispiel Die folgenden Befehle importieren die Konfigurationsdatei von APS Katalogen catalogs ini Auf Linux Unix aps ic tmp catalogs ini oder aps ic u
52. eines jeden Servers mit einer Panel Instanz einrichten Oder anders formuliert Sie m ssen h chstwahrscheinlich nicht f r jede Panel Installation einen eigenen DNS Sever anlegen sondern k nnen das Panel an einen bestehenden DNS Server anbinden Es sollte auch erw hnt werden dass im Fall einer Parallels Containers Umgebung eventuell mehr Ressourcen verbraucht werden Denn Container mit dem Panel auf denen der DNS Server ausgef hrt wird verbrauchen mehr Ressourcen wodurch unter Umst nden die Dichte der gesamten Hosting Umgebung geringf gig gesenkt wird Um DNS Zonen von Panel verwalteten Domains so zu konfigurieren dass diese von einem Remote DNS Server beantwortet werden m ssen Sie den DNS Service bei der Bereitstellung der Panel Instanz deaktivieren Falls Ihre Kunden sich entschliessen dass Ihre Domains von einem lokalen DNS Server verarbeitet werden sollen k nnen Sie diesen sp ter immer noch aktivieren Falls die vom Panel verwalteten Domains von einem lokalen DNS Service verarbeitet werden sollen k nnen Sie die DNS Zonen jederzeit nach Bedarf ver ndern Das Panel stellt ein anpassbares Template f r DNS Zonen zur Verf gung das Templates f r DNS SOA und andere Ressourceneintr ge enth lt Wenn ein Domain Account erstellt wurde wird die DNS Zone basierend auf diesem Template erstellt Um DNS Zonen f r die vom Panel verwalteten Domains zu erstellen m ssen Sie nur das entsprechende DNS Zonen Template bearbeiten Qui
53. erster Stelle in der Konfigurationsdatei des APS Katalogs auf Seite 146 definiert wird 170 Einrichten ber Remote API Beispiele f r Abfragen Dieses Paket installiert ein Anwendungspaket einer bestimmten Version Release Anbieter und Publisher und von einem ganz bestimmten APS Katalog h chstwahrscheinlich ein anderer als der standardm ig voreingestellte lt packet version 1 6 2 0 gt lt aps gt lt download package gt lt package gt lt name gt BlogEngine NET lt name gt lt version gt 1 4 5 lt version gt lt release gt 2 lt release gt lt vendor gt www dotnetblogengine net lt vendor gt lt packager gt parallels com lt packager gt lt package gt lt aps catalog url gt http apscatalog com lt aps catalog url gt lt download package gt lt aps gt lt packet gt Dieses Paket l dt verschiedene Pakete mit Blog Anwendungen aus dem Standard APS Katalog herunter Es wird erwartet dass jeweils die aktuellste Anwendung in den Katalog Paketen heruntergeladen wird lt packet version 1 6 2 0 gt lt aps gt lt download package gt lt package gt lt name gt Blog lt package gt Engine N lt download package gt lt download package gt lt package gt ET lt name gt lt name gt WordPress lt name gt lt package gt Einrichten ber Remote API lt download package gt lt download package gt lt package gt lt name
54. gt lt result gt lt install gt 196 Einrichten ber Remote API lt aps gt lt packet gt 2 Folgende Antwort wird empfangen wenn die in der Abfrage definierten Anwendungseinstellungen nicht gegen die Datei APP MI ABFRAGE PAKET lt packet version 1 6 2 0 gt lt aps gt lt install gt lt domain id gt 10 lt domain id gt lt package gt lt name gt joomla lt name gt lt package gt lt settings gt lt setting gt lt name gt admin_name lt name gt lt value gt admin lt value gt lt setting gt lt setting gt lt name gt admin_password lt name gt lt value gt dfkjEEtbgg lt value gt lt setting gt lt setting gt lt name gt admin_email lt name gt lt value gt johndoe example com lt value gt lt setting gt lt setting gt lt name gt locale lt name gt lt value gt en US lt value gt lt setting gt lt setting gt lt namestitle lt name gt lt value gt Joomla lt value gt lt setting gt lt settings gt lt install gt ETA xml validiert werden konnten Einrichten ber Remote API 197 lt aps gt lt packet gt ANTWORTPAKET lt packet version 1 6 2 0 gt lt aps gt lt install gt lt result gt lt status gt error lt status gt lt errcode gt 1019 lt errcode gt lt errtext gt Some errors occurred during installation The value of locale should be one of en GB fr FR de DE lt errtext gt lt result gt lt i
55. gt lt errcode gt 1023 lt errcode gt lt errtext gt APS Catalog configuration file is broken lt errtext gt lt result gt lt download package gt lt aps gt lt packet gt 174 Einrichten ber Remote API Status eines Download Tasks abfragen Um den Status des Download Vorgangs eines Pakets abzufragen erstellen Sie ein XML Abfrage Paket mit dem aps get download status Kontrollknoten lt packet version 1 6 2 0 gt lt aps gt lt get download status gt lt get download status gt lt aps gt lt packet gt Die folgenden Statusmeldungen sind m glich finished error Der Download Vorgang konnte nicht gestartet werden da das Paket nicht in dem APS Katalog gefunden werden konnte finished package id Der Download Vorgang wurde erfolgreich abgeschlossen in progress current Das Paket wird momentan heruntergeladen in progress ohne den untergeordneten child Knoten current bedeutet dass der Download Vorgang des Pakets noch nicht gestartet wurde sich aber in der Warteschlange befindet In diesem Abschnitt Struktur des Abfrage Pakels u u en 174 Beispiele f r Abfragen uus 44444444nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nennen 176 Struktur des Antwortpakets uussssnnssssnnnnnnnnnnnnnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 177 Abfrage und Antwort Beispiele 44444444440nnn nenne nnnnnnnnn
56. lt errcode gt 1019 lt errcode gt lt errtext gt Incorrect DNS record values were specified lt rrtext gt Einrichten ber Remote API 115 lt result gt lt add_rec gt lt dns gt lt packet gt Informationen ber das DNS Zonen Template abrufen Um Informationen ber die Ressourceneintr ge in dem DNS Zonen Template abzurufen erstellen Sie ein XML Paket mit dem dns get_rec Kontrollknoten lt packet version 1 6 2 0 gt lt dns gt lt get_rec gt lt filter gt lt template gt lt get_rec gt lt dns gt lt packet gt In diesem Abschnitt Struktur des Antwortpakets a2 ee 116 Antwort Beispiele n ee ee inla 118 116 Einrichten ber Remote API Struktur des Antwortpakets Der get_rec Knoten des ausgegebenen XML Pakets ist wie folgt strukturiert resultType extension get_ree BE r oe Einrichten ber Remote API 117 result erforderlich Verpackt die vom Server abgerufene Antwort Datentyp resultType common xsd status erforderlich Gibt den Ausf hrungsstatus der Operation an Datentyp string Zul ssige Werte ok error errcode erforderlich falls die Operation fehlschl gt Gibt den Fehlercode wieder Datentyp integer errtext erforderlich falls die Operation fehlschl gt Gibt die Fehlermeldung wieder Datentyp string id erforderlich falls die Operation erfolgreich abgeschlossen wird Liefert den eindeutigen
57. lt status gt ok lt status gt lt id gt 2 lt id gt lt result gt lt result gt lt status gt ok lt status gt lt id gt 3 lt id gt lt result gt lt result gt lt status gt ok lt status gt lt id gt 4 lt id gt lt result gt lt result gt lt status gt ok lt status gt 126 Einrichten ber Remote API lt id gt 5 lt id gt lt result gt lt result gt lt status gt ok lt status gt lt id gt 6 lt id gt lt result gt lt result gt lt status gt ok lt status gt lt id gt 7 lt id gt lt result gt lt result gt lt status gt ok lt status gt lt id gt 8 lt id gt lt result gt lt result gt lt status gt ok lt status gt lt id gt 9 lt id gt lt result gt lt result gt lt status gt ok lt status gt lt id gt 10 lt id gt lt result gt lt result gt lt status gt ok lt status gt lt id gt 11 lt id gt lt result gt lt result gt lt status gt ok lt status gt lt id gt 12 lt id gt lt result gt lt del_rec gt lt dns gt lt packet gt Folgende negative Antwort wird empfangen falls der angegebene zu l schende Eintrag nicht existiert Einrichten ber Remote API ABFRAGE PAKET lt packet version 1 6 2 0 gt lt dns gt lt del _rec gt lt filter gt lt id gt 1 lt id gt lt id gt 2 lt id gt lt id gt 3 lt id gt lt id gt 4 lt id gt lt id gt 5 lt id gt lt filter gt lt template gt
58. ltiger base64 Code ist aber kein Lizenzschl ssel Wenn Sie das folgende Abfrage Paket ausgeben erhalten Sie eine Fehlermeldung error 1020 lt packet version 1 6 2 0 gt lt server gt lt lic_install gt lt license gt TGVOIHVzIGp1c3QgcHJldGVuZCBOaGFOIHRoaXMgaXMgYSBQYXJhbGxlbHMg UGFuZWwgbGljZW5zZSBrZXkuCk9mIGNvdXJzZSwgd2UgY291 bGQgbm90 GluY2x1ZGUg YSByZWFsIGxpY2Vuc2Uga2V5IGlulHRoZSBkb2N1bW VudGFOaW 9SuLgpUaGFuayB5b3Ug Zm9ylHVuZGVyc3RhbmRpbmcu lt license gt lt additional_key gt lt lic_install gt lt server gt lt packet gt Struktur des Antwortpakets Der lic_install Knoten des Antwortpakets ist wie folgt strukturiert LicenselnstallType f resultType Result status ok error ee Error code if error occurred Error message if error occurrec Einrichten ber Remote API 99 result erforderlich Verpackt die vom Server abgerufene Antwort status erforderlich Gibt den Ausf hrungsstatus der Operation an Datentyp string Zul ssige Werte ok error errcode erforderlich falls die Operation fehlschl gt Gibt den Fehlercode wieder Datentyp unsignedint errtext erforderlich falls die Operation fehlschl gt Gibt die Fehlermeldung wieder Datentyp string Antwort Beispiele Eine positive Antwort vom Server sieht wie folgt aus lt packet version 1 6 2 0 gt lt server gt lt lic_install gt lt result gt lt status gt ok lt sta
59. nnen wie folgt aussehen lt packet version 1 6 2 0 gt lt certificate gt lt install gt lt result gt lt status gt error lt status gt lt errcode gt 8002 lt errcode gt lt errtext gt Unable to set csr content to certificate CSR field contains an improper value openssl failed lt errtext gt lt result gt lt install gt lt certificate gt lt packet gt lt packet version 1 6 2 0 gt lt certificate gt lt install gt lt result gt lt status gt error lt status gt lt errcode gt 8006 lt errcode gt lt errtext gt Unable to set certificate name lt errtext gt lt result gt lt install gt Einrichten ber Remote API 135 lt certificate gt lt packet gt Erstellen von Domains F r die Erstellung eines Domain Accounts erstellen Sie ein XML Paket mit dem domain add Kontrollknoten lt packet version 1 6 2 0 gt lt domain gt lt add gt lt add gt lt domain gt lt packet gt In diesem Abschnitt Struktur des Abfrage Pakets uu 4444444444 Hnnnnnnnnnnnnnnnnnnnnnannnnnnnnnnnnnnnnnnnnn 135 Beispiele f r Abfragen uuun44444444nnnnnnnnnnnnnnnnnnnnnnnnnnnnannnnnnnnnnnnnnnnnnnnn nn 137 Struktur des Antwortpakets a teen 138 Antwort Beispiele ns EE E EREE 139 Struktur des Abfrage Pakets Ein XML Abfrage Paket ber das ein Domain Account erstellt wird beinhaltet den del_rec Kontrollknoten der wie folgt strukturiert
60. r resultType Result status ok error Error code if error occurred Error message if error occurred a Las ae ae a ee ee a mn erforderlich Verpackt die vom Server abgerufene Antwort Datentyp resultType common xsd status erforderlich Gibt den Ausf hrungsstatus der Operation an Datentyp string Zul ssige Werte ok error errcode erforderlich falls die Operation fehlschl gt Gibt den Fehlercode wieder Datentyp integer errtext erforderlich falls die Operation fehlschl gt Gibt die Fehlermeldung wieder Datentyp string Operations spezifische Fehler 1013 Das angegebene Objekt Domain Subdomain gefunden werden 1019 install Die Anwendungen kann mit den angegebenen iert werden 1100 Die Anwendungsvoraussetzungen sind nicht Paket konnte nicht Einstellungen nicht ausreichend 194 Einrichten ber Remote API Antwort Beispiele Eine positive Antwort vom Server sieht wie folgt aus lt packet version 1 6 2 0 gt lt aps gt lt install gt lt result gt lt status gt ok lt status gt lt result gt lt install gt lt aps gt lt packet gt Fehlermeldungen 1013 object not found 1 Folgende negative Antwort wird empfangen wenn eine angegebene Domain oder Subdomain nicht existiert lt packet version 1 6 2 0 gt lt aps gt lt install gt lt result gt lt status gt error lt status gt lt er
61. r Abfragen nciht 91 Struktur des Antwortpakets nun a u 92 Antw ort Beispiele 2 ee 93 90 Einrichten ber Remote API Struktur des Abfrage Pakets Der initial_setup Knoten ist wie folgt strukturiert 1 SMBinitialSetupiInputType o fesoa PFTIIIIIT ke ee ee a password erforderlich Gibt das neue Passwort des Panel Administrators an Datentyp serverPassword plesk_server xsd String mit 5 bis zu 14 Zeichen admin_email erforderlich Gibt die E Mail Adresse des Panel Administrators an Datentyp emailType common xsd String mit 3 bis zu 255 Zeichen locale optional Gibt das Panel Gebietsschema an den L ndercode f r die Sprache und die Kultur in dem das Panel Oberfl che verwendet wird Datentyp string Einrichten ber Remote API 91 Beispiele f r Abfragen Ein Abfrage Paket zur Initialisierung des Panels sieht wie folgt aus lt packet version 1 6 2 0 gt lt smb gt lt initial_setup gt lt password gt P4SSw0rd lt password gt lt admin_email gt johndoe example com lt admin email gt lt initial_setup gt lt smb gt lt packet gt Ein Abfrage Paket ber welches das Panel initialisiert wird und das Deutsch Deutschland als Standardsprache konfiguriert sieht wie folgt aus lt packet version 1 6 2 0 gt lt smb gt lt initial_setup gt lt password gt P4SSw0rd lt password gt lt admin_email gt johndoe example com lt admin email gt
62. wenn der FTP Account der bergeordneten Domain Parent Domain auch zur Verwaltung der Subdomains verwendet wird Beispiele 1 Der folgende Befehl erstellt die Subdomain mail example com und der FTP Account der zur Verwaltung des Inhalts verwendet wird ist derselbe wie f r die bergeordnete Parent Domain example com Auf Linux Unix subdomain create mail domain example com Auf Windows subdomain exe create mail domain example com 2 Der folgende Befehl erstellt die Subdomain portfolio example com und zur Verwaltung des Subdomain Inhalts einen FTP Account mit dem Login port folio und dem Passwort P4SSwOrd Auf Linux Unix subdomain create portfolio domain example com ftp_user native login portfolio passwd P4 wOrd Auf Windows subdomain exe create portfolio domain example com ftp_user native login portfolio passwd P4 wOrd 224 Einrichten ber CLI Erstellen von Subdomains auf Unterordnern nur Windows Befehl Mit dem folgenden Befehl erstellen Sie eine Subdomain auf einem Unterordner subdomain lt create c gt lt subdomain prefix gt domain lt parent domain name gt hst_type virt www_root lt subdomain root directory gt create_phys false wobei der Teil www _root lt subdomain root directory gt create_phys false daf r verantwortlich ist eine Subdomain auf dem bereits existierenden Verzeichnis zu erstellen Der Pfad wird mithilfe der www_root Option
63. wird lt packet version 1 6 2 0 gt lt domain gt lt add gt lt gen_setup gt lt name gt example com lt name gt lt ip_address gt 192 0 2 48 lt ip_address gt lt gen_setup gt lt hosting gt lt vrt_hst gt lt property gt lt name gt ftp_login lt name gt lt value gt fp 1 6se4fdf0 lt value gt lt property gt lt property gt lt name gt ftp_password lt name gt lt value gt qweqwe lt value gt lt property gt lt ip_address gt 192 0 2 48 lt ip address gt lt vrt_hst gt lt hosting gt lt add gt lt domain gt lt packet gt 138 Einrichten ber Remote API Struktur des Antwortpakets Der add Knoten des Antwortpakets ist wie folgt strukturiert resultType extension Result status ok error EH errcode Add domain Error code if error occurred Error message if error occurred 1 am m m m ana mu annnnd New domain GUID result erforderlich Verpackt die vom Server abgerufene Antwort Datentyp resultType common xsd status erforderlich Gibt den Ausf hrungsstatus der Operation an Datentyp string Zul ssige Werte ok error errcode erforderlich falls die Operation fehlschl gt Gibt den Fehlercode wieder Datentyp integer errtext erforderlich falls die Operation fehlschl gt Gibt die Fehlermeldung wieder Datentyp string id erforderlich falls die Operation erfolgreich abgeschlossen wird Liefert den eindeutig
64. zudem weitere optional eingeschachtelte Elemente enthalten sofern diese in dem complexType definiert wurden In den meisten F llen sieht das Format des Pakets das an den Panel API RPC Server zur ckgegeben wird wie folgt aus lt xml 1 0 encoding UTF 8 gt lt packet version 1 6 2 0 gt lt operator gt lt operation gt lt result gt SPESIES lt result gt SEHEN ae T lt result gt lt operation gt lt operator gt lt packet gt In dem obigen Beispiel steht operator f r den Operator der in dem Abfrage Paket verwendet wird und operation bezieht sich auf die durchgef hrte Operation Das RESULT Element wird immer verwendet um die erforderlichen Information und den Ausf hrungsstatus von der durchgef hrten Operation zu isolieren Der Abschnitt RESULT enth lt immer das STATUS Element das den Ausf hrungsstatus der durchgef hrten Operation enth lt Hinweis Der Funktionsbereich einer echten XML Abfrage kann mehrere Funktionen enthalten wenn das Eingangspaket f r mehrere Funktionen angefordert wurde Ein Antwortpaket kann mehrere Funktionsbereiche enthalten wenn das Eingangspaket f r Aufgaben mehrerer Panel Objekte ben tigt wird Einrichten ber Remote API 63 Fehlerhandling Der Server Teil berichtet ber zwei Fehlertypen an die Clientsoftware dazu z hlen die berpr fungsfehler und die Ausf hrungsfehler falls es dazu kommt dass die angeforderte Operation ausge
65. zur ck indem das Paket in der Baumstruktur dargestellt ist Um mehr ber die SimpleXML Erweiterung von PHP zu erfahren besuchen Sie bitte folgende Website http www php net manual en ref simplexml php Erhalt das Antwortpaket SimpleXMLEelement und berpr ft den result Knoten Falls in diesem Knoten error steht dann schreibt die Funktion eine Ausnahme mit dem String in den errtext Knoten lt xml version 1 0 encoding UTF 8 gt lt packet version 1 6 2 0 gt lt domain gt lt get gt lt filter gt lt dataset gt lt limits gt lt prefs gt lt user gt Einrichten ber Remote API 67 lt hosting gt lt stat gt lt gen_info gt lt dataset gt lt get gt lt domain gt lt packet gt Dann wird curllnit aufgerufen um eine CURL Sitzung mit Optionen zu initialisieren Die Funktion sendRequest versendet ein Paket mit dem HTTP Header wie folgt POST enterprise control agent php HTTP 1 1 Host 10 58 32 100 8443 HTTP_AUTH_LOGIN Login HTTP_AUTH_PASSWD qwedsa HTTP_PRETTY_PRINT TRUE Content Length 294 Content Type text xml Das XML Antwortpaket das von dem vom Panel verwalteten Server empfangen wird sieht wie folgt aus lt xml version 1 0 encoding UTF 8 gt lt packet version 1 6 2 0 gt lt domain gt lt get gt lt result gt lt status gt ok lt status gt lt id gt 1234 lt id gt lt value gt lt gen info gt lt cr_date gt 1154513574 lt cr_dat
66. 108 Struktur des Antwortpakets 2 2 ae ee 113 Antwort Beispiele ee ee 114 Einrichten ber Remote API 107 Struktur des Abfrage Pakets Ein XML Abfrage Paket mit dem ein neuer DNS Eintrag zu dem DNS Zone Template hinzugef gt wird beinhaltet den Kontrollknoten dns add_rec der durch den dnsRecord type plesk _dns xsd dargestellt wird und wie folgt strukturiert ist dnsRecord add_rec I type erforderlich Gibt den Typ des DNS Eintrags an Datentyp string Zul ssige Werte A NS CNAME MX PTR TXT SOA AXFR SRV host erforderlich Gibt den Namen des Hosts an f r den die Eintragseinstellungen bernommen werden Datentyp string value erforderlich Gibt den Wert an der mit dem Wert host verkn pft wird Datentyp string Der Wert enth lt die Platzhalter lt domain gt oder lt ip gt die durch echte IP Adressen Hostnamen ersetzt werden wenn eine DNS Zone nach der Erstellung der Domain erstellt wird opt optional Beinhaltet optionale Informationen ber den DNS Eintrag Datentyp string Hinweis Im Falle des SRV Eintrags kann der opt Knoten zus tzlichen XML Code in dem folgenden Format enthalten lt Srv Protocol Port Priority Weight gt Sie k nnen mehrere DNS Eintrage ber ein einziges Paket hinzuf gen F gen Sie so viele lt add rec gt Operationen hinzu wie Sie DNS Eintr ge hinzuf gen wollen lt dns gt lt add_rec gt lt add_rec gt
67. 2 44 gt vzctl set 444 save diskspace 4500000 vprvmem 1024 userpasswd Administrator P4 wOrd offline management no 2 Starten Sie den neu erstellten Container gt vzctl start lt CT_ID gt 3 Installieren Sie Microsoft NET Framework Version 2 0 oder sp ter in Ihrem Container vzpkgadd lt CT_ID gt lt dotnet template name gt Beispiel gt vzpkgadd 444 dotnet2 0 frmwk 2 0 50727 42 20070613 4 Installieren Sie das Template f r Parallels Small Business Panel in dem Container vzpkgadd lt CT_ID gt lt ppsmbe template name gt Beispiel gt vzpkgadd 444 ppsmbe 10 2 0 20091126 22 gt So klonen Sie einen Container F hren Sie den Befehl im folgenden Format aus vzmlocal C lt CT_List gt lt CT_List gt lt source_CTID gt lt dest_CTID gt lt dest_private gt Optionen Sie m ssen die Quell Container ID lt source_CTID gt und die Ziel Container ID lt dest_CTID gt angeben Optional k nnen Sie den Private Area Path zum Ziel Container lt dest_private gt angeben Sie k nnen so den Standard Pfad von X vz private lt CT_ID gt berschreiben Weitere Informationen zu Befehlsoptionen finden Sie im Referenzhandbuch Parallels Containers f r Windows verf gbar im Parallels Technology Network http www parallels com ptn documentation virtuozzo Beispiel So klonen Sie einen Container der mithilfe des Panels w hrend des vorigen Vorgangs erstellt wurde Verteilung des Panels 27 gt vzmlocal C 444 4
68. 2V5dHIWwZT 4gDQogIDwvY 29yZT pk ZXNjcmlwdGlvbj4NCi0gPCEtLSBQcm9kdWNOIHdoaWNolHRoaXMgbGljZW5zZSBpcyBpbn RibmRIZCBObyB3b3UrlG9uDQogICOtPIANCiIAgPGNvcmU6cHJvZHVjdCBjb3JlIOnR5cGU9In NOcmluZyl cHAtc21iLXVuaxXg8L2NvcemU6cHJvZHVjdD4gDQotIDwhLSOgU3VwcG9ydGVkI HByb2R1 Y3QgdmVyc2lvbgOKICAtLT4gDQogIDxjb3JlOnZIicnNpb24gY29yZTp0eXBIPSJzdH JpbmciPjEwLjA8L2NvcmU6dmVyc2lvbj4gDQotIDwhLSOgRGFOZSBhZnRiIciB38aGljaCB0aGlz IGxpY2Vuc2UgYmVjb21lcyB1c2FibGUgKGluY 2x1 c2I2ZSKNCiIAgLS0 IAOKICA8Y29yZT pzd GFydC 1kYXRIIGNvemU6dHIWZTOIZGFOZSI aW5ZzdGFudDwvY29yZ TpzdGFydC 1kYXRIPIA NCi0OgPCEtLSBEYXRIIGJIZMY9yZSB3aGljaCBOaGlzIGxpY2Vuc2UgaXMgdXNhYmxIIChleGN sdXNpdmUpDQogI COtPIANCiAgPGNvemU6ZXhwaxJhdGlvbi1kYXRIIGNvcmU6dHIwZTO0iZ GFOZSI bmV2ZXI8L2NvcmU6ZXhwaXxJhdGlvbi1 kYXRIPIANCiIOgPCEtLSBVUkwgb2YgdGhll HNicnZpY2UgZW5kcG9pbnQgdG8gdXNilHdoZW4gcGVyZm9ybWluZyBhbiBhdXRvdXBkYX RIDQogICOtPIANCiAgPGNvcmU6bGIjZW5z2ZS1zZXJ2ZXltdXJsIGNvcmU6dHIwZTOic3Ryaw 5nlj50dHRwezovL2thLnBhcmFsbGVscy5jb206NT lyNC94bW xycGM8L2NvcmU6bGIjZW5zZS 1ZZXJ2ZX tdXJsPIANCi0gPCEtLSBEY XRIIHdoZW4gcHJvZHVjdCB3aW xsIHRyeSBObyBwZ XJmb3uUtIGFulGF1dG91cGRhdGUNCiAgLS0 IAOKICA8Y 29yZTp1 cGRhdGUtZGFOZSBjb3uI OnR5cGU9IImRhdGUiPmluc3RhbnQ8L2NvemU6dXBkYXRILW RhdGU IAOKICA8Y29yZT p1 cGRhdGUtdGlja2VOIGNvcmU6aGIkZGVuPSJOcnVIliBjo3JIOnR5cGU9InNOcmluZyl LSOtLS Otc21iXzZEwX3VuaxhfiZGVmyYXVsdCOtLSOtLSO8L2NvcmU6dXBkYXRILXRpyY 2tldD4gDQotID whLS0gU01 CIFVzZXJzDQogICOtPIANCiAgPHBwLXNtYil 1bml4LTEwOnMtYil 1c2VycyBjb3J IOnR5cGU9ImludGVnZXliPjESL3B
69. 43 enterprise control agent php nd Get ti ti nd Property As ublic ReadOnly Property InputValidationSchema As String 84 Get Einrichten ber Remote API Return String Concat New String https Me Hostname 8443 schemas rpc Me Protocol agent input xsd Get nd Get ti nd Property ti AS ublic ReadOnly Property OutputValidationSchema As String Return String Concat New String https Me Hostname 8443 schemas rpc Me Protocol agent output xsd nd Get ti nd Property m Public Function Send ByVal packet As XmlDocument As XmlDocument Dim request As HttpWebRequest Me SendRequest packet OuterXml Return Me GetResponse request End Function Public Function Send ByVal packet As Stream As XmlDocument Using reader As TextReader New StreamReader packet Return Me Send Me ParseAndValidate reader InputValidationSchema nd Using I nd Function zal Public Function Send ByVal packetUri As String As XmlDocument Using reader As TextReader New StreamReader packetUri Return Me Send Me ParseAndValidate reader Me InputValidationSchema End Using End Function Private interface Sending a request message Private Function SendRequest ByVal message As String As HttpWebRequest Einrichten ber Remot
70. 4444440HRnnnnnnnnnnnnnnnnnnnnnnnnn nenn 151 Import von hochgeladenen Anwendungspaketen 44444snnnnnnn nennen 163 Anwendungspakete vom APS Katalog herunterladen 4444 gt 168 Status eines Download Tasks abfragen cccceeeeeeeeeeeeneeeeeeeeeeeeesenneeeeeeees 174 Einrichten ber Remote API 151 Dateien auf den Server hochladen Um Dateien auf den vom Panel verwalteten Server hochzuladen verwenden Sie den upload Operator Im Gegensatz zu anderen Operatoren verwendet der upload Operator keine Standardstruktur des Abfrage Pakets Es verwendet stattdessen die POST Methode http www w3 org Protocols rfc2616 rfc2616 sec9 html um Dateien hochzuladen Wenn eine Abfrage von dem Panel verarbeitet wird wird die Antwort im regul ren XML Antwortpaket wiedergegeben Nachdem eine Datei auf das Panel hochgeladen wurde kann sie f r andere Prozesse verwendet werden Hinweis Sie k nnen Dateien auch ber den FTP Manager hochladen aber beachten Sie sich in einem solchen Fall bitte dass die Berechtigungen zu den hochgeladenen Dateien unzul ssig f r weitere API RPC Operationen auf den Dateien sind Aus diesem Grund empfehlen wir die Verwendung des upload Operators In diesem Abschnitt Dateien mit CURL hochladen uusnuuuunnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn anne nennen 151 Dateien mit PHP hochladen uus 22uunnenennnnnnnnnnnnnnnnnnnnnnnnnnnnnnn anne nun 153
71. 45 Einrichten eines Mirrors mit dem Dienstprogramm Rsync Dieser Abschnitt beschreibt wie Sie einen lokalen Mirror des Parallels Updates Servers sowohl f r Linux Unix als auch f r Windows Distributionen des Parallels Small Business Panel auf einem Linux Server mithilfe von Rsync erstellen Rsync ist ein Open Source Dienstprogramm welches die Erstellung von Mirrors erm glicht die ein gew nschtes Set an Panel Distributionen inklusive denen f r Parallels Containers unterst tzten Ein Mirror von Parallels Small Business Panel f r ein Linux Repository unterst tzt sowohl Einzelplatz als auch Parallels Containers Installationen abh ngig von der Anzahl der kopierten Pakete In diesem Abschnitt Mirrors von Linux Unix Distributionen erstellen 224024444 RR Rn nennen 28 Mirrors von Windows Distributionen erstellen un2444244RR RR Rennen nennen 31 28 Verteilung des Panels Mirrors von Linux Unix Distributionen erstellen Das Repository von Parallels Small Business Panel f r Linux Unix befindet sich unter autoinstall plesk com und ist wie folgt strukturiert es werden nur die Dateien und Verzeichnisse aufgelistet die f r das Erstellen von Mirrors der Panel Pakete relevant sind lt PRODUKTNAME gt lt Produkt_Version gt Mehrere Unterverzeichnisse werden in bereinstimmung mit den Panel Versionen genannt In unserem Fall sind folgende Unterverzeichnisse interessant a PP
72. 5 verwenden Sie die ID die dem Paket beim erfolgreichen Download vom APS Katalog zugewiesen auf Seite 177 verwenden Sie die ID die in den Informationen der verf gbaren Pakete angegeben wird auf Seite 202 Um die Paketinformationen package name version release vendor packager Paketname Version Release Anbieter Verpacker anzugeben fragen Sie die Informationen zu den Paketen ab die zur Installation zur Verf gung stehen auf Seite 200 In diesem Abschnitt Installieren einer Anwendung auf einer Domain oder Subdomain 185 Verf gbare Pakete abrufen uuuss44444nnnnnnnnnnnnnnnnnnnnnnnnnnnnannnnnnnnnnnannnnnnnnn 200 Installieren einer Anwendung auf einer Domain oder Subdomain Um eine Anwendung zu installieren erstellen Sie ein XML Abfrage Paket mit dem aps install Kontrollknoten lt packet version 1 6 2 0 gt lt aps gt lt install gt lt install gt lt aps gt lt packet gt In diesem Abschnitt Struktur des Abfrage Pakets uu 4444444444 Hnnnnnnnnnnnnnnnnnnnnnnannnnnnnnnnnnnnnnnnnnn 186 Beispiele f r Abfragen een et ees oe aes Oe ea 191 Struktur des Antwortpakets san ee 193 Antwort Beispiele a ee 194 186 Einrichten ber Remote API Struktur des Abfrage Pakets Der install Knoten ist wie folgt strukturiert package id CBE sal ut preti settings Einrichten ber Remote API 187 Entweder domain id oder domain n
73. 5 Parallels Containers f r Windows gt So installieren Sie das Panel Template auf einem Hardware Node von Parallels Containers 1 Beziehen Sie ein Panel Template ber die Parallels Website http www parallels com und laden Sie diese auf den Ziel Hardware Node von Parallels Containers hoch 2 Installieren Sie das Anwendungs Template des Panels Falls Sie die Installation auf Microsoft Windows Server 2003 durchf hren installieren Sie au erdem Microsoft NET Framework v 2 0 oder sp ter indem Sie den Befehl im folgenden Format ausf hren vzpkgdeploy q v i lt Template der Datei gt wobei q die Protokollierung an das Display und die Protokolldatei deaktiviert y das Protokoll Level auf den h chstm glichen Wert f r diese vzpkgdeploy Sitzung festlegt Beispiel gt vzpkgdeploy i ppsmbe_10 2 0 20091126 22 efd gt vzpkgdeploy i dotnet2 0 frmwk 2 0 50727 42 efd Hinweis Die Installation eines weiteren Templates des NET Frameworks ist nur auf einem Windows Server 2003 PVC 4 0 VZ 3 5 1 notwendig Dieser Vorgang ist nicht beim Windows Server 2008 PVC 4 5 erforderlich gt So erstellen Sie einen neuen Container und installieren das Panel in diesem 1 Erstellen Sie einen Container und konfigurieren Sie diesen gem Ihren Anforderungen optional F hren Sie die folgenden Befehle aus Vzeelsereates lt Ci IH okgsetznamesloperonen vzctl set lt CT_ID gt lt Name_ der Einstellung gt lt Wert gt
74. Add ons verkauft werden panelAndAddonsLicensesStore http example com panel store berblick zu Setupvorg ngen 39 falls die URL des Online Shops ge ndert werden soll ber den Lizenzen f r Marketplace Anwendungen verkauft werden url http example com marketplace shop falls die URL des Online Shops ge ndert werden soll ber den die Benutzerpakete f r das Panel verkauft werden userpacksUrl http example com panel userpacks falls die URL ge ndert werden soll ber die CA Zertifikate verkauft werden E buySslCertificatesUrl http example com certificates falls die URL ge ndert werden soll ber die Domain Namen registriert werden registerDomainsUrl http example com certificates Um nderungen r ckg ngig zu machen und zu den Standardeinstellungen zur ckzukehren entfernen Sie den entsprechenden String aus smb ini 40 berblick zu Setupvorg ngen DNS Konfiguration lt SMB_panel gt wird zusammen mit dem DNS Server installiert Dieser Server wurde als der Master Nameserver f r die Domains konfiguriert die mit dem Panel erstellt und gehostet werden Bei der Bereitstellung des Panels k nnen Sie den DNS Service nach Bedarf konfigurieren oder deaktivieren Falls Sie eine Arbeitsumgebung mit einem Nameserver eingerichtet haben der alle gehosteten Domains verwaltet m ssen Sie h chstwahrscheinlich keinen separaten DNS Server innerhalb
75. I 213 ndern der Support URL Um den Support Link zu ndern eine URL die sich beim Anklicken des Support Buttons ffnet verwenden Sie einen Befehl in dem folgenden Format branding lt change support url c gt url lt URL gt Beispiele Uber den folgenden Befehl ffnet sich ein benutzerdefiniertes Support Anfrageformular wenn ein Benutzer auf den Support Button klickt https support example com submit ticket Auf Linux Unix branding c url https support example com submit ticket Auf Windows branding exe c url https support example com submit ticket DNS Konfiguration Um den DNS Dienst des Panels Uber die CLI zu konfigurieren auch um es abzuschalten verwenden Sie das server _dns Dienstprogramm In diesem Abschnitt DNS Dienst deaktivieren PERERRERDEBFEREEBRER PERLFEFEREREEERNERLPEFEPRBEERERTERLFEERHEREERERHERLERRSEERER 213 Andern des SOA Record Templates 24444440nn4n4nnnnnnnnnnnnnnnnnnnnnnnnnnnannnn 214 Einrichten von Templates f r Ressourceneintr ge uuuusunsssssnnnnnnnnnnnnnnnnennnnnn 215 DNS Dienst deaktivieren Um den DNS Dienst des Panels zu deaktivieren f hren Sie den folgenden Befehl aus server_dns lt update server u gt status disabled Auf Linux Unix server_dns u status disabled Auf Windows server dns exe u status disabled 214 Einrichten ber CLI ndern des SOA Record Templates Um das SOA Record Template zu ndern geben Sie den B
76. Ihrer Firmen Website ersetzen Support Der Support Button befindet sich auf der Registerkarte Einstellungen und ist f r den Panel Administrator verf gbar Beim Klicken auf diesen Button ffnet sich standardm ig das Support Anfrageformular der Parallels Website welches vom Administrator ausgef llt und versendet wird Falls Sie Ihren Kunden technischen Support anbieten m chten k nnen Sie die URL ver ndern die sich ffnet wenn man auf den Support Button klickt Quicklinks Branding des Panels ber die Befehlszeilenoberfl che CLI auf Seite 211 Anpassen von Service Links Die Benutzeroberfl che von Parallels Small Business Panel beinhaltet verschiedene Links zu den folgenden Services Dienst Beschreibung Zugriff von Standard Online Shop Verkauf Upgrade Einstellungen gt Verwaltung von Online Shop von des Panels von Panel Add ons Lizenzschl sseln die Links Online Shop Parallels und allgemeinen besuchen und Panel Add ons erwerben und Lizenzen Online Shop besuchen und Panel Lizenzschl ssel upgraden Marketplace Application Online Shop bitte lesen Sie den Hinweis unter der Tabelle Shop f r Benutzerpak ete Online Shop f r Domain Name Registrar Lizenzen Verkauf f r Marketplace Verkauf von Panel Verkauf von CA SSL Zertifikate Verkauf von Domain Namen berblick zu Setupvorg ngen 37 Applikationen amp Skripte gt Marketplace die Jetzt Parallels kaufen Buttons Marketplace
77. Installationsvoraussetzungen finden Sie in dem Installationshandbuch auf der Website mit der Dokumentation von Parallels Small Business Panel http www parallels com products small business panel documentation Die Einzelplatz Verteilung des Panels wird ber das Dienstprogramm Parallels Installer durchgef hrt Das Dienstprogramm stellt eine Verbindung zu dem Update Server des Parallels Small Business Panel her auf dem die Panel Pakete gespeichert werden l dt die ben tigten Pakete herunter und installiert diese Der Parallels Installer kann entweder im interaktiven Modus ber die grafische Weboberfl che oder die Befehlszeile oder automatisch verwendet werden wenn er ber die Befehlszeile mit bestimmten Optionen ausgef hrt wird Im letzteren Fall kann die Panel Verteilung mithilfe von Shell Skripten automatsiert werden Es existieren verschiedene Distributionen des Parallels Installers f r unterschiedliche Betriebssysteme und Plattformen Bitte vergewissern Sie sich aus diesem Grund dass Sie das Parallels Installationsprogramm verwenden das f r Ihre Host Betriebssysteme entwickelt wurde Im Normalfall werden die Bin rdateien des Parallels Installers in dem folgenden Format verteilt parallels installer v lt Installer Version gt os lt Version des Betriebssystems gt lt Plattform gt Hinweis Wenn die Befehlszeile des Parallels Installers beschrieben wird gehen wir davon aus dass das Dienstprogramm Parallels Inst
78. L over HTTP Protocol das Daten in Form von speziell formatierten Paketen austauscht Die Kommunikation zwischen dem Panel und einer Drittanbieter Software basiert auf dem Client Server Programmierungsmodell HTTP b XL o CLIENT o SERVER HTTP Pucynok 1 Kommunikation zwischen Parallels Panel und einer Drittanbieter Client Software Der Server ist in dem Fall der Panel API RPC Server nachfolgend der Server der ein Bestandteil des Panels ist Die Client Software sollte von einem Drittanbieter stammen Das Kommunikationsszenario stellt sich wie folgt dar 1 Die Client Anwendung erstellt ein XML basiertes Abfrage Paket nachfolgend API RPC Paket oder das Paket f gt einen Standard HTTP Header hinzu und sendet diesen an den Server 2 Der Server empf ngt das Paket validiert dieses und ruft interne Panel Funktionen auf um die angeforderten Operationen durchzuf hren 3 Der Server erstellt das Antwortpaket das die notwendigen Informationen zu der durchgef hrten Operation enth lt und sendet es zur ck 4 Der Client erh lt dieses Paket mit dem Status zum Operationsstatus und eventuell eine Fehlermeldung oder die Operationsparameter und ruft diese Informationen ab Die Kommunikation endet Unterst tzte API Versionen Die aktuelle Version des Panels unterst tzt die AP RPC Protokollversion 1 6 2 0 Einrichten ber Remote API 53 API RPC Pakete Ein API RPC Paket ist ein einfaches XML Dokument das in
79. LKSEavrcmMFc98i12fmbbNp tckeLHfzVYtxX8CgYEAyP6X39YsSEIHRx4s08IvU 3j589fnPjo7GxinPZFU3SKOJWtROdsKIurAmVNWFrA6lgkh3xCIEqqOVklyv On5k NsXNj aWPLYyReOxcRcRmudtKelu zxAJW 1Sb70R4QD6arzvAmbIFb7C8wL1Gpc9 es91f9pe88kF4JACIx1j PaECgYEA 4sWtwl ZbsJwygZ3YAOVKUWi8OdNXLVx R2X XmVjokgCi2rGo5hszLivi6mBFOwgvtjTsZJ 1Mg4z6i g8sosONJASOVHXXfWnIE 4 Oz AG Einrichten ber Remote API 131 f9Zxu4Xf5Q4S6cX f R4cZAhcvsPH6Wf RpZ9TxYTq3FE2uk8cTxfxIF3kYjNwF70 ma6YXQcCgYEApqdVVr92YSYZuDTKYGN5Rd5BaJSGPYWpShS51PKBQ4n TkSZzOlv Bxq2AbPRohXasWEAdfgfsslmcwX 9xnKO DhnxXE8KVFXKVehGmUthOWgA5qtL4xD h4hm3V7DcMgYbVzpm1WXFz5IslfIflAhlfex4h3slrirTj T6hoDvf4 a7 END RSA PRIVATE KEY lt pvt gt SER re gt gt gt BEGIN CERTIFICATE Di TCCAnNECBETUDecwDQOY JUKoZ IhvcNAQEEBOAwgYgxC zZAJUBGNVBAYTALJVMOww CgYDVOOIEwWNOUO8SxDDAKBINVBACTAOSTSZEUMBIGALUEChMLRGFEYWALIELUYy4x CzAJBgNVBASTALFBMRcWFOYDVOODEw53Sd3cuc3dzb2Z0LmNvVbTEhMBSGCSqQGSIb3 DORJARYScmJ1c31lndWluQHBsZXNrLnJ1MB4XDTA2MDgwNTAZMTgwMVoXDTA3
80. MDgw NTAZMTgwMVowgYgxCzAJBgNVBAYTALJVMOwwCgYDVOOIEWNOUOSxDDAKBINVBACT AOSTSZEUMBIGA1LUECHMLRGFEYWALIELlUYyAxCZAJBIQNVBASTALFBMRCWFOYDVOOD Ew53d3cuc3dzb2Z0LmNvVbTEhMBSGCSqQqGSIbD3DOEJARYScmJ1c31lndWluoHBsZXNr LnJ1MIIBIJANBgkqhkiG9w0 BAQEFAAOCAQ8AMI IBCgKCAQEAyxfczy4HqgwOl 6yx BatdLaMLe5zC0ijcawsha8oFtJ1lxv DM9INpdKjv9HaInrR0StjJG9HggTpYrhocd xeB07 gGsQ82xsvbcKANuCSQKInpwVimGUsisGNrfnbKI oAewN21ENCZQrufcONW NzTx GjVCXqa Sy4pXJ 6Jud0dzA VisSBw50041 qi 2MDvuoDk exQLdgM45Vvgq4 d3A9 ES zmRmjmdovhNxnXdvMxA5RSrF GZ1BTFftsLOsnfnNiMR6ZTFgGNCt2vdDm UAV911IX2B1PUOH9ATRCIRGStTVCFEFVZSRJ042Z01Us5 7 efb30e56Lb6AUbI9YZRZN hAkGLwIDAOABMAOGCSQGSIbD3DOEBBAUAAATBAOBH8MTX303CSBUjZwf fy3kIVobgh yE11j00870v5rht5yktuTyS30GXsDD0s0 uSG akL34CTPkj1 vqYtzKMsfO5pxyY 1Y6Q0 GCd9FgL5pBn1S8HSZLpTBWZc2 5mNe 3mxXbCQOz103r4W dQajAgAgDKpnRig mb1Rg98 HwOL0 33pVgUnRwPoS 3L05j1a5z3FOMkS8sV3x18DuoSLeVILhj0ttZ p B7x0kIUee8A95Q00EDh 4 TaPSMOgiFrVI1SHEUPV33aCAz2Dk2TxzplsoNz61BFA 13Cm04Gz1h9W yzkcYCqiwUMI zSgUSBLn0hBeTidlu NaDtic776YGuyalI END CERTIFICATE lt cert gt
81. OcDovL3d3dy5pbnRicnNwaxJILmNvbS9rbm93bGV kZ2VtYW5hZ2VyLzwvcHAtc2 1iLX VuaxgtMTA6Y XBzLW FwcD4gDQotlDxkc2InOINpZ25hdH Einrichten ber Remote API 97 VyZSB4bWxuczpkc2InPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjlj4NCi OgPGRzaWc6U2InbmVkSW5mbz4NCiAgPGRzaWc6Q2Fub25pY2FsaxphdGlvbk1 IdGhvZC BBbGdvcml0aGO9ImhOdHA6Ly9wyY XJhbGxlbHMuY 29tL3NjaGVty XMva2V5cy9jb3JILZMjY2 Fub25pY2FsaxplliAvPIANCiAgPGRzaWc6U2InbmF0dXJITW VOaG9kIEFsZ29yaXRobT0iaH ROcDovL3d3dy53My5vcmcvMjAWMS8wNC94bWxkc2InLW1vemUjcnNhLXNoYTI1NilgLz4gD QotIDxkc2InOldIZmVyZW5jZSBVUkk9Ilil DQotlIDxkc2InOIRyYW5zZm9ybXM DQogIDxkc2in OIRyYW5zZm9ybSBBbGdvcml0aGO09IlmhOdHA6Ly93d3cudzMub3JnL1 RSLZIWMDEVvUkKVDL XhtbC1jMTRuLTIWMDEwM zE1I1dpdGhDb21tZW50cylgLz4gDQogIDxkc2InOIRyYW5zZm9y bSBBbGdvceml0aGO9IlmhOdHA6Ly9wY XJhbGxlbHMuY29tL3NjaGVtY XMva2V5cy9jb3JILZMj dHJhbnNmb3utliAvPIANCiIAgP C9kc2InOIRyYW5zZm9ybXM DQogIDxkc2InOkRpZ2VzdE 1Id GhvZCBBbGdvcml0aG09ImMhOdHAGELy93d3cudzMub3JnLzZIWwMDEvMDQveG1sZW5jl3NoYT 1 NilgLz4gDQogIDxkc2InOkRpZ2VzdFZhbHVIPIRrUzk2YnlycEpVdTVpUTdlbkhZYUhhMT Ira 2IPYmMZhRXBYMC9TWUSIV2M9PC9kc2InOkRpZ2VzdFZhbHVIPIANCiIAgPC9kc2InOldIZmV yZW5jZT4NCiAgPC9kc2InOINpZ25 1ZEluZm8 DQogIDxkc2InOINpZ25hdHVyZVZhbHVIPmZ vcUxYVFErTWhRUm44Y2NzSmdoU1 ZhNUJUVi9kaUtaV GJjdk9qUnBXcW5XaDIXei9NQmF KYOpDNnFnZUNKMHJ40FZsWERxcm0yVUYgS111 d0dWeFM1 ZSt6NWNqREFEcVUyRStG OXRaUndubXRuamZ4dHVOTHZibj VySOFYc1 VtWTQ20U1 EcjNQeFRYbI9MYjZycmpvbGZO OCBOWVE1WUVtMDkyd3IrWTg2T GNIVkhKM2ZXK01sQWd3W Xpua0lzdFVQSE1JMVVkyYI g
82. Panels 15 parallels_ installer select release id PPSMBE_10 2 0 install everything enable xml output Beispiele Windows 1 Mithilfe des folgenden Befehls installieren Sie Parallels Small Business Panel 10 2 Release ID ist PPSMBE_10_2 0 WIN ber den Mirror des Servers der ber HTTP auf dem Host ppsmbe mirror example com zur Verf gung steht Die Installationsdateien werden vor bergehend in dem Ordner 3SystemDrive Parallels gespeichert und der Statusbericht der Installation wird an die E Mail Adresse admin example com versendet Folgende Komponenten werden installiert Panel Basispakete Bind Nameserver MailEnable Mailserver PHP Scripting Engine Site Editor und Horde Webmail parallels installer exe source http ppsmbe mirror example com target SystemDrive Parallels select release id PPSMBE 10_2 0 _WIN install component base install component dns install component mailenable install component php5 install component siteeditor install component webmail notify email admin example com 2 Mit den folgenden Befehlen wird die Installation alle verf gbaren Produktkomponenten werden installiert von Parallels Small Business Panel 10 2 Versions ID PPSMBE_10_2_0_WIN ber den Parallels Update Server abgeschlossen Eine Ausgabedatei des Installers wird im XML Format erstellt parallels installer exe select release id PPSMBE 10_2 0_WIN install everything enable xml output Installer CLI Befehle Gekurzt In diesem A
83. Program Files Parallels Plesk tmp li_9D tmp lt filename gt lt import package gt lt aps gt lt packet gt Einrichten ber Remote API 165 Struktur des Antwortpakets Der import package Knoten des ausgegebenen XML Pakets ist wie folgt strukturiert APSPackagelmportOutputType resultType extension Result status ok error import package occurred Error message if error occurred Lt ns Error code if error mu result erforderlich Verpackt die vom Server abgerufene Antwort Datentyp resultType common xsd status erforderlich Gibt den Ausf hrungsstatus der Operation an Datentyp string Zul ssige Werte ok error errcode erforderlich falls die Operation fehlschl gt Gibt den Fehlercode wieder Datentyp integer errtext erforderlich falls die Operation fehlschl gt Gibt die Fehlermeldung wieder Datentyp string package id erforderlich falls die Operation erfolgreich abgeschlossen wird Gibt die ID an die dem Paket auf dem vom Panel verwalteten Server zugewiesen wurde Datentyp id_type common xsd 166 Einrichten ber Remote API Antwort Beispiele Eine positive Antwort vom Server sieht wie folgt aus lt packet version 1 6 2 0 gt lt aps gt lt import package gt lt result gt lt status gt ok lt status gt lt package id gt 13 lt package id gt lt result gt lt import package gt lt aps gt lt packet gt Folg
84. SMBE lt Version gt z B PPSMBE 10 2 0 wo sich die Panel Pakete befinden b SETEMPLATES lt Version gt z B SETEMPLATES 1 0 0 wo Pakete f r mehr als 200 weitere Site Design Templates f r die Site Editor Komponente gespeichert sind Es handelt sich eigentlich nicht um ein Produkt sondern um eine Komponente des Panels die sich in einem separaten Produktverzeichnis befindet um Speicherplatz und Traffic zu sparen Jedes dieser Unterverzeichnisse enth lt die folgenden Dateien dist lt Typ gt lt Name des Betriebssystems gt lt Version gt lt Architektur gt Enth lt Distributionspakete des Panels oder die Design Templates z B dist deb Debian 5 0 x86 64 oder dist deb Debian all all update lt Typ gt lt Name des Betriebssystems gt lt Version gt lt Architektur gt Enth lt System Udates f r das Betriebssystem des Servers lt Typ gt bezeichnet den Pakettyp rpm deb pkg thirdparty lt Typ gt lt Name des Betriebssystems gt lt Version gt lt Architek tur gt Enth lt weitere Pakete von Drittanbietern lt PRODUKTNAME gt lt Parallels Panel Version gt lt Name des Betriebssyste ms gt lt Architektur gt inf3 Konfigurationsdateien des Parallels Installers z B ppsmbe 10 2 0 susell 1 x86 64 inf3 setemplates 1 0 0 deball all inf3 products inf3 Die Konfigurationsdatei des Parallels Installers welche die Panel Produkte
85. Struktur des Antwortpakets uuuum444444n4nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 104 ANDNOR BEIspie er un n eneneeeinenien 105 Struktur des Abfrage Pakets Um ein neues SOA Record Template einzurichten erstellen Sie ein neues XML Abfrage Paket das den dns set Kontrollknoten enth lt und wie folgt strukturiert ist SOAType mmm m ml Einrichten ber Remote API 103 soa erforderlich Gibt die SOA Parameter an Datentyp SOAType plesk_dns xsd ttl optional Gibt den Parameterwert tt1 an Das Panel legt als Standardwert einen Tag fest Datentyp unsignedint refresh optional Gibt den Parameterwert refresh an Das Panel legt als Standardwert drei Stunden fest Datentyp unsignedint retry optional Gibt den Parameterwert retry an Das Panel legt als Standardwert eine Stunde fest Datentyp unsignedint expire optional Gibt den Parameterwert expire an Signiert 32 Bit Wert in Sekunden Das Panel legt als Standardwert eine Woche fest Datentyp unsignedint minimum optional Gibt den Parameterwert minimum an Das Panel legt als Standardwert drei Stunden fest Datentyp unsignedint Beispiele f r Abfragen Dieses Paket aktualisiert ein SOA Record Template so dass es den TTL Time to Live Intervall auf 32 Stunden einstellt den Aktualisierungs Refresh Intervall auf 6 Stunden und den Erneut versuchen Retry Intervall auf 15 Minuten Die Panel Standardwerte f r die Intervalle
86. Subdomain 229 Verf gbare Pakete abrufen uuum44444444nnnnnnnnnnnnnnnnnnnnnnnnnnannnnnnnnnnnannnnnnnnn 233 Einrichten ber CLI 229 Installieren einer Anwendung auf einer Domain oder Subdomain Um ein hochgeladenes Anwendungspaket auf einer Domain Subdomain zu installieren verwenden Sie den Befehl im folgenden Format aps lt install i gt lt lt filename gt gt lt lt package id lt ID gt gt lt package name lt name gt package version lt version number gt package release lt release number gt package vendor lt vendor name gt package packager lt packager name gt gt gt lt lt domain lt domain name gt gt lt subdomain lt subdomain name gt gt gt installation options wobei der Teil lt filename gt verantwortlich ist f r die Angabe der Anwendungseinstellungen im XML Format auf Seite 231 sofern die Anwendung ber welche verf gt Die Einstellungsdefinition wird als Befehlsparameter angegeben entweder als Dateiname oder direkt in dem Befehl der von STDIN abgefragt wird In dem zweiten Fall sollte als Befehlsargument angegeben werden Details zu dem Format der Einstellungsdefinition finden Sie in dem Unterabschnitt Einstellungsdefinition f r Anwendungen auf Seite 231 der Teil lt package id lt ID gt gt lt package name lt name gt package version lt version number gt package release lt release number gt package ve
87. WLXNtYiT 1bml4LTEwOnNtYil 1c2Vycz4gDQotIDwhLS0g TnVtYmVylG9mIGRvoWFpbnMNCiAgLSO IAOKICA8cHAtc21iLXVuaxgtMTA6ZG9tYWlucyB jb3JlIOnR5cGU9ImludGVnZXIliPjJE8L3BwLXNtYi1 1bml4LT EwOmRvbWFpbnM IA0KLSA8ISO tlIEFiaWxpdHkgdG8gdXNIIFNwYW1Bc3Nhc3Npbg0KICAtLT4gDQogIDxwcC1 zbWItdW5peC OxMDpzcGFtY XNzY XNpbi1zdXBwb3J0IGNvcmU6dHIwZTO0IYm9vbGVhbil dHJ1ZTwvcHAtc 21iLXVuaXgtMTA6c3BhbWFzc2FzaW4tc3VwcG9ydD4gDQotIDwhLSOgQVBTIEFwcGxpY2F OaW9uDQogICOtPIANCiAgPHBwLXNtYil 1bml4LTEwOmFwcy1hcHAgY29yZTp0eXBIPSJzd HJpbmciPmhOdHA6Ly93d3cubW FnaWNzcGFtLmNvbS88L3BwLXNtVil 1bml4LTEwOmFwcy 1hcHA IAOKLSA8ISOtIEFQUyBBcHBsaWNhdGlvbgOKICAtLT4gDQog IDxwcC1 zbWItdW5pe COxMDphcHMtY XBwIGNvcmU6dHIwZTOic3RyaW5dnlj50dHRwOi8vd3d3LnBpbm5dhY 2xlY2Fy dC5jb20vPC9wcC 1zbWItdW5peC0xMDphcHMtYXBwPiANCIOgPCEtLSBBUFMgQXBwbGIjY XRpb24NCiAgLS0 IAOKICA8cHAtc21iLX VuaxXgtMTA6Y XBzLWFwcCBjb3JlIOnR5cGU9InNO cmluZyl aHROCHM6Ly93d3cua2VicGIOLmMNvbS91bmxpbWI0ZWQ8L3BwLXxNtYi1 1bml4LTE wOmFwcy1hcHA lIAOKLSA8ISOtlIEFQUyBBcHBsaWNhdGlvbgOKICAtLT 4gDQog IDxwcC1zb WItdW5peCOxMDphcHMtYXBwlGNvcmU6dHIwZT Oic3RyaW dnlj50dHRwOi8vd3d3LnN5bW FudGVjLmNvbS9ub3J0b24vaW50ZXJuZxX Qtc2VjdXJpdHk8L3BwLXNtYil 1bml4LTEwOmFw cy1hcHA IAOKLSA8ISOtIEFQUyBBcHBsaWNhdGlvbgOkKICAtLT4gDQog IDxwceC1zbWItdW5 peCOxMDphcHMtyY XBwIGNvcmU6dHIwZTOic3RyaW 5dnlj50dHRwOi8vd3d3LmludGVyc3Bpc mUuY29tL2VtYWIsbWFya2VOZXIvPC9wcC 1zbWItdW5peC0xMDphcHMtYXBwPiANCIOgPC EtLSBBUFMgQXBwbGljYXRpb24NCiAgLS0 IAOKICA8cHAtc21iLXVuaXgtMT A6YXBzLWF wcCBjb3JlOnR5cGUY9InNOcmluZyl aHR
88. ZMTO0dPam82Kzg2M0dUbDJUOXA0dGxGIHZHNWhOMWFpNHkybDdOVzFTczhVT1J ScIVIMENBdOVBQVRBTkJna3Foa2IHOXcwQkFRVUZBQU9SDQWdF QUgrcnFFdkhNdEFRa StWOHEgSDdFM3VSRk8xaVA1 QzBVejIDQVdMZOQyNWthWTISaUV1K1ZNcGtyZ2RwWMkR KZUxlaWd5Q3MyM3dUbkZ6SS9qMUJNRjJ1 VGdKS1 BEMiIBSOTA2YVcyROtUWWplencvd3 BmUDUxck9CWTVQNIhpdXNtM2NGdk8z TnJ4Z0hJSy9WV3N5WW1EN25mMksyZUptQmsv ZU85TklaalBoIGRkS2NrYmNZRVhRN3dzd2l0dDIYcT Fuckg2eFNXT 1IIVUUwcHIOQW1jVXc3 TDdRQVUzdDBVMOIIQZNHYmVyVE1RNERSL2xDTFV5a24gUkI3aDNKQXZkY VFJZnA2TW 9yNkYOVWtrMWh2bzkwVT R1VHFEbXc4RFJHcVRoOCtPUEY1V1dTLOMyKOo0ObThOWTND WjZpa3FIcOFpcCB5Si9uR 1 pqU3cvdHc4NOxMWHBMMzJhRkFLcGpjOGc1 MkZuc3YzVDIwdj RHd0Q2VOhHYU1DNUVsL21 XSWpISE5pLytPTk5hbkdHbHUxIHVLQ1p2UktHenJRNjV4bHly eEovT XFTWDV3cWdTK3R5SE1 XY3BwVFpZdmF6cXZtZF RUbIINWIhwd1M1YWxqQlAwb3F Wd09wVDFLUksgY003bXVaYZNUWIJ 1 OHY0b2pWal dWTIF2ZQVNUUFNsdXFkcW42RFdw V2V3UEQ0ZXg3c2ZJam52N1 phWmiZV2tPL3VDam9SeE4wbomFtVSBIVk5QemZSNXJ5em Vjalozb0g0L1NXTGFYeHFiQ2k0QzBjMFIVeTZBMkZkej VKK3RwWW UdFbkVFMENpcDFyRjVn MFJhMURBZXV4ZFFalEMwang3NINsQ1 VjSWhGQ0p4RmRxMk5JMHZJVnIVNTIGR2NrY3E 98 Einrichten ber Remote API 3WVZZVIW2czNVc2crb1pNRTBKbTFIPTwvZHNpZzpYNTA5Q2VydGlmaWNhdGU IAOKICA 8L2RzaWc6WDUWOURNdGE DQog IDwvZHNpZzpLZxlJomZvPgOKICA8L2RzaWc6U2Inom FOdXJIPgOKICA8L3BwLXNtYii 1bml4LTEwOmtleT4 lt license gt lt lic_install gt lt server gt lt packet gt Dieses Abfrage Paket installiert einen zus tzlichen Lizenzschl ssel Bitte beachten Sie dass der Inhalt des license Knotens ein g
89. aMLe5zC0ijcawsha80FtJ1lxv DM 9INpdAKjv9HaInrROStjG9HggTpYrhOcJxeB07 9gGs082xsvbcKANUCSOKInpwVim GUsisGNrfnbKIoAewN21ENCZQrufcQNWNzTx GjVCXqa Sy4pxXJ6Jud0dzA Vis XAvMxA5SRSrE RGStVCFt Vzs OAQr31mK YRU Ih et S Pwo WW un Bw5004Ig12MDvuoDk texQLdgM45Vgq4d3A9 ESZzmRmjmdovhNx GZ1BTFftsLQOsnfnNiMR6ZTFQNCt2vdDmUAV9iixX2BLPUOH9ATRC RjJ04Zz0iUs57efb30e5 6Lb6 4Ubi 9ZRZNhdkGLwI DAQABAoI BABJ SzaUMJw9z 3 cMZcF41I YW1LDvTxVW6nFdmLttwlreTcjuLrRCmryKxtT k9c2NaNn DygrYaeJP GmxIc5S 8B1WJg 8BiUEQO3TONUa 400ZEKKXAZApO131NEUBOXGtiV8p6 SMN5MCBowkq31IWifMJsVPOJj r25Pbhy04HCPeeM cnEi PnMrBjK40GH8 pkKgqedf05 EcjnFKGFP2GOBUEhHLX700MhB AbjoIbGFX1BI zhaofs8zzSjJNkKJ9i4LOMBRe0GDF zCgE4GehW FdAcUlh6G1207F0Jc0OLAVUR4AdeoMzZaiNRIwdWxbokVwgSEnM20yXYdCl t dsREECgYEA sNPkZdOCOvFeme 6WO8EqMu 6AbPJObKnw0i18 g8ndRkKMCJOSFEXD D447 CMORUdQGFH8 aMWDp3 92 ZAJX3S ksSNIXLYEEKBSfsknENSDZKVJvVh9U gUD DO12mC1P1leQBHBIN7W1sg4mPZNv3cxKUQLhFU0qW moQdy0UrDfv 5 LECGYEAz 1Ww OJolOjKhPkGxiDY9sh95E rpuwkGjbOqiS UFHHULC9PDYHyKRpPggqdTAnEuBz34 cRpihMgxBKEzuXGEPvdIST0a0ObOwcgqf Y4HAJ8 PSO08rZupCJsk413gYel ckXacQK bYYH
90. ad Transaktion ab lt packet version 1 6 2 0 gt lt aps gt lt get download status gt lt filter gt lt get download status gt lt aps gt lt packet gt Beispiel A Folgende Antwort wird von einem Linux Server empfangen wenn eine Transaktion mit drei Tasks ausgef hrt wird ein Task ist bereits beendet einer ist in Bearbeitung und einer befindet sich in der Warteschlange lt packet version 1 6 2 0 gt lt aps gt lt get download status gt lt result gt lt status gt ok lt status gt lt filter id gt 10 lt filter id gt lt id gt 10 lt id gt lt task gt lt id gt 10 lt id gt lt finished gt lt package id gt 5 lt package id gt Einrichten ber Remote API 183 lt finished gt lt task gt lt result gt lt result gt lt status gt ok lt status gt lt filter id gt 11 lt filter id gt lt id gt 11 lt id gt lt task gt lt id gt 11 lt id gt lt in progress gt lt total gt 3584225 lt total gt lt completed gt 2458 lt completed gt lt current gt lt in progress gt lt task gt lt result gt lt result gt lt status gt ok lt status gt lt filter id gt 12 lt filter id gt lt id gt 12 lt id gt lt task gt lt id gt 12 lt id gt lt in progress gt lt total gt 45888236 lt total gt lt completed gt 0 lt completed gt lt in progress gt lt task gt lt result gt lt get download status gt lt aps gt lt packet gt Antwort B Fo
91. aller folgenderma en hei t parallels installer Die offiziellen Parallels Small Business Panel Repositorys sind autoinstall plesk com Linux Unix Pakete und autoinstall win parallels com Windows Pakete Sie sollten benutzerdefinierte Mirrors auf Seite 27 der Panel Repositorys innerhalb Ihrer Hosting Umgebung einrichten um Zeit und Traffic zu sparen und um die Installation zu sichern In diesem Abschnitt Release ID abfr gen nun ee 11 Liste mit den Produktkomponenten abfragen sss4444 44 nnnnnnnnnnnnnnn nenn 12 Installieren des Panels rn era 14 Installer CLI Befehle Gek rzt 4444444440nnnnnnnnnnnnnnnnnnnnnnannnnnnnnnnnnnn 15 Installationsskript in Unger ean E 18 Verteilung des Panels 11 Release ID abfragen Die Release ID ist eine eindeutige ID der Panel Version zum Beispiel Parallels Small Business Panel 10 2 F hren Sie den folgenden Befehl aus um eine Liste mit allen Release IDs abzufragen parallels installer show all releases auf einem Linux Unix Server parallels installer exe show all releases auf einem Windows Server Es ffnet sich eine Liste mit den Produkt Versionen Beispiel PPSMBE_10_2_0 Parallels Small Business Panel 10 2 0 12 Verteilung des Panels Liste mit den Produktkomponenten abfragen Um eine Liste mit den Komponenten dieser Release zu erhalten f hren Sie den Befehl in dem folgenden Format aus parallels_installer s
92. als auch in Einzelplatz Installationen ab Zudem beinhaltet dieses Kapitel einen erg nzenden Abschnitt in dem n her auf die Erstellung von benutzerdefinierten Mirrors des Update Repositorys von Parallels Small Business Panel eingegangen wird 7 In den folgenden drei Kapiteln geht es um die Setup Phase in der Panel Bereitstellung Das Kapitel berblick zu Setupvorg ngen erkl rt die Bedeutung und den Umfang von Setup Vorg ngen Das Kapitel Einrichten ber Remote API konzentriert sich auf das Einrichten des Panels mittels Remote XML API Das Kapitel erkl rt die RAPI Remote API bietet einen berblick zu dem API RPC Protokoll und nennt beispielhaft Tools die verwendet werden k nnen um mit dem Panel Server ber das Protokoll zu interagieren Anschlie end wird im Detail beschrieben welche Abfragenachrichten ein Drittanbieter Tool versenden muss um Panel Vorg nge durchzuf hren und welche Nachrichten nach jedem Vorgang empfangen werden Das Kapitel Einrichten ber CLI konzentriert sich auf das Einrichten des Panels Uber die Befehlszeilenschnittstelle des Panels Abk CLI Command Line Interface Das Kapitel bietet zuerst einen berblick ber die Grundlagen der CLI und beschreibt anschlie end ausf hrlich welche Befehle ausgef hrt werden m ssen um Panel Setupvorg nge durchzuf hren KAPITEL 2 Anmerkungen zum Bereitstellungsworkflow Bei der Bereitstellung des Parallels Small Business Panel f r Windo
93. ame oder subdomain id oder subdomain name ist erforderlich domain id optional Gibt die ID der Domain an auf der die Anwendung installiert werden soll Datentyp id_type common xsd domain name optional Gibt den Namen der Domain an auf der die Anwendung installiert werden soll Datentyp string subdomain id optional Gibt die ID der Subdomain an auf der die Anwendung installiert werden soll Datentyp id_type common xsd subdomain name optional Gibt den Namen der Subdomain an auf der die Anwendung installiert werden soll Datentyp string Entweder package id oder package ist erforderlich Hinweis W hrend der aps get packages list Operation auf Seite 200 werden die Informationen zu einem Paket ermittelt package id optional Gibt die Paket ID von dem Server an von dem eine Anwendung installiert werden soll Datentyp id_type common xsd package optional Beinhaltet eine Reihe an Daten die das Paket auf dem Server beschreiben von dem aus eine Anwendung installiert werden soll Datentyp APS dentifierType aps xsd sehen Sie die Typdefinition unten ssl optional Gibt an ob eine Anwendung ber das HTTPS Protokoll zur Verf gung steht oder nicht Datentyp boolean Falls nicht angegeben ist die Anwendung ber HTTP verf gbar url prefix optional Gibt die zur Domain Subdomain zugeh rige URL an ber welche die installierte Anwendung im Internet verf gbar sein wird Datentyp APSUrlPrefixType
94. an PPSMBE10 rsync au delete rsync rsync autoinstall plesk com autoinstall ubuntu PPSMBE 10 2 0 destination_directory ubuntu PPSMBE10 Dieser Befehl erstellt einen symbolischen Link f r die Installation des Panels mithilfe von Parallels Containers EZ Templates auf RPM basierten Betriebssystemen Falls Sie einen Mirror f r eine Umgebung ohne Parallels Containers einrichten lassen Sie diesen Schritt aus cd destination directory ln s PPSMBE 10 2 0 PPSMBE10 Mithilfe dieses Befehls k nnen Sie die Konfigurationsdateien des Parallels Installers herunterladen rsync auv delete rsync rsync autoinstall plesk com autoinstall products inf3 autoinstall versions inf3 autoinstall ppsmbe inf3 autoinstall setemplates inf3 destination directory 5 Bearbeiten Sie die Konfigurationsdateien des Parallels Installers um festzulegen welche Produkte Versionen und Plattformen vom Mirror unterst tzt werden sollen a Bearbeiten Sie die Datei products inf3 und entfernen Sie alle product Elemente bis auf die mit der ID ppsmbe Lassen Sie auch das product Element mit der ID setemplates aus wenn das zus tzliche Set an Site Design Templates f r Site Editor unterst tzt werden sollen b Bearbeiten Sie die Datei ppsmbe inf3 und entfernen Sie alle Build Elemente bis auf die f r Betriebbssysteme und Architekturen die vom Mirror unterst tzt werden sollen c Bearbeiten Sie die Datei setemplates inf3 und entfernen Sie alle Bui
95. ation object sender ValidationEventArgs e Console WriteLine Validation error 0 e Message static void PrintResult XmlDocument document XmlTextWriter writer new XmlTextWriter Console Out writer Formatting Formatting Indented document WriteTo writer writer Flush Console WriteLine VB NET Client Anwendung Die folgenden Code Beispiele stellen eine einsatzbereite Client Anwendung dar die in VB NET geschrieben wurde Kommentare Die Request Klasse versendet ein Abfrage Paket an den vom Panel verwalteten Server per HTTP und empfangt das Antwortpaket Es enthalt die folgenden Elemente public string Hostname Beinhaltet den Host Namen IP Adresse des vom Panel verwalteten Servers an den das Abfrage Paket versendet wird StandardmaBig handelt es sich dabei um localhost public string Login Beinhaltet den Login des Panel Administrators Standardm ig handelt es sich dabei um admin public string Password Beinhaltet das Passwort des Panel Administrators Standardm ig handelt es sich dabei um setup 80 Einrichten ber Remote API publie Sezing Prococol public XmlSchemaValidation Public ReadOnly Property AgentEntryPoint Public ReadOnly Property InputValidationSchema Public ReadOnly Property OutputValidationSchema Public Function Send ByVal packet As XmlDocument Public Function Send ByVal packet As Stream Pu
96. beschreibt ppsmbe inf3 setemplates inf3 Konfigurationsdateien des Parallels Installers die unterschiedliche Versionen des Panels und weitere Komponenten beschreiben PPSMBE10 Parallels Small Business Panel Metadaten die f r die Installation des Panels innerhalb von Parallels Containers mithilfe von EZ Templates ben tigt werden Verteilung des Panels 29 debian ubuntu Verzeichnisse die als apt get Repositorys f r die Installation von Parallels Produkten mithilfe von EZ Templates und dem Parallels Installer verwendet werden So erstellen Sie einen Mirror f r das Panel Melden Sie sich an dem Server an auf dem der Mirror eingerichtet werden soll Erstellen Sie ein Verzeichnis in dem die Dateien abgelegt werden sollen Zur Veranschaulichung nennen wir dieses Verzeichnis destination directory Erstellen Sie in diesem Verzeichnis zwei Unterverzeichnisse debian und ubuntu F hren Sie die folgenden Befehle aus um einen Mirror einzurichten Mit diesem Befehl k nnen Sie das Verzeichnis PPSMBE 10 2 0 aus dem Parallels Updates Repository in das Verzeichnis destination directory herunterladen rsync au delete rsync rsync autoinstall plesk com autoinstall PPSMBE_ 10 2 0 destination directory Mit diesem Befehl k nnen Sie das Verzeichnis SETEMPLATES 1 0 0 aus dem Parallels Updates Repository in das Verzeichnis destination directory herunterladen rs
97. blic Function Send ByVal packetUri As String Private Function SendRequest ByVal message As SEICE Private Function ParseAndValidate ByVal xml As TextReader ByVal schemaUri As String Private Function GetResponse ByVal request As HttpWebRequest Beinhaltet die Version des API RPC Protokolls das f r die Kommunikation mit dem Panel verwendet wird Der verwendete Handler f r den Empfang von Schema Validierungsfehler Beinhaltet die URL des Panel Agents der das Abfrage Paket auf der Server Seite verarbeiten wird Beinhaltet die URL des Validierungsschemas die in dem Abfrage Paket bernommen wird bevor es an die Server Seite versendet wird Beinhaltet die URL des Validierungsschemas die in dem Antwortpaket bernommen wird bevor es auf der Client Seite empfangen wird Leitet das Abfrage Paket in Form des XmilDocument Objekts an die Eingabe Parameter weiter Versendet eine Anfrage und erh lt die Antwort in Form des XmIDocument Objekts Leitet das Abfrage Paket Stream an die Eingabe Parameter weiter Validiert das Abfrage Paket mithilfe des Validierungsschemas Ruft die Elementfunktion Send XmlDocument auf Leitet die URI des Abfrage Pakets XML Datei an die Eingabe Parameter weiter Validiert das Abfrage Paket mithilfe des Validierungsschemas Ruft die Elementfunktion Send XmlDocument auf Formt eine HTTP Abfrage bertr gt den HTTP Header und das serialisierte XML Paket auf das Objekt des Ty
98. bschnitt werden die CLI Befehle des Parallels Installers aufgef hrt die nur f r die Installation des Panels ber die Befehlszeilenschnittstelle CLI relevant sind Sie erhalten weitere Informationen zu Optionen die wichtig f r ein Upgrade eines bereits installierten Panels oder des Host Betriebssystems sind indem Sie den folgenden Befehl ausf hren parallels_installer help Option Beschreibung und m gliche Argumente source lt Pfad gt lt URL gt Wenn Sie die Panel Pakete von einem lokalen Dateisystem abfragen geben Sie die Option source ein um auf die Datei inf3 zu verweisen die die Informationen zu dem zu installierenden Panel Build enth lt Wenn Sie die Panel Pakete von einem Netzwerk Server abfragen geben Sie die Option source lt URL gt ein um auf das Verzeichnis zu verweisen wo sich die Kopie Mirror des Panel Update Servers befindet 16 Verteilung des Panels Option target lt Pfad gt Beschreibung und m gliche Argumente Standardm ig speichert der Installer die abgefragten Dateien in dem Verzeichnis lt aktueller Benutzername gt psa Beispiel Wenn der Installer von einem Benutzer ber den Root Account ausgef hrt wurde wird z B das Verzeichnis root psa erstellt und verwendet Falls Sie ein benutzerdefiniertes Verzeichnis zum Speichern der abgefragten Dateien festlegen wollen verwenden Sie die Option target Beispiel target opt storage psa _ ODER tar
99. cklinks DNS Konfiguration per Remote API auf Seite 100 DNS Konfiguration per CLI auf Seite 213 In diesem Abschnitt ndern des SOA Record Templates cccccccssssescscsssssscsesssseecsesseeeesaeseeneeeaees 41 Einrichten von Templates f r Ressourceneintr ge Resource Records 41 berblick zu Setupvorg ngen 41 ndern des SOA Record Templates Sie k nnen in dem Panel Template f r den SOA Record folgende Eintragsfelder ver ndern ttl Time to Live Refresh Aktualisieren Retry Wiederholen Expire Ablauf inimum nur Unix CLI sn Seriennummer Format Format der Zonen Seriennummer yyyymmdd oder Unix Timestamp Einrichten von Templates f r Ressourceneintr ge Resource Records Das Panel Template der DNS Zone unterst tzt die folgenden Ressourceneintragstypen A NS CNAME MX PTR TXT AXFR SRV 42 berblick zu Setupvorg ngen Installation von SSL Zertifikaten Um ein Secure Sockets Layer Protokoll f r eine Domain zu bernehmen muss zuerst ein SSL Zertifikat installiert werden In dem Panel werden SSL Zertifikate mit Domains ber IP Adressen verbunden ein Zertifikat wird einer IP Adresse zugewiesen und dieses Zertifikat wird verwendet wenn auf eine Domain zugegriffen wird die auf dieser IP gehostet wird In der Tat wird das Zertifikat verwendet wenn versucht wird ber https auf alle Domains zuzugreifen die auf dieser IP gehostet werden Um ein SSL Zertifikat zu in
100. den sollen Datentyp none Falls hier keine Angaben stehen empty werden Informationen zu allen auf dem Server verf gbaren APS Paketen in dem Antwortpaket angegeben package id optional Gibt die ID des Pakets an dessen Informationen abgerufen werden sollen Datentyp id_type common xsd Beispiele fur Abfragen Dieses Paket ruft Informationen zu allen Anwendungspaketen ab lt packet version 1 6 2 0 gt lt aps gt lt get packages list gt lt filter gt lt get packages list gt lt aps gt lt packet gt Dieses Paket ruft Informationen zu allen Anwendungspaketen mit den IDs 11 12 und 13 ab lt packet version 1 6 2 0 gt lt aps gt lt get packages list gt lt filter gt lt package id gt 11 lt package id gt lt package id gt 12 lt package id gt lt package id gt 13 lt package id gt lt filter gt lt get packages list gt lt aps gt lt packet gt 202 Einrichten ber Remote API Struktur des Antwortpakets Der get packages list Knoten des ausgegebenen XML Pakets ist wie folgt strukturiert get packages list I amea E KE E package E Einrichten ber Remote API 203 result erforderlich Verpackt die vom Server abgerufene Antwort Datentyp resultType common xsd status erforderlich Gibt den Ausf hrungsstatus der Operation an Datentyp string Zul ssige Werte ok error errcode erforderlich falls die Operation fehlschl gt Gibt den Feh
101. dung von dem Paket auf eine Domain oder eine Subdomain Quicklinks Installation von Anwendungen ber Remote API auf Seite 150 Installation von Anwendungen ber CLI auf Seite 225 In diesem Abschnitt Importieren eines Anwendungspakets 224444440nnnnnnnnnnnnnnnnnnnnnnnn nennen 46 Installieren einer Anwendung ss4444444444HHBnnnnnnnnnnnnnnnnnnnnnnnnnnnn nennen 46 46 berblick zu Setupvorg ngen Importieren eines Anwendungspakets Sie k nnen zwischen zwei Vorgehensweisen w hlen um ein Anwendungspaket abzurufen und zu importieren Ein Paket wahrscheinlich ein selbst erstelltes wird manuell auf den Host auf dem das Panel installiert wurde hochgeladen und dann manuell in das Panel importiert Ein Paket wird heruntergeladen und automatisch aus einem APS Katalog in das Panel importiert ein Webdienst bietet Zugang zu Remote gespeicherten Anwendungspaketen Es ist m glich mehrere Anwendungen auf einmal herunterzuladen und zu importieren Das Panel unterst tzt die Nachverfolgung des Download Status Das Panel erm glicht es zudem Anwendungspakete ber mehrere APS Katalog Instanzen abzurufen Verf gbare APS Kataloge werden in der Konfigurationsdatei des APS Katalogs auf Seite 47 definiert die an die Panel Instanz in einer bestimmten Hostingumgebung angepasst werden k nnen Installieren einer Anwendung Wenn eine Anwendung installiert wird sollten die folgenden Angaben spezifiziert werden
102. e API 85 Dim request As HttpWebRequest DirectCast WebRequest Create Me AgentEntryPoint HttpWebRequest request Method POST request Headers Add HTTP AUTH LOGIN Me Login request Headers Add HTTP AUTH PASSWD Me Password request ContentType text xml request ContentLength message Length Dim bytes As Byte New ASCIIEncoding GetBytes message Using stream As Stream request GetRequestStream stream Write bytes 0 message Length End Using Return request End Function Parsing and validating packet Private Function ParseAndValidate ByVal xml As TextReader ByVal schemaUri As String As XmlDocument Dim schemas As New XmlSchemaSet schemas Add Nothing schemaUri Dim settings As New XmlReaderSettings If Not Me XmlSchemaValidation Is Nothing Then AddHandler settings ValidationEventHandler New ValidationEventHandler AddressOf Me XmlSchemaValidation Invoke End If settings ValidationType ValidationType Schema settings ValidationFlags settings ValidationFlags Or XmlSchemaValidationFlags ProcessSchemaLocation settings Schemas schemas Dim document As New XmlDocument Using reader As XmlReader XmlReader Create xml settings document Load reader End Using Return document End Function Private Function GetResponse ByVal re
103. e Pakets Gibt das resultierende DOM Objekt zur ck function curl init Initialisiert die CURL Sitzung mit den Optionen wie folgt CURLOPT_URL benennt die Ziel URL CURLOPT_RETURNTRANS der Wert true bedeutet FER dass die resultierende Ausgabe von dem Server in Form eines Strings zur ckgegeben wird CURLOPT_POST der Wert true bedeutet dass das Paket per HTTP POST versendet wird 66 Einrichten ber Remote API function sendRequest function parseResponse function checkResponse Die main Funktion f hrt diese Funktionen in der Reihenfolge auf in der sie ber cksichtigt werden Zuerst wird domainInfoRequest aufgerufen um ein Paket wie folgt zu erstellen CURLOPT_SSL_VERIFYPE der Wert false stoppt ER CURL bei der Verifizierung des Peer Zertifikats CURLOPT_SSL_VERIFYHO der Wert false stoppt ST CURL bei der Verifizierung des Hosts CURLOPT_HTTPHEADER definiert eine Reihe von einzurichtenden Feldern des HTTP Headers Gibt den Handler der URL Sitzung zur ck Sendet das HTTP Paket mithilfe von CURL zur ck und empf ngt das reine XML Antwortpaket ohne den HTTP Header Schlie t die CURL Sitzung und gibt das resultierende Paket zur ck Nur Text mit XML Tags Weitere Informationen zum CURL Engine erhalten Sie unter http www php net manual en ref curl php Erh lt das Antwortpaket Nur Text als einen Parameter Verarbeitet das Paket mithilfe von SimpleXML und gibt das Objekt SimpleXMLElement
104. e gt lt name gt example com lt name gt lt display_name gt example lt display_name gt lt status gt 64 lt status gt lt real_size gt 0 lt real_size gt lt client_id gt 46 lt client_id gt lt dns_ip_address gt 192 0 2 33 lt dns_ip address gt 68 Einrichten ber Remote API lt htype gt none lt htype gt lt gen_info gt lt value gt lt result gt lt get gt lt domain gt lt packet gt Sobald das Antwortpaket empfangen und mit der parseResponse Funktion geparst wurde gibt der foreach Iterator die Inhalte des result Knotens wieder Code Beispiel lt php ye Ar Reports error during API RPC request sf class ApiRequestException extends Exception Returns DOM object representing request for information about all available domains return DOMDocument wy function domainsInfoRequest Sxmldoc new DomDocument 1 0 UTF 8 Sxmldoc gt formatOutput true lt packet gt Spacket S xmldoc gt createElement packet Spacket gt setAttribute version 1 6 2 0 Sxmldoc gt appendChild Spacket lt packet domain gt domain Sxmldoc gt createElement domain Spacket gt appendChild Sdomain lt packet domain get gt get xmldoc gt createElement get domain gt appendChild get lt packet dom Einrichten ber Remote API 69 ain get filter gt Sfilter xmldoc gt createEl
105. ecord gt Format ist wie folgt f r jeden Ressourceneintragstyp der in dem Panel unterst tzt wird Einrichten ber CLI 219 NS lt lt subdomain prefix gt gt lt lt name server FQDN gt lt prefix gt lt domain gt gt A lt lt subdomain prefix gt gt lt lt IP address gt lt ip gt gt MX lt lt subdomain prefix gt gt lt lt mail exchanger name gt lt prefix gt lt domain gt gt lt priority gt PTR lt lt IP address gt lt ip gt gt lt lt subdomain prefix gt gt lt subnet_mask gt CNAME lt lt subdomain prefix gt gt lt lt canonical_domain_name gt lt domain gt gt SRV lt _service gt lt _tcp _udp gt lt lt subdomain prefix gt gt lt target_host gt lt priority gt lt weight lt port gt TXT lt lt subdomain prefix gt gt lt text gt Hinweis Bitte beachten Sie dass die Platzhalter fur Befehle die durch echte Werte in echten Befehlen ersetzt werden in kursiv angegeben sind z B lt subdomain prefix gt w hrend die DNS Template Platzhalter die in dem Befehl platziert werden soll werden in Roman Schreibweise angegeben sind z B lt domain gt Beispiel Der Beispiel Befehl f gt die folgende DNS Zonen Template Datei zu dem Panel hinzu aus Darstellungsgr nden haben wir den lt domain gt Teil zu Hosts wie z B ns lt domain gt hinzugef gt welche in echten Zonen Dateien normalerweise nur ns w ren HOST RR type VALUE lt Domain
106. efehl in dem folgenden Format ein server_dns update soa options Verf gbare Optionen soa ttl lt number gt S Definiert den TTL Intervall Time to Live m Das Das Panel legt als Standardwert einen Tag fest soa refresh lt number gt S M Definiert den Refresh Intervall Aktualisieren ee oa Das Panel legt als Standardwert drei Stunden fest Soa retry lt number gt S M Definiert den Retry Intervall Wiederholen ee Das Panel legt als Standardwert eine Stunde fest Soa expire lt number gt S M Definiert den Expire Intervall Ablaufen D a E soa minimum lt number gt S M Definiert einen Mindestwert Minimum ee Das Panel legt als Standardwert drei Stunden fest soa serial for timestamplyyyy Definiert das Format einer SOA Record Seriennummer mat UNIX Timestamp oder empfohlen von IETF und RIPE Wird nur auf Linux Unix unterst tzt Beispiele 1 Der folgende Befehl setzt den TTL Wert auf 5 Stunden den Refresh Wert Aktualisieren auf 4 Stunden den Retry Wert Wiederholen auf 70 Sekunden den Expire Wert Ablaufen auf 2Wochen und den Mindestwert auf 2 Tage Auf Linux Unix server_dns update soa soa ttl 5H soa refresh 4H soa retry 10S soa expire 2W soa minimum 2D Auf Windows server dns exe update soa soa ttl 5H soa refresh 4H soa retry 10S soa expire 2W soa minimum 2D 2 Der folgende Befehl andert das Format der SOA Record Seriennummer auf das Format das von IETF und RIPE emp
107. eine Fehlermeldung mithilfe des domain output xsd Schemas lt packet version 1 6 2 0 gt lt domain gt lt add gt lt result gt lt status gt error lt status gt lt errcode gt 2300 lt errcode gt lt errtext gt Failed to add domain lt errtext gt lt result gt lt add gt lt domain gt lt packet gt Einrichten ber Remote API 65 Client Code Beispiele In diesem Abschnitt finden Sie Beispiele f r Client Anwendungen in PHP C und VB NET die erl utern wie das API RPC Protokoll verwendet wird In diesem Abschnitt PHP Glient Anwendung sa ae eE a EEA EEEN EAA RENERE RSS 65 C Client Anwendung ccccceeeeeeeeeeeeeeee etter eeteeecaeeeeeeeeeeeeeceaaaeeeeeeeeeteeeneeaeeeeeees 71 VB NET Client Anwendung cccceeeeeeeeeeeeeeeeeeeeeeeessesnaeeeaeeeeeeeesenseeeaaeeeeees 79 PHP Client Anwendung Die folgenden Code Beispiele stellen eine einsatzbereite Client Anwendung dar die in PHP geschrieben wurde Hinweis Wenn Sie dieses Beispiel verwenden m chten ben tigen Sie PHP 4 0 2 oder h her Weitere Informationen finden Sie unter http php net manual en ref dom php oder http php net manual en ref curl php Kommentare class Erweitert die standardm ige Exception Klasse ApiRequestException Weitere Einzelheiten finden Sie unter http www php net manual en language exceptions php function Verwendet das DOM Modell zur Erstellung eines domainsInfoRequest XML Abfrag
108. eine Abfrage von dem Server erwarten veranlassen die Ubermittlung des Pakets und starten die Ubertragung tell CURL to return the result rather than to load it to the browser curl setopt ch CURLOPT RETURNTRANSFER true pass in the packet to deliver curl setopt ch CURLOPT POSTFIELDS packet perform the CURL request and return the result Sretval curl _exec ch close the CURL session curl close Sch Sobald die Abfrage durchgef hrt wurde erh lt CURL das resultierende HTTP Paket auf der Clientseite entfernt den HTTP Header und die Variable Sretval erh lt den reinen XML Teil des Antwort Pakets Einrichten ber Remote API 61 Analysieren der Antwort Sie k nnen eine beliebige HTTP FTP Client Bibliothek f r die bertragung der Abfrage an das Panel verwenden und f r den Erhalt der Antwort In der Regel wird das resultierende HTTP Paket so strukturiert sein wie im Abschnitt Paketstruktur beschrieben auf Seite 54 Falls der CURL Engine verwendet wird wird das Ergebnis im reinen XML Format wieder zur ckgegeben Die Struktur eines reinen XML Pakets das von dem Panel API RPC Server wiedergegeben wird wird von den XML Schemata definiert Das Element packet ist der Root Knoten eines jeden XML Antwortpakets das Attribut version gibt die Version des Panel API RPC Protokolls wieder die auf dem Server ausgef hrt wird ResponsePacketType El attributes
109. einem HTTP Nachrichtentext enthalten ist Wir unterscheiden die folgenden zwei Pakettypen Abfrage Pakete werden von der Client Software erstellt und an den Server via Remote API gesendet Antwortpakete werden von dem Server erstellt und an den Client gesendet Ein Antwortpaket enth lt den Ausf hrungsstatus der angeforderten Operation und kann eine Fehlermeldung enthalten wenn die Operation nicht ausgef hrt werden konnte In diesem Abschnitt Paketstr ktur un ee ERA A ERE EAEE EER 54 Beispiel f r ein PAK iinet oa etait Ou Gotawadn aca aes GaGa aie 54 Validierung von Pakelen eek ae 56 54 Einrichten ber Remote API Paketstruktur Wir unterscheiden die folgenden API RPC Paketteile 1 HTTP Header Transportteil Neben anderen Standardinformationen muss dieser Teil Daten zu dem Server enthalten auf dem die Operation ausgef hrt wird und die Anmeldeinformationen des Panel Administrators 2 Paket Header Angabe der API RPC Protokollversion 3 Paketk rper Definition der Operationen die auf dem Server durchgef hrt werden sollen Der Paketk rper ist wie folgt strukturiert lt operator gt lt operation gt lt parameter1 gt lt parameter1 gt lt parameter2 gt lt parameter2 gt lt operation gt lt operator gt Dieses Beispiel zeigt die allgemeine Struktur des Paketk rpers mit einem operator Element und einem operation Element Die Bezeichnungen operator pp
110. einen Eintrag f r Ihren Katalog zur Konfigurationsdatei hinzuf gen und optional bestehende Eintr ge entfernen c Panel Benutzer sollen berhaupt keinen Zugang zu einem der APS Kataloge haben In diesem Fall entfernen Sie alle Eintr ge aus der Konfigurationsdatei Um die Liste mit den verf gbaren APS Katalogen zu bearbeiten sollten Sie die folgenden Vorg nge durchf hren 1 Passen Sie die Beispiel APS Kataloge auf Seite 49 an Ihre Anforderungen an 2 W hlen Sie eine der folgenden Vorgehensweisen um die Konfigurationsdatei in das Panel zu importieren 48 berblick zu Setupvorg ngen Kopieren Sie die benutzerdefinierte Konfigurationsdatei und ersetzen Sie die Standarddatei durch Standardbetriebssystem Methoden Import ber die Panel Bereitstellungs API Quicklinks Definieren von verf gbaren APS Katalogen ber Remote API auf Seite 146 Definieren von verf gbaren APS Katalogen ber CLI auf Seite 224 In diesem Abschnitt Konfigurationsdatei von APS Katalogen 244444usnnnnsnnnnnnnnnnnnnnnnnnnennnnnn berblick zu Setupvorg ngen 49 Konfigurationsdatei von APS Katalogen Speicherort Auf Linux Unix usr local psa admin smb application config aps catalogs ini Auf Windows plesk dir admin smb application config aps catalogs ini Format Die Konfigurationsdatei von APS Katalogen ist eine Textdatei in dem folgenden Format apscatalog Key word serving as internal identifier of t
111. eingm Pr OrOCO M mle Grete Oia API RPC Version Protocol Handler for receiving information about document type definition DTD XML Data Reduced XDR schema and XML Schema definition language XSD schema validation errors public ValidationEventHandler XmlSchemaValidation null public Request 156 Einrichten ber Remote API public string AgentEntryPoint get return https Hostname 8443 enterprise control agent php public string InputValidationSchema get return https Hostname 8443 schemas rpc Protocol agent input xsd public string OutputValidationSchema get return https Hostname 8443 schemas rpc Protocol agent output xsd public XmlDocument UploadFile string uploadfile HttpWebRequest request HttpWebRequest WebRequest Create AgentEntryPoint string boundary DateTime Now Ticks ToString x request Headers Add HTTP AUTH LOGIN Login request Headers Add HTTP AUTH PASSWD Password request ContentType multipart form data boundary boundary request Method POST Build up the post message header StringBuilder sb new StringBuilder sb Append sb Append boundary sb Append r n sb Append Content Disposition form data name
112. elect release id lt D gt show components Das bedeutet f r Parallels Small Business Panel 10 2 parallels installer select release id PPSMBE_10 2 0 show components auf einem Linux Unix Server parallels installer exe select release id PPSMBE 10 2 0_WIN show components Eine Liste mit den Komponenten wird im linken Teil angezeigt und eine Angabe dar ber ob diese Komponenten installiert instal1l oder aktualisiert upgrade mit einer Kurzbeschreibung auf der rechten Seite zum Beispiel base autoinstaller postfix php5 postgresql api siteeditor setemplates mod_python ruby firewall vpn fileserver watchdog drweb spamassassin backup backup vz de DE locale ja JP locale es ES locale ru RU locale fr FR locale it IT locale zh CN locale zh TW locale nl NL locale install Parallels Small Business Panel Basispakete install Installationsprogramm f r Parallels Produkte install Postfix Mailserver install PHP5 Unterst tzung install PostgreSQL Unterst tzung install Parallels Small Business Panel API install Site Editor install Site Editor Templates install Apache mod_python Modul install Ruby on Rails Unterst tzung install Firewall Add on install VPN Add on install Fileserver Add on install Add on f r die System berwachung Watchdog install Parallels Premium Antivirus install SpamAssassin Unterst tzung install Backup Manager
113. ement filter Sget gt appendCh ild filter lt packet domain get dataset gt Sdataset Sxmldoc gt createElement dataset Sget gt appendCh ild dataset dataset elements Sdataset gt appendChild Sxmldoc gt createElement hosting Sdataset gt appendChild Sxmldoc gt createElement gen info return Sxmldoc 2 Prepares CURL to perform the Panel API request return resource function curllnit host login password Feurl curl init curl_setopt eurl CURLOPT URL https Shost 8443 enterprise control agent php curl setopt curl CURLOPT RETURNTRANSFER true curl setopt curl CURLOPT POST true curl_setopt curl CURLOPT SSL VERIFYPEER false curl setopt curl CURLOPT SSL VERIFYHOST false curl setopt curl CURLOPT HTTPHEADER array HTTP AUTH LOGIN login HTTP AUTH PASSWD password HTTP PR ETTY PRINT TRUE Content Typ return Scurl es Hf text xml Performs a Panel API request returns raw API response text return string throws ApiRequestException function sendRequest curl packet 70 Einrichten ber Remote API curl setopt curl CURLOPT POSTFIELDS packet result curl_exec cu
114. en Managed Services betreute Dienste bzw Dienstleistungen Die Hosting Pakete die an Kunden verkauft werden beinhalten nicht nur die physische oder virtuelle Serverumgebung mit optionalen Control Panel Installationen sondern auch Domain Namen und SSL Zertifikate Da SaaS Angebote unter Verbrauchern insbesondere bei kleinen Unternehmen immer beliebter werden enthalten einige Hosting Pakete auch schon vordefinierte Anwendungspakete die auf Kunden Domains installiert werden Viele Angebote beinhalten zudem gehostete Services wie z B E Mail Kollaborationstools und Content Management F r Panel Installationen bedeutet das dass nach der Installation der Provider in der Lage ist das Panel einzurichten Das Setup des Panels beinhaltet folgende Schritte Einrichten des DNS Dienstes Domain Konfiguration Bereitstellung von SSL Zertifikaten Installation von APS Anwendungen Um Providern die Einf hrung von weiteren Diensten zu erleichtern wird in dem vorliegenden Dokument erkl rt wie die Verteilung und Konfiguration des Panels in die Bereitstellung von Anwendungen integriert werden kann ber dieses Handbuch berblick Das Kapitel Anmerkungen zum Bereitstellungsworkflow bietet einen Einblick in die wichtigsten Phasen des Bereitstellungsworkflows Das Kapitel Verteilung des Panels konzentriert sich auf die Verteilung des Panels Das Kapitel deckt sowohl die Installation in Parallels Containers Umgebungen
115. en Identifier des gerade erstellten Domain Accounts Datentyp integer guid erforderlich falls die Operation erfolgreich abgeschlossen wird Liefert den GUID Global Unique Identifier bezeichnet eine global eindeutige Zahl des gerade erstellten Domain Accounts Datentyp string Einrichten ber Remote API 139 Antwort Beispiele Eine positive Antwort die vom Server nach dem Hinzuf gen eines neuen Domain Accounts empfangen wird sieht wie folgt aus lt packet version 1 6 2 0 gt lt domain gt lt add gt lt result gt lt status gt ok lt status gt lt id gt 6 lt id gt lt guid gt 5c0e3881 22a2 4401 bcc0 881d691bfdef lt guid gt lt result gt lt add gt lt domain gt lt packet gt Eine negative Antwort kann wie folgt aussehen eventuell wird bei Ihnen ein anderer Fehlercode angezeigt je nachdem wodurch der Fehler verursacht wurde lt packet version 1 6 2 0 gt lt domain gt lt add gt lt result gt lt status gt error lt status gt lt errcode gt 1023 lt errcode gt lt errtext gt Operation failed lt errtext gt lt result gt lt add gt lt domain gt lt packet gt Folgende negative Antwort wird empfangen wenn ein Abfrage Paket nicht alle erforderlichen Hostingeinstellungen angibt ABFRAGE PAKET lt packet version 1 6 2 0 gt 140 Einrichten ber Remote API lt domain gt lt add gt lt gen setup gt lt name gt sample com lt name gt lt ip_add
116. en muss um Panel Setup Operationen sowie Antwortnachrichten die nach jeder durchgef hrten Operation empfangen werden auszuf hren In diesem Kapitel Remote API verwenden uuunneensnnnsnnnnnnnnnnnnnnnennnnnnnnnnnnnnnnnnnnn nennen nn nnen nennen 51 Einrichten des Panels un2u0n444nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nennen nenn nennen nennen 89 Einrichten ber Remote API 51 Remote API verwenden Dieser Abschnitt beschreibt wodurch sich die Remote API des Panels auszeichnet erkl rt die Funktionsweise und wie eine Client Anwendung erstellt wird die mit dem Panel ber Remote API kommuniziert In diesem Abschnitt ber Remote APl ese een 52 API RPC Pakete c cccccccecceeccecceccucceccucceeeaeeaueceecuecuecuecueeaecaeesuecuesuesueseeeaeeaeeaes 53 Erstellen der Client Software cccccecceecceeeceeeceeeceeeceeeceeeceeecueeceeeceeeaueentesaeeenees 57 52 Einrichten ber Remote API ber Remote API Um die Kommunikation zwischen dem Panel und einer Drittanbieter Software zu gew hrleisten stellt das Panel eine XML basierte API API Abk f r Application Programming Interface deutsch Programmierschnittstelle bereit Diese Schnittstelle macht eine Reihe an Funktionen f r die Verwaltung von logischen Objekten des Panels verf gbar Das API RPC Protokoll wurde entwickelt um remote d h von einem entfernten Standort aus mit diesen API Funktionen zu kommunizieren Es handelt sich um das XM
117. ende negative Antwort wird empfangen falls keine Abfrage Datei gefunden werden konnte lt packet version 1 6 2 0 gt lt aps gt lt import package gt lt result gt lt status gt error lt status gt lt errcode gt 1013 lt errcode gt lt errtext gt File usr local psa tmp 1i 8FZrut does not exist lt errtext gt lt result gt lt import package gt lt aps gt lt packet gt Folgende negative Antworten werden empfangen falls eine importierte Datei kein g ltiges APS Anwendungspaket enthalt 1 Das zu importierende Archiv enthalt keine APP META xm1 Paket Metadaten lt packet version 1 6 2 0 gt lt aps gt lt import package gt lt result gt lt status gt error lt status gt lt errcode gt 1023 lt errcode gt lt errtext gt lt result gt Entry lt import package gt lt aps gt lt packet gt APP M ETA xml Einrichten ber Remote API not found lt errtext gt 2 APP META xm1 kann nicht ber das XML Schema validiert werden lt packet version 1 6 2 0 gt lt aps gt lt import package gt lt result gt lt status gt error lt status gt lt errcode gt 1023 lt errcode gt lt errtext gt Unable to acquire metadata description lt errtext gt lt result gt lt import package gt lt aps gt lt packet gt 167 168 Einrichten ber Remote API Anwendungspakete vom APS Katalog herunterladen Um ein Anwendungspa
118. eration parameter sollten durch echte Operatoren Funktionen und Parameter ersetzt werden Hinweis Innerhalb eines Operators k nnen mehrere Operationsbereiche existieren und viele Operatorbereiche innerhalb eines einzigen Pakets Im Nachfolgenden werden XML Paket Header und K rper zusammen als Paket bezeichnet Beispiel f r ein Paket Hier finden Sie ein Beispiel f r eine AP RPC Abfragenachricht an den Server POST HTTP Header ae ee php Der HTTP Header weist darauf hin dass POST als HTTP Methode verwendet wird Die Hosts 10 58 83 138443 Benutzerschnittstelle befindet sich unter enterprise control agent php und die Accept ar i HTTP Version ist 1 1 Das Host Element gibt die HTTP_AUTH LOGIN admin IP Adresse und den Port des Panel Servers an an HTTP AUTH PASSWD Setup den die Nachricht gesendet wurde Die Elemente E 2 HTTP AUTH LOGIN und HTTP AUTH PASSWD Pragma no cache beinhalten die Anmeldeinformationen des Content Length 1398 Panel Administrators Nach Content Type muss text xml stehen Die Lange der weitergeleiteten Content Type text xml Nachricht ist auch erforderlich Einrichten ber Remote API 55 lt xml version 1 0 encoding UTF 8 standalone no gt Anfang des XML Teils lt packet version 1 6 2 0 gt Paket Header Das Attribut Version gibt die ben tigte Version des Panel API RPC Protokolls an lt smb gt lt
119. ern der Server nicht authentifiziert werden konnte kommt false zur ck Ereignishandler bei Validierungsfehlern Die Funktion gibt das Antwortpaket XmIDocument Objekt an die Konsole aus 74 Einrichten ber Remote API Die Client Anwendung kann von der Befehlszeile wie folgt gestartet werden PanelApiRpcClient 192 0 2 168 admin login admin passwd 1 6 2 0 c requests AddNewDomain xml1 Das Abfrage Paket wird in der AddNewDomain xm1 Datei verarbeitet lt xml version 1 0 encoding UTF 8 gt lt packet version 1 6 2 0 gt lt domain gt lt add gt lt gen_setup gt lt name gt example com lt name gt lt ip_address gt 192 0 2 48 lt ip address gt lt gen_setup gt lt hosting gt lt vrt_hst gt lt property gt lt name gt ftp_login lt name gt lt value gt fpt1 6se4fdf0 lt value gt lt property gt lt property gt lt name gt ftp_password lt name gt lt value gt qweqwe lt value gt lt property gt lt ip_address gt 192 0 2 48 lt ip address gt lt vrt_hst gt lt hosting gt lt add gt lt domain gt lt packet gt Das Antwortpaket das vom Server empfangen wird kann wie folgt aussehen lt xml version 1 0 gt lt packet version 1 6 2 0 gt lt domain gt lt add gt lt result gt Einrichten ber Remote API 75 lt status gt ok lt status gt lt id gt 6 lt id gt lt guid gt 5c0e3881 22a2 4401 bcc0 881d691bfdef lt guid gt lt result gt
120. ersion 1 6 2 0 gt lt dns gt lt del _rec gt lt filter gt 124 Einrichten ber Remote API lt template gt lt del_rec gt lt dns gt lt packet gt Struktur des Antwortpakets Der del_rec Knoten des ausgegebenen XML Pakets ist wie folgt strukturiert del_ree E 1 Deleting result Veleling resul result erforderlich Verpackt die vom Server abgerufene Antwort Datentyp resultType common xsd status erforderlich Gibt den Ausf hrungsstatus der Operation an Datentyp string Zul ssige Werte ok error errcode erforderlich falls die Operation fehlschl gt Gibt den Fehlercode wieder Datentyp integer errtext erforderlich falls die Operation fehlschl gt Gibt die Fehlermeldung wieder Datentyp string id erforderlich falls die Operation erfolgreich abgeschlossen wird Liefert den eindeutigen Identifier des entfernten DNS Eintrags Datentyp integer 125 Einrichten ber Remote API Antwort Beispiele Eine positive Antwort die vom Server empfangen wird entfernt alle DNS Zonen Template Eintr ge erfolgreich ABFRAGE PAKET lt packet version 1 6 2 0 gt lt dns gt lt del _rec gt lt filter gt lt template gt lt del_rec gt lt dns gt lt packet gt ANTWORTPAKET lt packet version 1 6 2 0 gt lt dns gt lt del _rec gt lt result gt lt status gt ok lt status gt lt id gt 1 lt id gt lt result gt lt result gt
121. ezeigt werden sollen select release lat est Verwenden Sie diese Option um die neueste f r Ihr Betriebssystem verf gbare Version auszuw hlen show components Geben Sie diese Option ein um Informationen dar ber zu erhalten welche Komponenten f r die ausgew hlte Version verf gbar sind Es werden die Komponentenbeschreibungen und Namen angezeigt Um weitere zu installierende Komponenten auszuw hlen m ssen Sie die Namen der Komponenten angeben install component lt Name der Komponente gt Verwenden Sie diese Option um eine zu installierende Komponente anzugeben Falls mehr als zwei Komponenten auf einmal installiert werden sollen wiederholen Sie diese Option f r jede Komponente Beispiel install component base install component postgresql install component spamassassin Verteilung des Panels 17 Option install everything Beschreibung und m gliche Argumente Verwenden Sie diese Option um alle Komponenten der ausgew hlten Version zu installieren show os list Verwenden Sie diese Option um herauszufinden welche Betriebssysteme von der ausgew hlten Panel Version unterst tzt werden no space check Installiert Pakete auch wenn wenig Festplattenplatz zur Verf gung steht no daemon F hrt den Installationsprozess im Vordergrund aus notify email lt E Mail gt Verwenden Sie diese Option damit der Installer Ihnen den S
122. f hrt wird Falls ein Fehler dieser Art auftritt erh lt der von dem Panel verwaltete Server eine Fehlermeldung Die Fehlerbeschreibung beinhaltet in dem Fall immer die folgenden Parameter status mit dem Wert error errcode Fehlercode eine eindeutige Nummer zur Identifikation des Fehlers errtext Fehlermeldung eine f r den Menschen lesbare Fehlerbeschreibung Eine Fehlerbeschreibung wird von dem Typ resultType in dem common xsd Schema in den meisten F llen oder von Typen basierend auf diesem Schema definiert abh ngig von dem Operator berpr fungsfehler Ein eingehendes HTTP Paket durchl uft eine Reihe von berpr fungen auf der Serverseite bevor es als g ltig bzw valide anerkant wird und f r die Ausf hrung bereit ist Hier sind einige dieser berpr fungen berpr fung des HTTP POST Headers berpr fung ob die angegebene Version des API RPC Protokolls unterst tzt wird oder nicht berpr fung der Authentifizierungsmethode Anmeldeinformationen oder geheimer Schl ssel berpr fung des Berechtigungsstatus des Benutzers remote_access_interface berpr fung der Validit t des Pakets berpr fung ob die ben tigten Agents in der aktuellen Panel Version verf gbar sind Jede dieser berpr fungen kann unter Umst nden fehlschlagen In dem Fall k nnen keine weiteren berpr fungen und Befehle ausgef hrt werden Wenn die Serverseite bei einem der vorhergehenden berp
123. fohlen wird server_dns update soa soa serial format yyyymmddnn Einrichten ber CLI 215 Einrichten von Templates f r Ressourceneintr ge Sie k nnen eine der folgenden zwei M glichkeiten w hlen um ber die Befehlszeilenschnittstelle CLI des Panels das DNS Zonen Template zu ndern 1 Hinzuf gen eines Eintrags Record Leichte Modifikation indem Sie einen einzelnen Eintrag mit einem Befehl hinzuf gen 2 berschreiben eines Zone Templates Vollst ndige Modifikation indem Sie alle Ressourceneintr ge des Zonen Templates entfernen und neue Eintr ge mit einem Befehl verfassen In diesem Abschnitt Hinzuf gen eines Eintrags Record 444444444nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 215 Records im DNS Zonen Template berschreiben 4444444ssn nn 218 Hinzuf gen eines Eintrags Record Um einen einzelnen Ressourceneintrag zu dem DNS Zonen Template hinzuzuf gen verwenden Sie den folgenden Befehl server_dns lt add a gt lt RR Parameter gt Record Parameter und Beispiel So f gen Sie einen neuen an f r den die A Ressourceneintrag Eintragseinstellungen sample lt domain gt definiert f r den bernommen werden Eintrag einen Platzhalter f r eine nap Domain IP Adresse zu dem en Detiniert SE IP Adresse f Domain DNS Zone Template hinzu s gt lt ip gt oder einen Platzhalter f r eine Domain IP Adresse zu server_dns a a sample ip Erstellung eines A Templa
124. g des Panels Installationsskript Linux Unix In diesem Abschnitt erhalten Sie Informationen zur Implementierung und Ausf hrung eines Installationsskripts Zudem werden zwei Beispiele f r Installationsskripte angegeben Hinweise zur Implementierung und Ausf hrung Damit Sie nicht jedes Mal nach einem Passwort gefragt werden wenn Sie sich ber SSH mit den Servern verbinden auf denen das Panel installiert werden soll sollten Sie Ihren ffentlichen Schl ssel zu der Liste mit den authorisierten Schl sseln des Benutzers hinzuf gen f r den das Skript auf dem Server ausgef hrt werden soll weitere Informationen zu der Vorgehensweise finden Sie auch in der SSH Dokumentation Falls Sie einen lokalen Mirror des Panel Update Servers benutzen wie im Abschnitt Einrichten von Mirrors beschrieben auf Seite 27 verwenden Sie die folgende Option source lt Mirror URL gt Standardm ig werden alle heruntergeladenen Pakete in dem Verzeichnis root psa gespeichert Um ein anderes Verzeichnis auszuw hlen verwenden Sie bitte die folgende Option e target lt Name des Verzeichnisses gt Beispiel Skripte 1 Dieses Beispiel Skript kann dann angewendet werden wenn der Parallels Installer zuvor auf den Zielserver hochgeladen wurde und das Ausf hrungs Bit in den Zugriffsrechten definiert wurde bin sh SERVERS_LIST node1 example com node2 example com for current_server in SERVERS_LIST do scp parallels_installer roo
125. get D temp proxy host lt Netzwerkadresse gt Wenn Sie einen Proxy Server oder eine Firewall benutzen sollten Sie diese Option verwenden um den Domain Namen eines Proxy Servers oder die IP Adresse festzulegen Beispiel proxy host proxy example com proxy port lt Port Nummer gt Der Standard Port f r die Verbindung zum Proxy Server ist 3128 Falls Ihr Proxy Server eine andere Port Nummer verwendet sollten Sie diese angeben indem Sie diese Option verwenden Beispiel SEO Sl Optionen f r die Proxy Athentifizierung proxy user lt Benutzername gt proxy password lt Passwort gt Falls f r Ihren Proxy Server eine Authentifizierung erforderlich ist sollten Sie diese Optionen verwenden um den Installer beim Proxy Server zu authentifizieren Beispiel proxy user smith proxy password flsZ9AnQ4En052 show releases Geben Sie diese Option an um eine Liste mit den verf gbaren Versionen f r das Betriebssystem abzufragen wo der Installer ausgef hrt wird Sie erhalten eine Liste mit Release Identifiers und Versionsbeschreibungen Die Release IDs sind die Informationen mit denen Sie sich besch ftigen sollten show all releases Diese Option zeigt alle Versionen an die ber den Panel Updates Server zur Verf gung stehen select release id lt ID gt Verwenden Sie diese Option um die Version anzugeben die installiert werden soll oder deren Eigenschaften ang
126. gt lt dns gt lt packet gt ANTWORTPAKET lt packet version 1 6 2 0 gt lt dns gt Einrichten ber Remote API lt get_rec gt lt result gt lt status gt ok lt status gt lt id gt 1 lt id gt lt data gt lt type gt NS lt type gt lt host gt amp lt domain amp gt lt host gt lt value gt ns amp lt domain amp gt lt value gt lt opt gt lt data gt lt result gt lt result gt lt status gt ok lt status gt lt id gt 2 lt id gt lt data gt lt type gt A lt type gt lt host gt ns amp lt domain amp gt lt host gt lt value gt amp lt ip amp gt lt value gt lt opt gt lt data gt lt result gt lt result gt lt status gt ok lt status gt lt id gt 3 lt id gt lt data gt lt type gt A lt type gt lt host gt amp lt domain amp gt lt host gt lt value gt amp lt ip amp gt lt value gt lt opt gt lt data gt lt result gt lt result gt lt status gt ok lt status gt lt id gt 4 lt id gt lt data gt lt type gt A lt type gt lt host gt webmail amp lt domain amp gt lt host gt Einrichten ber Remote API lt value gt amp lt ip amp gt lt value gt lt opt gt lt data gt lt result gt lt result gt lt status gt ok lt status gt lt id gt 5 lt id gt lt data gt lt type gt MX lt type gt lt host gt amp lt domain amp gt lt host gt lt value gt mail amp lt domain amp gt lt value gt lt opt gt 10 lt opt gt lt da
127. gt NS ns lt domain gt ns lt Domain gt A lt IP gt lt Domain gt A lt IP gt webmail lt Domain gt A lt IP gt lt Domain gt MX 10 mail lt domain gt mail lt Domain gt A lt IP gt ftp lt domain gt CNAME lt domain gt lt ip gt 24 PTR lt domain gt lt Domain gt TACTE El pa az SaL _SIP tcp megadomain lt domain gt SRV 5 25 12 ekamole Comis Auf Linux Unix server_dns s NS ns lt domain gt A ns lt ip gt A lt ip gt A webmail lt ip gt MX mail lt domain gt 10 A mail lt ip gt CNAME ftp lt domain gt PTR lt ip gt 24 TXT v spf1 a mx all SRV _SIP tcp megadomain example com 5 25 12 Auf Windows server dns exe s NS ns lt domain gt A ns lt ip gt A lt ip gt A webmail lt ip gt MX mail lt domain gt 10 A mail lt ip gt CNAME ftp lt domain gt PTR lt ip gt 24 TXT v spfl a mx all SRV SIP tcp megadomain example com 5 25 12 220 Einrichten ber CLI Installation von SSL Zertifikaten Um ein SSL Zertifikat ber die Befehlszeilenschnittstelle CLI zu installieren verwenden Sie das certificate Dienstprogramm Die Installation wird in zwei Phasen durchgef hrt 1 Import des Zertifikats in das Panel 2 Zuweisen des Zertifikats zu einer IP Adresse Bitte beachten Sie dass die Zertifikatsbestandteile zuvor auf die Maschine mit dem Panel hochgeladen werden m ssen In diesem Abschnitt Import des Zertifikats a ee Sareaasei
128. gt config app lt Name des Anwendung s Templates gt default repositories Das bedeutet vz template lt Betriebssystem gt lt Version des Betriebssystem gt lt Pla ttform gt config app ppsmbel0 default repositories und vz template lt Betriebssystem gt lt Version des Betriebssystems gt lt Pl attform gt config app ppsmbel0 extended default repositories Bearbeiten Sie beide falls beide Templates installiert wurden b Ersetzen Sie die URLs des Parallels Updates Server mit den entsprechenden URLs des Mirrors und speichern Sie die Datei 3 Bereinigen oder rufen Sie die Metadaten der Pakete neu ab Sie k nnen hierzu beispielsweise den Befehl vzpkg clean verwenden Weitere Details finden Sie in dem Referenzhandbuch Parallels Containers f r Linux verf gbar im Parallels Technology Network http www parallels com ptn documentation virtuozzo gt So erstellen Sie einen neuen Container und installieren das Panel in diesem 1 Erstellen Sie einen Container und konfigurieren Sie diesen gem Ihren Anforderungen optional F hren Sie die folgenden Befehle aus Vzeelsereates lt C nn opelonen vzctl set lt CT_ID gt lt Name_der Einstellung gt lt Wert gt save wobei lt cT ID gt eine beliebige Container ID h her als 100 definiert die auf dem Hardware Node eindeutig ist save Switch teilt vzct1 mit ob nderungen in der Konfigurationsdatei des Containers gespeichert werden sollen oder nicht
129. gt geeklog lt name gt lt package gt lt download package gt lt aps gt lt packet gt Struktur des Antwortpakets Der download package Knoten des ausgegebenen XML Pakets ist wie folgt strukturiert r APSPackageDownloadOutputType resultType extension Result status ok error download package E occurred Error message if error occurred a ee Error code if error result erforderlich Verpackt die vom Server abgerufene Antwort Datentyp resultType common xsd status erforderlich Gibt den Ausf hrungsstatus der Operation an Datentyp string Zul ssige Werte ok error errcode erforderlich falls die Operation fehlschl gt Gibt den Fehlercode wieder Datentyp integer errtext erforderlich falls die Operation fehlschl gt Gibt die Fehlermeldung wieder Datentyp string task id erforderlich falls die Operation erfolgreich abgeschlossen wird Gibt die ID des Download Tasks an die sp ter verwendet werden kann um den Download Status abzufragen Datentyp string 171 172 Einrichten ber Remote API Antwort Beispiele Eine positive Antwort vom Server sieht wie folgt aus lt packet version 1 6 2 0 gt lt aps gt lt download package gt lt result gt lt status gt ok lt status gt lt task id gt 4 lt task id gt lt result gt lt download package gt lt aps gt lt packet gt Folgende Antwort wird empfangen wenn die URL des APS
130. he CLI auf Seite 210 berblick zu Setupvorg ngen 35 Installation des Lizenzschl ssels Das Panel wird mit einem standardm ig voreingestellten Lizenzschl ssel vertrieben der eine begrenzte Anzahl an Benutzer Accounts unterst tzt Aus diesem Grund ist es notwendig einen Lizenzschl ssel zu erwerben und zu installieren der am besten die Anforderungen des jeweiligen Benutzers erf llt Zusammen mit dem Hauptlizenzschl ssel der die wichtigsten Funktionalit ten des Panels definiert k nnen zus tzliche Lizenzschl ssel installiert werden welche die Nutzung von Panel Add ons z B Parallels Premium Antivirus erm glichen Quicklinks Installation des Lizenzschl ssels ber Remote API auf Seite 94 Installation des Lizenzschl ssels ber die Befehlszeilenoberfl che CLI auf Seite 211 36 berblick zu Setupvorg ngen Branding des Panels Die im Folgenden genannten Branding Aspekte des Panels fallen in den Bereich der Panel Bereitstellung Panel Firmenzeichen und URL Support Button Link Hinweis Beide werden nur in der CLI unterst tzt Logo Das Panel Logo wird in der linken oberen Ecke des Panels angezeigt Standardm ig handelt es sich um eine Bilddatei im GIF Format 141 x 29 Pixel mit dem Produktlogo von Parallels Small Business Panel Wenn Sie auf dieses Logo klicken ffnet sich die Website von Parallels Sie k nnen das standardm ig voreingestellte Logo durch Ihr eigenes und der URL zu
131. he agent_input xsd schema and all subsequent schemas referenced by it N validate XML client lt add gt Aue Engine If the packet is considered valid Agent Engine passes perform control to one of its agents to client agent that one specified in the packet body lt add gt lt client gt Pucynok 2 Validierung des Pakets auf der Serverseite Wenn das Paket als ung ltig analysiert wird erstellt der Agent Engine einen Fehlerbericht und sendet diesen zur ck an den Client Wenn alle Elemente des Pakets erfolgreich validiert wurden pr ft der Agent Engine ob alle notwendigen Module zur Weiterverarbeitung enthalten sind und ruft diese eines nach dem anderen ab Jeder Agent Operator empf ngt seinen Abschnitt des Operator Pakets analysiert diesen ruft interne Funktionen ab und liefert dem Agent Engine das Ergebnis der durchgef hrten Befehle Einrichten ber Remote API 57 Erstellen der Client Software Die Client Anwendung muss die folgenden Phasen des Datenaustausches umsetzen Konvertierung des angeforderten Befehls in ein AP RPC aktiviertes XML Paket Vorbereitung des Pakets zur Bereitstellung ber HTTP und Weiterleitung an das Panel Antwort des Panels empfangen und die resultierenden Informationen aus dem Paket extrahieren THIRD PARTY SOAR CLIENT APPLICATION HTTP library command XML packet ___ e HTTP packet __ builder sender API RPC GUI software XML packet HTTP packet
132. he APS applications resource type apscatalog APS applications resource type definition can be marketplace or apscatalog marketplace is a type used to denote Application Marketplace service apscatalog is a common type that should be used for any APS Catalog official APS Catalog service and local mirrors url http apscatalog com APS applications resource URL marketplace type marketplace url http catalog marketplace parallels com protocol all app APSCatalogLocalMirror type apscatalog name en US APS Catalog local APS applications resource title as it will be displayed in the Panel GUI in the corresponding locale description en US Local instance of APS catalog APS applications resource description as it will be displayed in the Panel GUI in the corresponding locale url apscatalog example com KAPITEL 5 Einrichten ber Remote API Dieses Kapitel konzentriert sich auf das Einrichten des Panels mithilfe der Remote API des Panels API Abk f r Application Programming Interface deutsch Programmierschnittstelle Der Abschnitt Remote API verwenden auf Seite 51 beinhaltet einen berblick ber das API RPC Protokoll und Tool Samples die verwendet werden um mit einem vom Panel verwalteten Server ber das Protokoll zu kommunizieren Der Abschnitt Einrichten des Panels auf Seite 89 beschreibt im Detail Abfragenachrichten die ein Drittanbieter Tool ausgeb
133. hemaUri XmlSchemaSet schemas n w XmlSchemaSet schemas Add null XmlReaderSettings settings XmlSchemaValidation schemaUri new XmlReaderSettings l if null settings ValidationEventHandler new ValidationEventHandler XmlSchemaValidation settings ValidationType XmlSchemaValidationFlags ProcessSchemaLocation settings Schemas ValidationType Schema settings ValidationFlags schemas XmlDocument document new XmlDocument XmlReader reader XmlTextReader Create xml document Load reader using settings return document private XmlDocument GetResponse HttpWebRequest request HttpWebResponse response HttpWebRespons using request GetResponse using Stream stream response GetResponseStrean using TextReader reader new StreamReader stream return ParseAndValidate reader OutputValidationSchema class Program static void Main string args 78 Einrichten ber Remote API if args Length lt 5 Console WriteLine Usage PanelApiRpcClient lt Hostname gt lt Login gt lt Password gt lt Protocol gt lt Request gt Console WriteLine N Console WriteLine Hostname Panel host name Console WriteLine Login Administrator s login Console WriteLine Password Administrator s password
134. ia clal seruo gt lt password gt P4 wOrd lt password gt lt admin email gt johndoe example com lt admin email gt lt locale gt de DE lt locale gt lt initial setup lt smb gt Paketk rper Beginnt immer mit dem Tag des zugeh rigen Operators Dieses Beispiel Paket verwendet den smb Operator um eine k rzlich installierte Panel Software zu initialisieren Die innerhalb des Knotens von initial_setup geschachtelten Elemente enthalten die Daten die f r die Initialisierung des Panels notwendig sind E Mail Adresse und Passwort des Panel Administrators und die Panel Sprache lt packet gt Abschlie ender Tag des Pakets Sowohl Abfrage und Antwortpakete sind sich hnlich in der Struktur aber der HTTP Header und K rper unterscheiden sich Die Nachricht die der Server als Antwort auf die Abfrage versendet k nnte wie folgt aussehen HTTP 1 1 200 OK Transfer Encoding chunked Content type text html Date Fri 03 Apr 2009 18 54 56 GMT Server sw cp server 1 0 0 Standard Header der HTTP Server Antwort Der MIME Typ ist text xml Das Server Element zeigt dass die Abfrage von dem Panel auf der Serverseite verarbeitet wurde lt xml version 1 0 encoding UTF 8 standalone no gt Standard Header eines g ltigen XML Dokuments lt packet version 1 6 2 0 gt XML Paket Header lt smb gt Paketk rper lt initial setup gt Der Root Knoten des
135. ichten ber CLI ber die Panel Befehlszeilenschnittstelle CLI Die Befehlszeilenschnittstelle Abk CLI Command Line Interface von Parallels Small Business Panel bietet eine Befehlszeilenoberfl che ber die ein Panel Administrator die Mehrzahl der Verwaltungsaufgaben durchf hren kann Die Panel Befehlszeilendienstprogramme k nnen vom root Benutzer von der Konsole oder vom Skript verwendet werden Um die Dienstprogramme auszuf hren ben tigen Sie root psaadm auf Linux Unix oder Administrator auf Windows Rechte Parallels Small Business Panel f r Linux Unix CLI unterst tzt lokalisierte Namen von Business Objekten in derselben Art und Weise wie das Panel an sich Deshalb k nnen Sie Kunden mit Kontaktnamen mithilfe eines Gebietsschemas Ihrer Wahl erstellen Verwenden Sie die LANG Umgebungsvariable um ein bestimmtes Gebietsschema zu konfigurieren Nach dem erfolgreichen Ausf hren geben Dienstprogramme den Code 0 an Falls ein Fehler auftritt geben Dienstprogramme den Code 1 an und zeigen eine Beschreibung des aufgetretenen Problems auf stderr an Hinweis Alle Eingabeparameter f r die Dienstparameter m ssen in der UTF 8 Kodierung angegeben werden Dies ist unbedingte Voraussetzung damit das Panel stabil l uft Speicherorte von Dienstprogrammen Auf Linux Unix opt psa bin auf Debian Systemen usr local psa bin auf nicht Debian Linux und Unix Auf Windows lt plesk_c1li Einrichten ber CLI
136. ie Anordnung der Header Elemente ist wie folgt Sheaders array HTTP AUTH LOGIN admin HTTP AUTH PASSWD setup Content Type text xml Dann wird der CURL Engine initialisiert so eingerichtet dass HTTPS verwendet werden kann und anschlie end werden alle f r den HTTP Header erforderlichen Parameter eingegeben initialize the curl engine sch curl init set the curl options do not check the name of SSL certificate of the remote server curl_setopt ch CURLOPT_SSL_VERIFYHOST 0 do not check up the remote server certificate curl_setopt ch CURLOPT_SSL_VERIFYPEER false pass in the header elements curl setopt ch CURLOPT_HTTPHEADER Sheaders pass in the url of the target server 60 Einrichten ber Remote API curl_setopt ch CURLOPT URL url Ein weiterer Parameter der vom CURL Engine ben tigt wird ist das Panel API RPC Paket Nehmen wir an dass das Paket wie folgt strukturiert ist Spacket lt lt lt EOP lt xml version 1 0 7 encoding UTF 8 gt lt packet version 1 6 2 0 gt lt smb gt lt initial_setup gt lt password gt P4SSw0rd lt password gt lt admin_email gt johndoe example com lt admin email gt lt initial setup gt lt smb gt lt packet gt EOP Jetzt geben wir an den CURL Engine die Information weiter dass wir
137. ien mit PHP hochladen Unten wird ein Beispiel f r ein PHP Skript angegeben um Dateien auf das Panel hochzuladen Ersetzen Sie HOST LOGIN PASSWD und FILENAME durch die Panel Anmeldeinformationen HOST Die IP Adresse oder der Name des vom Panel verwalteten Servers Login Login Name des Panel Administrators PASSWD Passwort des Panel Administrators FILENAME Vollst ndiger Name der Datei die hochgeladen wird lt php define HOST 10 58 97 31 define PATH enterprise control agent php define LOGIN admin define PASSWD setup define FILENAME data rpm function write_callback ch data echo data return strlen data function uploadFile filename url https HOST 8443 PATH headers array HTTP_AUTH LOGIN LOGIN HTTP_AUTH PASSWD PASSWD HTTP_PRETTY_ PRINT TRUE Content Type multipart form data Initialize the curl engine ch curl_init Set the curl options 154 Einrichten ber Remote API curl_setopt ch CURLOPT_SSL_VERIFYHOST 0 this line makes it work under https curl_setopt ch CURLOPT_SSL_VERIFYPEER FALSE curl_setopt ch CURLOPT_HTTPHEADER headers Set the URL to be processed curl_setopt ch CURLOPT_URL url curl_setopt ch CURLOPT_POSTFIELDS array sampfile gt filename result curl_exec ch
138. iert wurde lt packet version 1 6 2 0 gt lt smb gt lt initial_setup gt lt result gt lt status gt error lt status gt lt errcode gt 1003 lt errcode gt lt errtext gt Initial setup already completed lt errtext gt lt result gt lt initial_setup gt lt smb gt lt packet gt Die folgende negative Antwort wird vom Panel empfangen falls das angegebene Gebietsschema nicht verf gbar ist lt packet version 1 6 2 0 gt lt smb gt lt initial_setup gt lt result gt lt status gt error lt status gt lt errcode gt 1019 lt errcode gt lt errtext gt Locale en US2 is not installed on server lt errtext gt lt result gt 94 Einrichten ber Remote API lt initial_setup gt lt smb gt lt packet gt Installation des Lizenzschl ssels Um einen Lizenzschl ssel per API RPC zu installieren erstellen Sie ein XML Abfrage Paket mit dem serverllic_install Kontrollknoten lt packet version 1 6 2 0 gt lt server gt lt lic_install gt lt lic_install gt lt server gt lt packet gt In diesem Abschnitt Struktur des Abfrage Pakets um 444444444H0nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 94 Beispiele f r Abfragen ee 95 Struktur des Antwortpakets uum444444444n nnnnnnnnnnnnnnnnnnnnnnnnannnnnnnnnnnnnnnnnnnnn 98 Antwort Beispiele 2s su2 00 ea 99 Struktur des Abfrage Pakets Ein XML Abfrage Paket zur Installation eines L
139. ikatsdatei ist usr local cert certfile cert die CA Zertifikatsdatei ist usr local cert cacert cert und die entsprechende CSR Datei Certificate Signing Request ist usr local requests csreq csr Nach dem Import hei t das Zertifikat Site Certificate Auf Linux Unix certificate c Site Certificate domain example com key file usr local keys keyfile key cert file usr local cert certfile cert cacert file usr local cert cacert cert csr file usr local requests csreq csr Auf Windows die Dateien f r diese Zertifikatsbestandteile befinden sich im Verzeichnis Br ssl certificate c Site Certificate domain example com key file E ssl keys keyfile key cert file E ssl cert certfile cert cacert file E ssl cert cacert cert csr file E ssl requests csreq csr 222 Einrichten ber CLI Zuweisen des Zertifikats zu einer IP Adresse Um ein importiertes Zertifikat zu einer IP Adresse zu zuweisen verwenden Sie den Befehl im folgenden Format certificate lt assign cert ac gt lt name gt admin ip lt ip address gt Beispiel Der folgende Befehl weist das SSL Zertifikat mit dem Namen Site Certificate der IP Adresse 192 0 2 78 zu Auf Linux Unix certificate ac Site Certificate ip 192 0 2 78 Auf Windows certificate ac Site Certificate ip 192 0 2 78 Erstellen von Domains Um einen Domain Account zu erstellen verwenden Sie das domain Dienstprogramm
140. in dem Panel unter dem Namen common angezeigt wird und der IP Adresse 192 0 2 14 zugewiesen wird lt packet version 1 6 2 0 gt lt certificate gt lt install gt lt name gt common lt name gt lt admin gt lt content gt lt cesr gt BEGIN CERTIFICATE REQUEST AT TCwTCCAakCAQAwf DELMAkKGA1UEBhMCVVMxEDAOBgNVBAgTB2d1b3JnawWExEDAO BgNVBAcCTBOFObGFudGEXEj AQBgNVBAoTCURVZSwgTHRkLjEUMBIGA1UEAxMLam9o0 bmRvZS5vemcxHzAdBgkqhkiG9w0BCOEWEGpkb2VAam9obmRvZS5vcmcwggHEiMA0G CSqGS Ib3 DOEBAQUAA4 I BDwAwggEKAoIBAQC7AQ1X0pXqCs61ZUZ28zJ9PAGOyxvVv 2pUnITMqrudyi 3vV8IZrBUUWMthf7tOmMSSyZWAqM 7n4Q9Y4f5WuR 3ReM5kxC hbQnOrjpdUmv1 ZhB9Q21UFA5eEpt yDM LR2JAjpKJD078rh7 6pVZm3ESJM13 UE Dg0DeKDelDKa4SYzW1JJnoen4UXX371IHdBnIj NCQbHRSiGD6w6mMyiCMOzxXCp BiGXgRRca0OV1500eAdVKkwpJaaelK7K3q9j LkA1OalC8kuwdaCtKCtj FCE7210 8TnIn7ahPy0yd2EgzZ42Ys8D3PziqGax8I1 e6BbEOfzi0nlHD9GCzaPAgMBAAGg DANBgkqhkiG9w0 BAQOFAAOCAQEAhoSVmInXLQDJu8j rZTVVFUx606aHOUKUE G8 nc2x7wtQo7XHMHVDCUcP3K bEw9o0KxfpvRXP 9XTVhX2jABHrxywLyjg4cxXwaUgR 7ULvpLO0Sum5SXNtBypAdSOQOZZ7ktAa6030MAFNAYSYG9J L2ZICLIYJJZLAUNRWZN Bn9Tp3pCC8N9OF9 PFEpxGvhtlcl1027w9wj ORdK3hF6Rg37qcUJSnn6Xx0B4108 ZZbX2VbskzOWJ1Icxs fWDJ HFdho7GrrD wujNpwkTPc3xe2AHcfoX8c 92xyra kdzxsDdFD7 I wA5bBWGm8Qw1L9 yWuDPiZ8vSGw96D 0ije9UVKA een END CERTIFICATE REQUEST lt csr gt SPVE gt gt BEGIN RSA PRIVATE KEY MIITEpQIBAAKCAQEAyxfczy4HqgwOl 6yxEa dL
141. ist gen_setup EH 34 E Fip_address domainHostingAgentSet eisen Physical hosting au 136 Einrichten ber Remote API gen_setup erforderlich Beinhaltet die wichtigsten Informationen ber den Domain Account Datentyp none name erforderlich Gibt den Domainnamen an Datentyp domainName plesk_domain xsd ip_address erforderlich Gibt die IP an auf der die Domain gehostet wird Datentyp ip_address common xsd hosting erforderlich Gibt die Hostingeinstellungen f r die Domain an Datentyp domainHostingAgentSet plesk_domain xsd vrt_hst erforderlich Gibt die Hostingeinstellungen f r die Domain an Datentyp domainPhHostingSet plesk_domain xsd Wie folgt strukturiert domainPhHostingSet extension PleskPhysHOstingPropertyType property D E ia vrt hst G Physical hosting 7 F value 4 00 ip_address property erforderlich Gibt einen Hosting Parameter an Datentyp PleskPhysHostingProperty Type plesk_domain xsd name erforderlich Gibt einen Hosting Parameter Namen an Datentyp string value erforderlich Gibt einen Hosting Parameter Wert an Datentyp any ip_address erforderlich Gibt die IP Adresse der Domain an Datentyp ip_address common xsd Einrichten ber Remote API 137 Beispiele f r Abfragen Diese Abfrage erstellt die Domain example com die auf der IP 192 0 2 48 gehostet
142. ist oder sich in der Download Warteschlange befindet falls mehrere Pakete zum Download zur selben Zeit angegeben wurden Datentyp APSPackageDownloadStatusInProgress aps xsd error optional Gibt an dass der Download mit einem Fehler beendet wurde Beinhaltet eine Fehlerbeschreibung Datentyp none package id erforderlich wenn das Paket erfolgreich heruntergeladen wurde Gibt an dass der Download erfolgreich abgeschlossen wurde und benennt die ID die dem Paket auf Ihrem Server zugewiesen wurde Datentyp id_type common xsd total erforderlich Gibt die gesamte Anwendungsgr e in Bytes an Datentyp integer completed erforderlich Gibt die Gr e des heruntergeladenen Teils an auch in Bytes Datentyp integer current optional Gibt an dass der Download Task momentan durchgef hrt wird im Gegensatz zu den Tasks die in Download Warteschlange warten Datentyp string 180 Einrichten ber Remote API Abfrage und Antwort Beispiele Beispiel 1 Abfrage Dieses Paket fragt den Status des Download Tasks mit der ID 18 ab lt packet version 1 6 2 0 gt lt aps gt lt get download status gt lt filter gt lt task id gt 18 lt task id gt lt filter gt lt get download status gt lt aps gt lt packet gt Antwort A Eine positive Antwort k nnte wie folgt aussehen lt packet version 1 6 2 0 gt lt aps gt lt get download status gt lt result gt lt status gt ok lt status gt
143. izenzschl ssels beinhaltet den serverllic_install Kontrollknoten und ist wie folgt strukturiert ServerOperatorType eines E license erforderlich Beinhaltet die Lizenzschl ssel Daten Datentyp base64 additional_key optional Gibt an ob der zu installierende Lizenzschl ssel ein zus tzlicher Schl ssel ist Datentyp none Einrichten ber Remote API 95 Beispiele f r Abfragen Dieses Paket installiert einen Standard Haupt Lizenzschl ssel f r Parallels Small Business Panel f r Linux Unix mit dem das Produkt verteilt wird lt packet version 1 6 2 0 gt lt server gt 96 Einrichten ber Remote API lt lic_install gt lt license gt PD94bWwgdmVyc2lvbj0OiIMS4wliBlobmNvZGluZz0iVVRGLTgilID8 IAOKLSA8cHAtc2 1iLXVuaXgtMTA6a2V5IGNvcmU6Zm9ybWFOPSJvcGVuZnVzaW9uLTMilHhtoG5zOmNvem U9ImhOdHA6Ly9wY XJhbGxlbHMuY29tL3NjaGVtYXMva2V5cy9jb3JILZMilHhtbG5zOnBwLX NtYi1 1bml4LTEwPSJodHRwOi8vcGFyYW xsZWxzLmNvbS9zY 2hlbWFzL2tleXMvcHJvZHVjd HMvcHAtc21iL3VuaXgvMTAuMCI DOotlDwhLSOgVW5pcXVIIHByb2R1Y3QgS2V5IG51bWJ IcgOKICAtLT4gDQogIDxjb3JlIOmtleS 1 udW 1iZXIgY29yZTp0eXBIPSJzdHJpbmciPINNQi4wM DAwMDAwMDwvY29yZTprZXktbnVtYmVyPiANCIOgPCEtLSBLZXkgdmVyc2lvbgOKICAtLT4 gDOogIDxjb3JIOmtleS12ZXJzaW 9ulGNvcmU6dHlwZTOic3RyaW5dnlj4wMDAwPC9jb3JlOmtl eS12ZXJzaW9uPiANCi0gPCEtLSBLZXkgZGVzY3JpcHRpb24NCiAgLS0 IAOKLSA8Y29yZT pkZXNjcmlwdGlvbj4NCiAgPGNvcmU6a2V5dHIwZT 5QY XJhbGxlbHMgUGFuZWwgMT AgUO 1CIEVkaXRpb24gZm9ylFVuaxgvT GludXg8L2NvcmU6a
144. ket vom APS Katalog herunterzuladen erstellen Sie ein XML Abfrage Paket mit dem aps download package Kontrollknoten lt packet version 1 6 2 0 gt lt aps gt lt download package gt lt download package gt lt aps gt lt packet gt Falls die Operation erfolgreich durchgef hrt wird wird ein Download Task erstellt Hinweis Eine Operation ist nicht nur dann erfolgreich wenn ein Download Vorgang gestartet wird Ob ein Download Vorgang tats chlich erfolgreich war oder nicht sollte mithilfe der get download status auf Seite 174 Operation berpr ft werden In diesem Abschnitt Struktur des Abfrage Pakets 4444444444H nnnnnnnnnnnnnnnnnnnnnnannnnnnnnnnnnnnnnnnnnn 168 Beispiele f r Abfragen eni ununsseneneilenaie 170 Struktur des Antwortpakets uusssssnnsssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennnnnnnnnnnnnnnnnn 171 ANIWOrFBEISBIE Essen one egtiandeeaneatd 172 Struktur des Abfrage Pakets Der download package Knoten ist wie folgt strukturiert APSPackageDownloadinputType APSidentifierType _ n 4 package release Im un g download package E 1 F packager ee J Einrichten ber Remote API 169 package erforderlich Beinhaltet eine Reihe von Daten die das Zielpaket beschreiben Datentyp APSldentifierType aps xsd Die Werte f r die untergeordneten Child Knoten sollten den entsprechenden Elementen eine
145. lWare lt value gt lt setting gt lt setting gt lt name gt locale lt name gt lt value gt en US lt value gt lt setting gt lt settings gt Einrichten ber CLI 233 Verf gbare Pakete abrufen Um die Informationen ID Name Version Release Anbieter Verpacker zu den f r die Installation verf gbaren Anwendungspakete abzurufen f hren Sie den folgenden Befehl aus aps lt get packages list gp gt Nimmt die folgenden Formen an Auf Linux Unix aps gp Auf Windows aps gp
146. ld Elemente bis auf die f r Betriebbssysteme und Architekturen f r die zus tzliche Site Design Templates von Site Editor unterst tzt werden sollen Hinweis Weitere Informationen zu dem Dienstprogramm Rsync finden Sie unter http samba anu edu au rsync Verteilung des Panels 31 Mirrors von Windows Distributionen erstellen Das Repository von Parallels Small Business Panel f r Windows befindet sich unter http autoinstall win parallels com und ist wie folgt strukturiert es werden nur die Dateien und Verzeichnisse aufgelistet die f r das Erstellen von Mirrors der Panel Pakete relevant sind lt PRODUKTNAME gt lt Produkt_Version gt Mehrere Unterverzeichnisse werden in bereinstimmung mit den Panel Versionen genannt In unserem Fall ist das Unterverzeichnis PPSMBE WIN lt Version gt interessant z B PPSMBE WIN 10 2 0 Jedes dieser Unterverzeichnisse enth lt die folgenden Dateien dist lt Typ gt lt Name des Betriebssystems gt lt Version gt lt Architektur gt Enth lt Distributionspakete des Panels oder die Design Templates z B dist msi Microsoft 2003 i386 thirdparty lt Typ gt lt Name des Betriebssystems gt lt Version gt lt Archiekt ur gt weitere Drittanbieter Pakete ppsmbe lt Parallels Panel Version gt lt Name des Betriebssystems gt lt Ar chitektur gt inf3 Parallels Installer Konfigurationsdatei products inf3 Die Parallels
147. le to meet ASP NET version requirements ASP NET version 2 0 is erforderlich Unable to meet ASP NET version requirements ASP NET version 2 0 is erforderlich Unable to meet database server requirements Database server with type mssql and version not less 9 0 not found lt errtext gt lt result gt lt install gt lt aps gt lt packet gt Sonstige Fehlermeldungen Folgende negative Antwort wird empfangen wenn das Abfrage Paket festlegt dass die Anwendung Uber HTTPS lt ssl gt true lt ssl gt verf gbar sein soll aber HTTPS auf der Domain Subdomain nicht unterst tzt wird ABFRAGE PAKET lt packet version 1 6 2 0 gt Einrichten ber Remote API lt aps gt lt install gt lt domain id gt 2 lt domain id gt lt package gt lt name gt joomla lt name gt lt package gt lt ssl gt true lt ssi gt lt settings gt lt setting gt lt name gt admin_name lt name gt lt value gt admin lt value gt lt setting gt lt setting gt lt name gt admin_password lt name gt lt value gt dfkjEEtbgg lt value gt lt setting gt lt setting gt lt name gt admin_email lt name gt lt value gt johndoe example com lt value gt lt setting gt lt setting gt lt name gt locale lt name gt lt value gt en GB lt value gt lt setting gt lt setting gt lt namestitle lt name gt lt value gt Joomla lt value gt lt setting gt lt settings gt lt install gt
148. lercode wieder Datentyp integer errtext erforderlich falls die Operation fehlschl gt Gibt die Fehlermeldung wieder Datentyp string filter id erforderlich falls die Operation erfolgreich durchgef hrt werden kann Gibt die Paket ID an nach der die Operation gefiltert wurde Datentyp any id optional Nicht angegeben package id erforderlich falls die Operation erfolgreich abgeschlossen wird Beinhaltet eine Reihe von Daten die das Paket beschreiben Datentyp APSldentifierType aps xsd Wie folgt strukturiert APSldentifier Type extension package E EH release m m m m m mn mn mnan mn n name erforderlich Gibt den Namen des Anwendungspakets an Datentyp string version optional Gibt die Anwendungsversion an Datentyp string release optional Gibt die Anwendungs Release an Datentyp string vendor optional Beinhaltet Informationen ber den Anbieter der Anwendung Datentyp string packager optional Beinhaltet Informationen ber den Packager Verpacker der Anwendung Datentyp string id erforderlich Gibt die ID an die dem Paket von dem Server zugewiesen wurde Datentyp id_type common xsd 204 Einrichten ber Remote API Abfrage und Antwort Beispiele Beispiel 1 Abfrage Dieses Paket ruft Informationen zu allen APS Paketen ab lt packet version 1 6 2 0 gt lt aps gt lt get packages list gt lt filter gt lt get packages list gt lt
149. lgende Antwort wird vom Windows Server empfangen wenn eine Transaktion ausgef hrt wird lt packet version 1 6 2 0 gt lt aps gt 184 Einrichten ber Remote API lt get download status gt lt result gt lt status gt ok lt status gt lt filter id gt 38 lt filter id gt lt id gt 38 lt id gt lt task gt lt id gt 38 lt id gt lt in progress gt lt total gt 0 lt total gt lt completed gt 0 lt completed gt lt in progress gt lt task gt lt result gt lt get download status gt lt aps gt lt packet gt Antwort C Folgende Antwort wird empfangen wenn keine Download Transaktion durchgef hrt wird lt packet version 1 6 2 0 gt lt aps gt lt get download status gt lt result gt lt status gt ok lt status gt lt result gt lt get download status gt lt aps gt lt packet gt Einrichten ber Remote API 185 Installieren einer Anwendung Bei der Installation einer Anwendung ist es erforderlich dass Sie angeben welches Paket als Quelle f r die Installation verwendet werden soll Das Paket wird entweder ber die zugewiesene ID ermittelt wenn das Paket in das Panel importiert wird oder ber die Paketinformationen package name version release vendor packager Paketname Version Release Anbieter Verpacker W hlen Sie einen der folgenden Schritte um eine Paket ID anzugeben verwenden Sie die ID die dem Paket beim Import in das Panel zugewiesen wurde auf Seite 16
150. lt filter id gt 18 lt filter id gt lt id gt 18 lt id gt lt task gt lt id gt 18 lt id gt lt finished gt lt package id gt 13 lt package id gt lt finished gt lt task gt lt result gt Einrichten ber Remote API 181 lt get download status gt lt aps gt lt packet gt Antwort B Folgende Antwort wird empfangen wenn ein Download Task nicht gestartet wurde oder mit Fehlern beendet wurde lt packet version 1 6 2 0 gt lt aps gt lt get download status gt lt result gt lt status gt ok lt status gt lt filter id gt 18 lt filter id gt lt id gt 18 lt id gt lt task gt lt id gt 18 lt id gt lt finished gt lt error gt Cannot download package from catalog lt error gt lt finished gt lt task gt lt result gt lt get download status gt lt aps gt lt packet gt Antwort C Folgende negative Antwort wird empfangen wenn ein Download Task mit der angeforderten ID nicht existiert lt packet version 1 6 2 0 gt lt aps gt lt get download status gt lt result gt lt status gt error lt status gt lt errcode gt 1013 lt errcode gt lt errtext gt Download task with id 18 not found lt errtext gt lt filter id gt 181 lt filter id gt lt result gt 182 Einrichten ber Remote API lt get download status gt lt aps gt lt packet gt Beispiel 2 Abfrage Dieses Paket fragt den Status aller Download Tasks innerhalb einer aktuellen Downlo
151. n 1 6 2 0 gt lt dns gt lt disable gt lt dns gt lt packet gt Einrichten ber Remote API 101 Antwortpaket Der disable Knoten des ausgegebenen XML Pakets ist wie folgt strukturiert resulttOpType result erforderlich Verpackt die vom Server abgerufene Antwort Datentyp resultType common xsd status erforderlich Gibt den Ausf hrungsstatus der Operation an Datentyp string Zul ssige Werte ok error errcode erforderlich falls die Operation fehlschl gt Gibt den Fehlercode wieder Datentyp integer errtext erforderlich falls die Operation fehlschl gt Gibt die Fehlermeldung wieder Datentyp string Beispiel Eine positive Antwort sieht wie folgt aus lt packet version 1 6 2 0 gt lt dns gt lt disable gt lt result gt lt status gt ok lt status gt lt result gt lt disable gt lt dns gt lt packet gt 102 Einrichten ber Remote API Andern des SOA Record Templates Um ein neues SOA Record Template einzurichten erstellen Sie ein XML Abfrage Paket das den dnsiset Kontrollknoten enth lt lt packet version 1 6 2 0 gt lt dns gt lt set gt lt set gt lt dns gt lt packet gt In diesem Abschnitt Struktur des Abfrage Pakets cccccceeeess sseceeeeeeeeeeeeensaeaeeeeeeeseeenenseenaneeeees 102 Beispiele f r Abfragen ccccccceeeeeeeeeeeeneceeee eee eeeegegaaeaeeeeeeeeetegenaaeaeeeeeeeeenene 103
152. nd ist die Angabe der FTP Account Einstellungen optional und wird nur vorgenommen wenn ein separater FTP Account erforderlich ist um auf den Inhalt einer Subdomain zu zugreifen Um eine Subdomain auf einem Unterordner zu erstellen nur Windows Unterst tzung geben Sie den Namen der bergeordneten Domain Subdomain den Subdomain Namen und den Pfad zu einem Ordner an auf dem die Subdomain erstellt wird Hinweis F r Subdomains auf einem Unterordner ist die Erstellung eines separaten FTP Benutzer Accounts nicht m glich es wird immer der FTP Benutzer Account der bergeordneten Domain Subdomain verwendet Quicklinks Erstellung von Subdomains ber API auf Seite 141 Erstellung von Subdomains ber CLI auf Seite 223 berblick zu Setupvorg ngen 45 Installieren von Anwendungen Parallels Small Business Panel unterst tzt APS Applikationen Dabei handelt es sich um Webanwendungen die gem dem APS Application Packaging Standard http www apsstandard org verpackt werden wodurch das SaaS Modell ins Hosting Business integriert werden kann Wir unterscheiden den Term Anwendungspaket ein Zip Archiv mit einer Webanwendung die in dem APS Format verpackt wurde Im Gegensatz zu der Anwendung an sich die von dem Paket aus installiert wird F r die Installation einer Anwendung auf einer Domain oder Subdomain sind zwei Schritte notwendig 1 Erhalt des Anwendungspakets und der Import in das Panel 2 Installation der Anwen
153. nden Formatierungen werden spezielle Informationen im Text identifiziert Formatierungskonvention Informationstyp Titel von Kapiteln Abschnitten und Unterabschnitten Elemente die Sie ausw hlen m ssen z B Men optionen Befehlsbuttons oder Elemente einer Liste Kursiv Wird verwendet um die Wichtigkeit einer Aussage zu betonen einen Begriff vorzustellen oder einen Befehlszeilen Platzhalter anzugeben der durch einen echten Namen oder Wert zu ersetzen ist Monospace Die Namen von Befehlen Dateien und Verzeichnissen Gehen Sie zur Registerkarte System Lesen Sie das Kapitel Administrationsgrundlagen Das System unterst tzt die so genannte Suche mit Platzhalterzeichen Die Lizenzdatei befindet sich im Verzeichnis http docs common licen Ses Einleitung 5 Vorformatiert Bildschirmausgabe in ls al files Befehlszeilensitzungen Gesamt 14470 Quellcode in XML C oder anderen Programmiersprachen Vorformatiert Fett Was Sie eingeben in cd root rpms php Kontrast zur Bildschirmausgabe GROSSBUCHSTABEN Namen von Tasten auf der UMSCHALTTASTE STRG ALT Tastatur TASTE TASTE Tastenkombinationen bei STRG P ALT F4 denen der Benutzer eine Taste dr cken und gedr ckt halten und dann eine weitere Taste dr cken muss Feedback Wenn Sie einen Fehler in diesem Handbuch gefunden haben oder Verbesserungsvorschl ge machen m chten k nnen Sie uns Ihr Feedback ber das Onlineformular
154. ndor lt vendor name gt package packager lt packager name gt gt ist verantwortlich f r die Angabe des Pakets von dem aus die Anwendung installiert wird Das Paket wird entweder ber die ID oder ber Name Version Release Anbieter und Packager Verpacker ermittelt Diese Paketeigenschaften k nnen ber den get packages list Befehl auf Seite 233 abgefragt werden der Teil lt domain lt domain name gt gt lt subdomain lt subdomain name gt gt verantwortlich ist fur die Angabe der Ziel Domain oder Subdomain wo die Anwendung installiert wurde Verfugbare Optionen ssl true fals Gibt an ob eine Anwendung Uber das HTTPS Protokoll zur e Verf gung stehen wird oder nicht 230 Einrichten ber CLI url pref lt prefix gt Gibt die zur Domain Subdomain zugeh rige URL an ber welche ix die installierte Anwendung im Internet verf gbar sein wird Beispiel Wenn Sie beispielsweise eine Blog Engine Anwendung installieren und das URL Pr fix olog angeben wird die Anwendung unter http domain name blog verf gbar sein db name lt name gt Gibt den Namen der Datenbank an die w hrend der Installation f r die Anwendung erstellt wird db user lt login Gibt den Namen des Datenbankbenutzers an der w hrend name gt der Installation f r die Anwendung erstellt wird passwd lt password gt Gibt den Namen des Datenbankpassworts an die w hrend der Installation f r die Anwendung e
155. nnnnnnnnnnnnnnnnn 47 34 berblick zu Setupvorg ngen Initialisierung des Panels Nach der Installation des Panels muss es im ersten Schritt initialisiert werden Es ist nicht zul ssig andere Operationen weder in der Benutzeroberfl che des Panels noch ber die API auszuf hren W hrend der Initialisierung werden folgende Panel Einstellungen konfiguriert E Mail Adresse des Administrators das neue Passwort des Administrators anstelle des standardm ig eingerichteten Passworts optional Panel Sprache Wenn w hrend der Initialisierung des Panels keine Spracheinstellungen konfiguriert werdem wird die standardm ig voreingestellte Sprache American English en US verwendet Die Sprache der Benutzeroberfl che kann zu einem sp teren Zeitpunkt vom Panel Administrator jederzeit ge ndert werden vorausgesetzt die ben tigte Sprachkomponente auf Seite 12 wurde installiert Falls Sie eine benutzerdefinierte Lokalisierung des Panels bereitstellen m ssen Sie ein benutzerdefiniertes Sprachpaket vor der Initialisierung des Panels importieren Weitere Informationen finden Sie in der Lokalisierungsanleitung f r Parallels Small Business Panel welches auf der Dokumentationsseite des Panels http www parallels com products small business panel documentation zur Verf gung steht Quicklinks Initialisierung des Panels ber Remote API auf Seite 89 Initialisierung des Panel ber die Befehlszeilenoberfl c
156. nnnnnnnnnnnnnnnnnnnn 180 Struktur des Abfrage Pakets Der get download package Knoten ist wie folgt strukturiert APSPackageDownloadStatusinputType a fc 1 0 Filter tasks to be retrieved Einrichten ber Remote API 175 filter erforderlich Filtert Download Vorg nge deren Status abgefragt werden soll Datentyp none Falls an dieser Stelle kein Wert definiert wurde dann wird eine Liste mit allen Download Tasks innerhalb der aktuellen Download Transaktion wiedergegeben Auf Windows wird f r jeden Download Task eine separate Transaktion erstellt Die Download Transaktion dauert so lange wie der Download Task task id optional Gibt die ID des Download Tasks an wiedergegeben als das Ergebnis der lt download package gt Operation Datentyp id_type common xsd 176 Einrichten ber Remote API Beispiele f r Abfragen Dieses Paket fragt den Status der aktuellen Download Transaktion ab lt packet version 1 6 2 0 gt lt aps gt lt get download status gt lt filter gt lt get download status gt lt aps gt lt packet gt Dieses Paket fragt den Status der Download Tasks mit den IDs 10 11 und 12 ab lt packet version 1 6 2 0 gt lt aps gt lt get download status gt lt filter gt lt task id gt 10 lt task id gt lt task id gt 11 lt task id gt lt task id gt 12 lt task id gt lt filter gt lt get download status gt lt aps gt lt packet gt Ein
157. nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennnnnnn 46 Verf gbare APS Kataloge definieren 22044240044440snnnnnnnnnnnnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 47 Konfigurationsdatei von APS Katalogen 240u04200nnnnnnnnnnnnnnnnnnnnnnnnnnnnennnnnnnnen 49 Einrichten ber Remote API 50 Remote API verwenden ee ende saeco aust 51 Uber REMmOte AP heu a a A A ET O 52 JaN N n AOE me LEE AER E er A A A A Sneha cal aet ase 53 Erstellen der Client Software 20rs40usrsnennnnnnnnnnnnnnnnnnnnnnnnnennnnnnnnnnnnnnnnnnnnnnnnnn ran 57 Einrichten des Panels 3 3 1 a Sn a en an SE ates ANS ios font AER al 89 Einleitung Initialisierung des Panels 444ssrnnnnsnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennnnnnennnnnnennnnnnn 89 Installation des Lizenzschl ssels uuuunununeeannnunesnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 94 DNS Konfiguration 220022424444004nn00nnnnnnnnnnnnannnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnannnnnn 100 Installation von SSL Zertifikaten uuuuunsnnanannnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnen 128 Erstellen von Domains arianna aaan i a a ai RES 135 Erstellen von Subdomains uuuuesssnsnnnnnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnen 141 Verf gbare APS Kataloge definieren 240srsn0usnnnnnnnnnennnnennnnnnnnnnnnnnnnnnnn ran 146 Installieren von Anwendungen
158. nstall gt lt aps gt lt packet gt 3 Folgende negative Antwort wird empfangen wenn das als URL Prafix definierte Webverzeichnis bereits existiert und f r einen anderen Content bereits verwendet wird lt packet version 1 6 2 0 gt lt aps gt lt install gt lt result gt lt status gt error lt status gt lt errcode gt 1019 lt errcode gt lt errtext gt Some errors occurred during installation Destination directory already exists and is used by another Web application lt errtext gt lt result gt lt install gt lt aps gt lt packet gt 4 Folgende negative Antwort wird empfangen wenn die in dem Abfrage Paket definierte Datenbank bereits existiert lt packet version 1 6 2 0 gt lt aps gt lt install gt lt result gt lt status gt error lt status gt 198 Einrichten ber Remote API lt errcode gt 1019 lt errcode gt lt errtext gt Some errors occurred during installation Database with requested name already exists lt errtext gt lt result gt lt install gt lt aps gt lt packet gt Fehlermeldung 1100 requirements not met Folgende negative Antwort wird empfangen wenn die Anwendungsvoraussetzungen nicht ausreichend erf llt werden lt packet version 1 6 2 0 gt lt aps gt lt install gt lt result gt lt status gt error lt status gt lt errcode gt 1100 lt errcode gt lt errtext gt The following problems with requirements were found Unab
159. nstallj i gt lt path to key file gt Beispiele 1 Auf Linux Unix license i tmp psmbful0key xml 2 Auf Windows license exe i D keys psmbfwl0key xml Branding des Panels Zur Konfiguration des Panel Brandings verwenden Sie das branding Dienstprogramm In diesem Abschnitt Andetades LOgds a icnccacher ea 212 Andern der SUPPOT URE u 22 rear 213 212 Einrichten ber CLI ndern des Logos Um das Panel Logo und die URL zu ndern sollten Sie die folgenden zwei Schritte durchf hren 1 F hren Sie einen Befehl in dem folgendem Format aus um das Logo ndern zu k nnen und eine Bilddatei hochzuladen branding lt use custom logo u gt true path lt path_to file gt 2 Mithilfe eines Befehls in dem folgenden Format k nnen Sie eine benutzerdefinierte URL einrichten braned nge aa Change Skog oO ita ls les tire Uline Beispiele 1 Der folgende Befehl erm glicht die Anpassung des Logos und verwendet als Logo die Bilddatei my own cool logo gif die sich in dem Verzeichnis temp befindet Auf Linux Unix branding u true path temp my own cool logo gif Auf Windows branding exe u true path D temp my own cool logo gif 2 Mithilfe des folgenden Befehls wird festgelegt dass sich die URL http example com about beim Anklicken des Panel Logos ffnet Auf Linux Unix branding 1 url http example com about Auf Windows branding exe 1 url http example com about Einrichten ber CL
160. olgt strukturiert ist SubdomainAddinputType Subdomain opertyType LE property EXC tert a 0 co 142 Einrichten ber Remote API parent erforderlich Gibt den Namen der Domain Subdomain an auf der eine Subdomain erstellt wird bergeordnete Parent Subdomains werden nur auf Windows unterst tzt Datentyp string name erforderlich Gibt den Namen der Subdomain an Datentyp string home erforderlich falls eine Subdomain auf einem Unterordner erstellt wird nur bei Windows Gibt den Pfad zum Home Verzeichnis der Subdomain an Datentyp string Falls es hier keinen Eintrag gibt lt home gt wird das root Verzeichnis der bergeordneten Parent Domain verwendet property optional Definiert eine Hostingeinstellung der erstellten Subdomain Datentyp SubdomainPropertyType subdomain xsd name erforderlich Gibt einen Hosting Parameter Namen an Datentyp string value erforderlich Gibt einen Hosting Parameter Wert an Datentyp any Einrichten ber Remote API 143 Beispiele f r Abfragen Dieses Paket erstellt die Subdomain forum example com lt packet version 1 6 2 0 gt lt subdomain gt lt add gt lt parent gt example com lt parent gt lt name gt forum lt name gt lt property gt lt name gt ftp_login lt name gt lt value gt john lt value gt lt property gt lt property gt lt name gt ftp_password lt name gt lt value gt sam
161. om ssl true Einrichten ber CLI 231 In diesem Abschnitt Definieren von Anwendungseinstellungen 44444ssnnnsnsnnnnnnnnnnnnnnnnnnnnnnnn 231 Definieren von Anwendungseinstellungen Falls eine Anwendung ber Einstellungen verf gt fragt das aps Dienstprogramm nach festgelegten Anwendungseinstellungen aus einer Datei oder aus STDIN wenn die Anwendungsinstanz auf einer Domain oder Subdomain installiert wird Die Anwendungseinstellungen sollten in einer XML Datei mit der folgenden Struktur definiert werden T_settings settings BB c 1 0 232 Einrichten ber CLI settings erforderlich XML Wurzelelement beinhaltet eine Reihe von Einstellungen setting erforderlich Beinhaltet eine Definition von Anwendungseinstellungen name erforderlich Gibt den Namen der Einstellung an der von der Einstellungs ID setting id in der Metadaten Datei des Anwendungspakets APP META xm1 befindet sich in dem Anwendungspaket app zip abgeleitet wird value erforderlich Gibt den Wert f r die Einstellung an Beispiel lt xml version 1 0 encoding UTF 8 gt lt settings gt lt setting gt lt name gt admin_email lt name gt lt value gt johndoe example com lt value gt lt setting gt lt setting gt lt name gt admin_passwd lt name gt lt value gt p4 w0rd lt value gt lt setting gt lt setting gt lt name gt site_name lt name gt lt value gt iScripts socia
162. oneoet 221 Zuweisen des Zertifikats zu einer IP Adresse u nuuunasssnsnsnnnnannnsnnnnnnnnnnnnnnnn 222 Einrichten ber CLI 221 Import des Zertifikats Um ein Zertifikat zu importieren f hren Sie den Befehl in dem folgenden Format aus certificate lt create c gt lt name gt admin key file lt private key file gt cert file lt certificate file gt cacert file lt CA certificate file gt csr file lt certificate signing request file gt Beispiele 1 Der folgende Befehl importiert das SSL Zertifikat mit der privaten Schl ssel Datei usr local keys keyfile key und der Zertifikatsdatei usr local cert certfile cert Nach dem Import hei t das Zertifikat Site Certificate Auf Linux Unix certificate create Site Certificate admin key file usr local keyfile key cert file usr local cert certfile cert oder certificate c Site Certificate admin key file usr local keyfile key cert file usr local cert certfile cert Auf Windows die Dateien f r diese Zertifikatsbestandteile befinden sich im Verzeichnis E temp certificate create Site Certificate admin key file E temp keyfile key cert file E temp certfile cert oder certificate c Site Certificate admin key file E temp keyfile key cert file E temp certfile cert 2 Der folgende Befehl importiert das SSL Zertifikat mit der privaten Schl ssel Datei usr local keys keyfile key die Zertif
163. pfangen wird kann wie folgt aussehen lt xml version 1 0 gt lt packet version 1 6 2 0 gt lt domain gt lt add gt lt result gt lt status gt ok lt status gt lt id gt 6 lt id gt lt guid gt 5c0e3881 22a2 4401 bcc0 881d691 bfdef lt guid gt lt result gt lt add gt lt domain gt lt packet gt Einrichten ber Remote API 83 Dieses Paket berichtet ber das Ergebnis der add Operation und der ID und GUID von der gerade erstellten Domain Code Beispiel Imports System Imports System Net Imports System Text Imports System IO Imports System Xml Imports System Xml Schema Imports System Security Cryptography X509Certificates Imports System Net Security Namespace ParallelsPanelApiRpcClient Public Class Request Public interface Public Hostname As String localhost The Panel Host name PibloLaL e Ilgefepiai As Cringe Me elunaligl Oa Administrator s Login Public Password As String admin setup Administrator s Password PUDIM Iic morwoull JNs Sycialinoe ELDER API RPC Version Protocol Handler for receiving information about document type definition DTD XML Data Reduced XDR schema and XML Schema definition language XSD schema validation errors Public XmlSchemaValidation As ValidationEventHandler Public ReadOnly Property AgentEntryPoint As String Get Return https amp Me Hostname amp 84
164. ple lt value gt lt property gt lt add gt lt subdomain gt lt packet gt Eine Subdomain auf einem Unterordner erstellen Dieses Paket erstellt eine Subdomain blog example com auf dem Unterordner httpdocs BlogEngine lt packet version 1 6 2 0 gt lt subdomain gt lt add gt lt parent gt example com lt parent gt lt name gt blog lt name gt lt home gt httpdocs BlogEngine lt home gt lt add gt lt subdomain gt lt packet gt 144 Einrichten ber Remote API Struktur des Antwortpakets Der add Knoten des ausgegebenen XML Pakets ist wie folgt strukturiert SubdomainAddOutputType resultType extension Result status ok error 7 errcode on 0 Error code if error occumed iia 1 2 errtext EZ Error message if error occured M id ubdomain I result erforderlich Verpackt die vom Server abgerufene Antwort Datentyp resultType common xsd status erforderlich Gibt den Ausf hrungsstatus der Operation an Datentyp string Zul ssige Werte ok error errcode erforderlich falls die Operation fehlschl gt Gibt den Fehlercode wieder Datentyp integer errtext erforderlich falls die Operation fehlschl gt Gibt die Fehlermeldung wieder Datentyp string id erforderlich falls die Operation erfolgreich abgeschlossen wird Liefert den eindeutigen Identifier erstellten Subdomain Datentyp id_type common xsd Ope
165. ponenten wie z B SpamAssassin Spamfilter Ruby on Rails Framework Parallels Premium Antivirus weitere Site Editor Templates und andere Komponenten Falls eine erweiterte Version des Panels installiert werden soll installieren Sie beide Templates F r die Installation eines Panel Templates auf dem Ziel Hardware Node k nnen Sie eine der folgenden zwei Methoden w hlen Verwenden Sie das Dienstprogramm vzup2date Weitere Details finden Sie in dem Referenzhandbuch Parallels Containers f r Linux verf gbar im Parallels Technology Network http www parallels com ptn documentation virtuozzo Laden Sie sich das Template direkt von der Parallels Website http www parallels com herunter und installieren Sie es mit dem Dienstprogramm vzpkg Wenn das Template auf einem Hardware Node installiert wird werden die wichtigsten Dateien verteilt dazu z hlt die Definition des Repositorys f r Anwendungspakete Sollte die Anwendung anschlie end in einem Container installiert werden kommuniziert Parallels Containers mit dem Repository das Standard Repository f r Parallels Small Business Panel f r Linux Unix ist der Parallels Updates Server unter http autoinstall plesk com und fragt dort die Anwendungspakete ab und installiert diese in dem Container Die Pakete werden so lange im Cache des Nodes gespeichert bis dieser geleert wird Dann werden die Pakete wieder ber das Repository abgefragt wenn die Anwendung in dem Container installier
166. ps HttpWebRequest Schickt dieses Objekt zur ck Leitet die URI des Validierungsschemas und einen String Reader mit der URI des zu validierenden XML Pakets an die Eingabe Parameter weiter Validiert das Paket und gibt es in der Baumstruktur wieder ein XmIDocument Objekt Leitet das Abfrage Paket HttpWebRequest Objekt an die Eingabe Parameter weiter Versendet das Paket per HTTP empfangt das Antwortpaket vom Server validiert es mithilfe des Validierungsschemas und liefert das XML Paket in der Baumstruktur ein XmIDocument Objekt Einrichten ber Remote API 81 Die Program Klasse implementiert die client Konsolenanwendung Shared Sub Main ByVal args As Srewaing Private Shared Function RemoteCertificateValidation ByVal sender As Object ByVal certificate As X509Certificate ByVal chain As X509Chain ByVal sslPolicyErrors As SS ILCs Syidieicoies Private Shared Sub XmlSchemaValidation ByVal sender As Object ByVal e As ValidationEventArgs Private Shared Sub Ein Einsprungspunkt zu der PanelApiRpcClient Anwendung Leitet eine Reihe an Argumenten Strings an die Eingabe Parameter weiter Die Argumente sind 0 der Host Name IP Adresse des vom Panel verwalteten Servers 1 das Login des Panel Administrators 2 das Passwort des Panel Administrators 3 das verwendete API RPC Protokoll 4 einem Pfad zu der XML Datei mit einem
167. quest As HttpWebRequest As Xml Document Using response As HttpWebResponse DirectCast request GetResponse HttpWebResponse 86 Einrichten ber Remote API Using stream As Stream response GetResponseStream Using reader As TextReader New StreamReader stream return Me ParseAndValidate reader Me OutputValidationSchema End Using End Using End Using A 3 d Function End Class Friend Class Program Shared Sub Main ByVal args As String If args Length lt 5 Then Console WriteLine Usage PanelApiRpcClient lt Hostname gt lt Login gt lt Password gt lt Protocol gt lt Request gt Console WriteLine Console WriteLine Host nam The Panel s host name Console WriteLine Login Administrator s login Console WriteLine Password Administrator s password Console WriteLine Protocol API RPC protocol version Console WriteLine Request Request file path xml Else Verifies the remote Secure Sockets Layer SSL certificate x used for authentication ServicePointManager ServerCertificateValidationCallback New RemoteCertificateValidationCallback AddressOf Program RemoteCertificateValidation Dim request As New Request request XmlSchemaValidation New ValidationEventHandler AddressOf Program XmlSchemaValidation request Hos
168. r fungen h ngen bleibt z B die angefragte Operation konnte bisher noch nicht ausgef hrt werden dann wird ein Antwortpaket mit den folgenden Elementen erstellt system enth lt eine Fehlerbeschreibung definiert von dem Typ resultType in dem common xsd Schema output ein optionales Element dass eine Nachricht von stderr sofern nicht leer der fehlgeschlagenen Komponente enth lt definiert von dem Typ garbageOutput in dem plesk_common xsd Schema Beispiel Die Antwort die von dem Panel API RPC Server empfangen wurde beim Versuch eine nicht existente Version des API RPC Protokolls zu verwenden sieht wie folgt aus 64 Einrichten ber Remote API lt packet version 1 60 2 0 gt lt system gt lt status gt error lt status gt lt errcode gt 1005 lt errcode gt lt errtext gt API RPC protocol version not supported lt errtext gt lt system gt lt output gt lt output gt lt packet gt Ausf hrungsfehler Wenn alle berpr fungen erfolgreich durchgef hrt werden konnten werden die ausgew hlten Agents versuchen die angefragten Operationen der Reihe nach auszuf hren Falls eine Operation fehlschl gt berichtet der entsprechende Agent ber den Ausf hrungsfehler Alle Berichte werden vom Agent Engine gesammelt und dieser erstellt ein Antwortpaket basierend auf den Ausgabedaten der XML Schemata Wenn beispielsweise keine Domain erstellt werden konnte dann erstellt der Domain Operator
169. r ID setemplates aus wenn das zus tzliche Set an Site Design Templates f r Site Editor unterst tzt werden sollen b Bearbeiten Sie die Datei ppsmbe inf3 und entfernen Sie alle Build Elemente bis auf die f r Betriebbssysteme und Architekturen die vom Mirror unterst tzt werden sollen Hinweis Weitere Informationen zu dem Dienstprogramm Rsync finden Sie unter http samba anu edu au rsync KAPITEL 4 berblick zu Setupvorg ngen In diesem Kapitel erhalten Sie einen berblick ber die wichtigsten Setup Vorg nge w hrend der Bereitstellung des Parallels Small Business Panel Die Beschreibungen der Vorg nge in diesem Kapitel werden in der Reihenfolge aufgef hrt wie sie am besten durchgef hrt werden sollten In diesem Kapitel Initialisierung des Panels een 34 Installation des Lizenzschl ssels 22444440040444nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 35 Branding des Panels 36 Anpassen von Service Links uuuums44444nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 36 DNS Konfiguration 2 area ale Antena Genin ne 40 Installation von SSL Zertifikaten eeecceceeeeeeeeeeecceeeeeeeeeeeeeeaaaaeeeeeeeeeeeeeeaaaaes 42 Erstellen von Domains und Subdomains u sssssssssnnnnnnnnennnnnnne nennen 43 Installieren von Anwendungen usss444nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 45 Verf gbare APS Kataloge definieren 4444444440nnnnnnnnnn
170. rations spezifische Fehler 1007 Subdomain mit einem solchen Namen existiert bereits 1015 bergeordnete Parent Domain Subdomain wurde nicht gefunden 1019 Ung ltige Eigenschaft angegeben 1023 Operation fehlgeschlagen Einrichten ber Remote API 145 Antwort Beispiele Eine positive Antwort vom Server nach der Erstellung der Subdomain sieht wie folgt aus lt packet version 1 6 2 0 gt lt subdomain gt lt add gt lt result gt lt status gt ok lt status gt lt id gt 1 lt id gt lt result gt lt add gt lt subdomain gt lt packet gt Folgende negative Antwort wird empfangen falls die angegebene Subdomain bereits existiert ABFRAGE PAKET lt packet version 1 6 2 0 gt lt subdomain gt lt add gt lt parent gt example com lt parent gt lt name gt blog lt name gt lt add gt lt subdomain gt lt packet gt ANTWORTPAKET lt packet version 1 6 2 0 gt lt subdomain gt lt add gt lt result gt lt status gt error lt status gt lt errcode gt 1007 lt errcode gt lt errtext gt The subdomain with such name already exists lt errtext gt lt result gt lt add gt 146 Einrichten ber Remote API lt subdomain gt lt packet gt Verf gbare APS Kataloge definieren Um eine benutzerdefinierte Liste Konfigurationsdatei des APS Katalogs in das Panel zu importieren erstellen Sie ein XML Abfrage Paket mit dem aps import config Kontrollknoten l
171. rcode gt 1013 lt errcode gt lt errtext gt Domain not found lt errtext gt lt result gt lt install gt lt aps gt lt packet gt 2 Folgende negative Antwort wird empfangen wenn ein angefordertes Paket nicht auf dem Server gefunden werden konnte lt packet version 1 6 2 0 gt lt aps gt lt install gt lt result gt lt status gt error lt status gt Einrichten ber Remote API 195 lt errcode gt 1013 lt errcode gt lt errtext gt Package does not exist lt errtext gt lt result gt lt install gt lt aps gt lt packet gt Fehlermeldungen 1019 bad settings 1 Folgende negative Antwort wird empfangen wenn manche Anwendungseinstellungen nicht ber Standardwerte verf gen und das Abfrage Paket die Einstellungsspezifikation nicht enth lt ABFRAGE PAKET lt packet version 1 6 2 0 gt lt aps gt lt install gt lt domain name gt example com lt domain name gt lt package gt lt name gt Autolndex lt name gt lt package gt lt install gt lt aps gt lt packet gt ANTWORTPAKET lt packet version 1 6 2 0 gt lt aps gt lt install gt lt result gt lt status gt error lt status gt lt errcode gt 1019 lt errcode gt lt errtext gt Some errors occurred during installation Value of setting admin_password is invalid is less than 1 characters long Value of setting user_password is invalid is less than 1 characters long lt errtext
172. renden XML Pakets an die Eingabe Parameter weiter Validiert das Paket und gibt es in der Baumstruktur wieder ein XmIDocument Objekt Leitet das Abfrage Paket HttpWebRequest Objekt an die Eingabe Parameter weiter Versendet das Paket per HTTP empf ngt das Antwortpaket vom Server validiert es mithilfe des agent output xsd Schemas und gibt das XML Paket in der Baumstruktur wieder ein XmIDocument Objekt Einrichten ber Remote API 73 Die Program Klasse implementiert die client Konsolenanwendung Sieaieliessv orte Main arimei private static bool RemoteCertificateValidation object X509Certificate X509Chain SslPolicyErrors private static void XmlSchemaValidation object ValidationEventArgs static void PrintResult XmlDocument Ein Einsprungspunkt zu der PanelApiRpcClient Anwendung Leitet eine Reihe an Argumenten Strings an die Eingabe Parameter weiter Die Argumente sind 0 der Host Name IP Adresse des vom Panel verwalteten Servers 1 der Login des Panel Administrators 2 das Passwort des Panel Administrators 3 das verwendete API RPC Protokoll 4 einem Pfad zu der XML Datei mit einem XML Abfrage Paket Die Funktion erstellt ein Abfrage Paket des Typs Request siehe oben validiert dieses versendet eine Anfrage an das Panel und liefert das resultierende XML Paket Die Funktion verifiziert das Remote SSL Zertifikat um den Server zu authentifizieren Sof
173. ress gt 10 53 129 101 lt ip_address gt lt gen_setup gt lt hosting gt lt vrt_hst gt lt property gt lt name gt ftp_password lt name gt lt value gt fp 1 6sdfdfrttg0 lt value gt lt property gt lt ip addr ss gt 10 53 129 101 lt ip address gt lt vrt_hst gt lt hosting gt lt add gt lt domain gt lt packet gt ANTWORTPAKET lt packet version 1 6 2 0 gt lt domain gt lt add gt lt result gt lt status gt error lt status gt lt errcode gt 2204 lt errcode gt lt errtext gt Unable to update hosting preferences E failed Unable to check system user existenc Incorrect fields login lt errtext gt lt result gt lt add gt lt domain gt lt packet gt system user update is login name is empty Einrichten ber Remote API 141 Erstellen von Subdomains F r die Erstellung eines Subdomain Accounts erstellen Sie ein XML Paket mit dem subdomain add Kontrollknoten lt packet version 1 6 2 0 gt lt subdomain gt lt add gt lt add gt lt subdomain gt lt packet gt In diesem Abschnitt Struktur des Abirage Pakels u en sen een 141 Beispiele f r Abfragen 200222 nein 143 Struktur des Antwortpakets un een see ea 144 ANIWOrl Beiepiele lek nenne anna 145 Struktur des Abfrage Pakets Ein XML Abfrage Paket ber das eine neue Subdomain hinzugef gt wird beinhaltet den subdomain add Kontrollknoten der wie f
174. richten ber Remote API 177 Struktur des Antwortpakets Der get download status Knoten des ausgegebenen XML Pakets ist wie folgt strukturiert get download status I 178 Einrichten ber Remote API result erforderlich Verpackt die vom Server abgerufene Antwort Datentyp resultType common xsd status erforderlich Gibt den Ausf hrungsstatus der Operation an Datentyp string Zul ssige Werte ok error errcode erforderlich falls die Operation fehlschl gt Gibt den Fehlercode wieder Datentyp integer errtext erforderlich falls die Abfrage einen nicht leeren Filter enthalt Gibt die Fehlermeldung wieder Datentyp string filter id erforderlich falls die Operation erfolgreich durchgef hrt werden kann Gibt die ID wieder nach der die Operation gefiltert wurde Datentyp any id erforderlich falls die Operation erfolgreich abgeschlossen wird Gibt die ID des Download Tasks an dessen Status abgefragt wurde Datentyp id_type common xsd task optional Beinhaltet eine Reihe von Daten die den Status des Download Tasks beschreiben Datentyp none Wie folgt strukturiert in progress Einrichten ber Remote API 179 id erforderlich Gibt die ID des Download Tasks an dessen Status abgefragt wurde Datentyp id_type common xsd finished optional Gibt an dass der Download Task beendet wurde Datentyp none in progress optional Gibt an dass der Download Task in Bearbeitung
175. riter writer new XmlTextWriter Console Out writer Formatting Formatting Indented document WriteTo writer writer Flush Console WriteLine 160 Einrichten ber Remote API Struktur des Antwortpakets Der upload Knoten des ausgegebenen XML Pakets ist wie folgt strukturiert UploadOutputResultType Result status okjemor ee an an an n anan 1277 a i E errtext ew wwwwnn ld result erforderlich Verpackt die vom Server abgerufene Antwort Datentyp resultType common xsd status erforderlich Gibt den Ausf hrungsstatus der Operation an Datentyp string Zul ssige Werte ok error errcode erforderlich falls die Operation fehlschl gt Gibt den Fehlercode wieder Datentyp integer errtext erforderlich falls die Operation fehlschl gt Gibt die Fehlermeldung wieder Datentyp string name erforderlich Gibt den Namen der hochgeladenen Datei an Datentyp string file erforderlich Gibt den vollst ndigen Namen der erstellten tempor ren Datei an Datentyp string Einrichten ber Remote API 161 Antwort Beispiele Hochladen eines einzigen Pakets Wenn ein Agent anfragt das 11 sh Paket auf den vom Panel verwalteten Server hochzuladen sieht eine positive Antwort von dem Server wie folgt aus lt packet version 1 6 2 0 gt lt upload gt lt result gt lt status gt ok lt status gt lt name gt li sh lt name gt lt file gt
176. rl if curl_errno curl errmsg curl_error curl errcode curl_errno curl curl_close curl throw new ApiRequestException errmsg Serrcode curl_close curl return result x Looks if API responded with correct data return SimpleXMLElement throws ApiRequestException vy function parseResponse response_ string m Sxml new SimpleXMLElement response string if is_a xml SimpleXMLElement throw new ApiRequestException Cannot parse server response feresponse string 3 return xml Vi Ar Check data in API response return void throws ApiRequestException function checkResponse SimpleXMLElement response SresultNode response gt domain gt get gt result check if request was successful if error string resultNode gt status W throw new ApiRequestException The Panel API returned an error string resultNode gt result gt errtext Einrichten ber Remote API 71 int main Te host 10 58 32 100 login admin password qwedsa curl curlinit host login password try Sresponse sendRequest curl domainsInfoRequest gt saveXML responseXml parseResponse response checkResponse response Xml catch ApiRequestException e echo e die Explore the result foreach
177. rmationen zu der Parallels Containers CLI oder der der Parallels Containers API XML oder SOAP finden Sie in der Parallels Containers Entwicklerdokumentation http www parallels com ptn documentation virtuozzo F r die Verteilung des Panels in einer Parallels Containers Umgebung sind die folgenden zwei Schritte notwendig 1 Installation des Panel Anwendungs Templates auf einem Hardware Node 2 Erstellen eines Containers und Verteilung der Anwendung ber das Template Der erste Schritt wird auf jedem Hardware Node nur einmal ausgef hrt Sobald ein Anwendungs Template auf einem Hardware Node installiert wurde kann man dieses auf beliebig viele Container verteilen Sie m ssen nicht jedes Mal wenn Sie einen Container mit dem Panel verteilen m ssen einen neuen Container erstellen Sie k nnen stattdessen einen existierenden Container klonen in dem das Panel bereits installiert wurde dieser Container fungiert somit als Template Container In diesem Abschnitt Parallels Containers f r Unix ununensnennnensnennnnnnnnnnnnnnnnnnnennnennnnnnennnennnennnenenenn 21 Parallels Containers f r Windows 0 ccccceeeceeeceeeceeeceeeceeecececeeeceeeceeeneeeneeenees 25 Verteilung des Panels 21 Parallels Containers f r Unix Es stehen zwei EZ Templates f r Parallels Small Business Panel 10 2 zur Verf gung ppsmbel0 Enth lt die Kernkomponenten des Panels ppsmbel0 extended Enth lt alle zus tzlichen Kom
178. rstellt wird Beispiele 1 Der folgende Befehl installiert das Anwendungspaket mit der ID 13 auf der Domain example com die Anwendung wird ber die URL example com blog erreichbar sein die Einstellung werden in der Datei WordPress xml definiert und bei der Installation wird die Datenbank WordPress erstellt Auf Linux Unix aps i home apps WordPress xml package id 13 domain example com ssl false url prefix blog db name WordPress db user BlogAdmin passwd P4 wOrd Auf Windows gt aps i E apps WordPress xml package id 13 domain example com ssl false url prefix blog db name WordPress db user BlogAdmin passwd P4 w0rd 2 Der folgende Befehl installiert dieselbe Anwendung nur mit den erforderlichen Optionen und die Anwendungseinstellungen werden von STDIN abgerufen Auf Linux Unix cat home apps WordPress xml aps install package id 13 domain example com db name WordPress db user BlogAdmin passwd P4 wOrd Auf Windows gt aps install package id 13 domain example com db name WordPress db user BlogAdmin passwd P4 wOrd lt C temp WordPress xml 3 Der folgende Befehl installiert eine Anwendung aus dem Paket mit der ID 14 auf der Subdomain api example com die Anwendung erfordert keine Datenbank Auf Linux Unix aps i home apps empty xml package id 14 domain api example com ssl true Auf Windows gt aps i E apps empty xml package id 14 domain api example c
179. rstellten Abfrage Pakets zu Ihrem Konverter hinzuzuf gen verwenden Sie bitte das Set an XML Schemadateien aus Ihrer Panel Installation PRODUCT ROOT D admin htdocs schemas rpc 1 6 2 0 auf Linux Unix wobei PRODUCT ROOT _D eine Variable darstellt die das Verzeichnis f r die Panel Installation definiert plesk dir admin htdocs schemas rpc 1 6 2 0 auf Windows wobei plesk_dir eine Variable darstellt die das Verzeichnis f r die Panel Installation definiert Verwenden Sie unbedingt agent_input xsd als Einsprungspunkt f r die Validierung Einrichten ber Remote API 59 Abfragenachrichten versenden Sobald das Panel API RPC Paket bereit ist sollte es in den HTTP Header eingebunden werden und an den genannten Server gesendet werden Um diese Tasks auszuf hren empfehlen wir die Verwendung einer HTTP FTP Client Bibliothek In diesem Abschnitt erfahren Sie wie dieser Vorgang in PHP unter Verwendung des CURL Engines durchgef hrt werden kann Es handelt sich um eine kostenlose und frei verf gbare clientseitige URL Transferbibliothek die in PHP 4 0 2 und h her unterst tzt wird Um den HTTP Header zu erstellen ben tigt der CURL Engine die folgenden Parameter Die URL des Zielservers in einem String in dem folgenden Format define HOST 10 58 97 81 define PORT 8443 define PATH enterprise control agent php Surl https HOST PORT PATH D
180. s APS Katalog Feed Eintrags entnommen werden der das zu herunterladene Paket beschreibt Weitere detaillierte Informationen finden Sie im Abschnitt Feeds Referenz zu den Elementen in der API Referenz des APS Katalogs http www apsstandard org r doc aps catalog 1 1 api index htm name erforderlich Gibt den Namen des Anwendungspakets an Datentyp string version optional Gibt die Version der Anwendung an Datentyp string Falls nicht n her definiert und falls mehrere Versionen der Anwendung in dem APS Katalog existieren wird das Paket mit der neuesten Version heruntergeladen release optional Gibt die Paket Release an Datentyp string Falls nicht n her definiert und falls mehrere Releases der Anwendung in dem APS Katalog existieren wird das Paket mit der neuesten Version heruntergeladen vendor optional Beinhaltet Informationen ber den Anbieter der Anwendung Datentyp string packager optional Beinhaltet Informationen ber den Packager Verpacker der Anwendung Datentyp string aps catalog url optional Beinhaltet die URL des APS Katalogs von dem das Paket heruntergeladen werden soll Datentyp string Falls ein Knoten vorhanden ist sollte URL in ihrem Wert exakt mit der aus der Konfigurationsdatei des APS Katalogs auf Seite 49 bereinstimmen andernfalls erhalten Sie eine Fehlermeldung mit dem Code 1013 Falls nicht in einem Paket enthalten dann wird das Paket von dem APS Katalog heruntergeladen das an
181. save wobei lt cT ID gt eine beliebige Container ID h her als 100 definiert die eindeutig auf dem Hardware Node ist pkgset name das Betriebssystem Template bezeichnet das f r die Erstellung des Containers verwendet werden soll der Switch save vzct1 mitteilt ob nderungen in der Konfigurationsdatei des Containers gespeichert werden sollen oder nicht Hinweis Weitere Informationen zur Erstellung von Containern und zu Konfigurationsoptionen finden Sie im Referenzhandbuch Parallels Containers f r Windows verf gbar im Parallels Technology Network http www parallels com ptn documentation virtuozzo 26 Verteilung des Panels Zum Beispiel k nnen Sie mithilfe der unten aufgef hrten Befehle folgende Vorg nge durchf hren erstellen Sie einen Container mit der ID 444 mit der IP 192 0 2 44 basierend auf dem Betriebssystem Template w2k3 legen Sie eine Speicherplatzbeschr nkung von 4 Gigabytes fest und setzen Sie das Limit f r den privaten Speicher auf 1 Gigabyte und das Administrator Passwort auf P4 w0rd aktivieren Sie die Verwaltung des Containers unter Verwendung eines Webbrowsers deaktivieren Sie die Offline Verwaltung mithilfe der Option offline management no Hinweis Es ist u erst wichtig dass Sie diese Option exakt wie im obigen Beispiel verwenden Andernfalls k nnen Sie nicht ber den Webbrowser auf das Panel zugreifen gt vzctl create 444 pkgset w2k3 ipadd 192 0
182. scatalog com 228 Einrichten ber CLI Status eines Download Tasks abfragen Um einen Download Status abzufragen verwenden Sie den Befehl im folgenden Format aps lt get download status g gt lt task id gt Beispiel Der folgende Befehl fragt den Status des Download Tasks mit der ID 16 ab Auf Linux Unix aps g 16 Auf Windows aps g 16 Installieren einer Anwendung Bei der Installation einer Anwendung ist es erforderlich dass Sie angeben welches Paket als Quelle f r die Installation verwendet werden soll Das Paket wird entweder Uber die zugewiesene ID ermittelt wenn das Paket in das Panel importiert wird oder Uber die Paketinformationen package name version release vendor packager Paketname Version Release Anbieter Verpacker W hlen Sie einen der folgenden Schritte um eine Paket ID anzugeben verwenden Sie die ID die dem Paket beim Import in das Panel zugewiesen wurde auf Seite 226 verwenden Sie die ID die dem Paket beim erfolgreichen Download vom APS Katalog zugewiesen auf Seite 228 verwenden Sie die ID die in den Informationen der verf gbaren Pakete angegeben wird auf Seite 233 Um die Paketinformationen package name version release vendor packager Paketname Version Release Anbieter Verpacker anzugeben fragen Sie die Informationen zu Paketen ab die zur Installation zur Verf gung stehen auf Seite 233 In diesem Abschnitt Installieren einer Anwendung auf einer Domain oder
183. schemas rpc Protocol agent_output xsd public XmlDocument Send XmlDocument packet HttpWebRequest request SendRequest packet OuterXml XmlDocument result GetResponse request return result public XmlDocument Send Stream packet using TextReader reader new StreamReader packet return Send ParseAndValidate reader InputValidationSchema public XmlDocument Send string packetUri using TextReader reader new StreamReader packetUri return Send ParseAndValidate reader InputValidationSchema Private interface Sending a request messag Hs private HttpWebRequest SendRequest string message HttpWebRequest request HttpWebRequest WebRequest Create AgentEntryPoint request Method POST request Headers Add HTTP AUTH LOGIN Login request Headers Add HTTP AUTH PASSWD Password request ContentType text xml request ContentLength message Length ASCIIEncoding encoding new ASCIIEncoding byte buffer encoding GetBytes message using Stream stream request GetRequestStream Einrichten ber Remote API 77 stream Write buffer 0 message Length return request Parsing and validating packet private XmlDocument ParseAndValidate TextReader xml string sc
184. se FTP Login und Passwort die einzigen Hostingeinstellungen die w hrend der Erstellung der Domain angegeben werden m ssen Quicklinks Domain Erstellung ber Remote API auf Seite 135 Domain Erstellung ber CLI auf Seite 222 Subdomains Wenn Sie eine Subdomain erstellen geben Sie mindestens den Pr fixnamen der Subdomain und die bergeordnete Domain an Der Inhalt einer Subdomain befindet sich normalerweise in dem Verzeichnis httpdocs subdomains subdomain name in dem virtuellen Host der Domain Das Panel f r Windows unterst tzt auch das so genannte Subdomains auf Unterordner Subdomains on Subfolder Subdomains gemappt auf ein beliebiges Verzeichnis das sich in dem Ordner httpdocs befindet Das ist besonders n tzlich wenn eine installierte Webanwendung als Subdomain zug nglich sein soll Beispiel Eine WordPress Anwendung ist normalerweise ber URLs wie z B http domain name URL prefix beispielsweise http example com WordPress erreichbar Mit einer Subdomain auf einem Unterordner ist es auch m glich die Anwendung ber http blog example com zur Verf gung zu stellen 44 berblick zu Setupvorg ngen Um eine regul re Subdomain zu erstellen geben Sie den Namen der bergeordneten Domain den Namen der Subdomain und die Hostingeinstellungen der Subdomain an Hinweis Standardm ig ist der Subdomain Inhalt unter demselben FTP Account wie den der bergeordneten Domain verf gbar Dementspreche
185. sem Abschnitt Struktur des Abfrage Pakets u 44444444440Rnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 129 Abiragebeispielun Bean re ee 130 Struktur des Antwortpakets uuuus4444444nnnnnnnnnnnnnnnnnnnnnnnnnnnannnnnnnnnnnnnnnnnnnnn 133 Antwort Beispiele eec eek eek ke 134 Einrichten ber Remote API 129 Struktur des Abfrage Pakets Der install Knoten des ausgegebenen XML Pakets ist wie folgt strukturiert install wse 4 name erforderlich Gibt den Namen an unter dem das Zertifikat in dem Panel angezeigt wird Datentyp string admin erforderlich Gibt das Zertifikat an das ins Server Repository importiert wird Datentyp none content erforderlich Beinhaltet alle Daten aus dem sich das Zertifikat zusammensetzt Datentyp none csr erforderlich Gibt das Zertifikat CSR an Certificate Signing Request Datentyp string pvt erforderlich Gibt den privaten Schl ssel des Zertifikats an Certificate Private Key Datentyp string cert optional Beinhaltet den Inhalt Body des Zertifikats Datentyp string ca optional Beinhaltet die Authentifizierungsinformationen des Zertifikats Certificate Authority Body Datentyp string ip_address erforderlich Gibt die zu dem Zertifikat zugeh rige IP Adresse an Datentyp ip_type common xsd 130 Einrichten ber Remote API Abfragebeispiel Dieses Paket installiert ein CA Zertifikat Certificate Authority das
186. sr local psa tmp catalogs ini Auf Windows aps ic C Program Files Parallels Plesk tmp catalogs ini oder aps ic C WINDOWS Temp catalogs ini Installieren von Anwendungen Fur die Installation von Anwendungen verwenden Sie das aps Dienstprogramm In diesem Abschnitt Importieren eines Anwendungspakets eeeesseceeceeeeeeeeeeeeeaeeeeeeeeeeeenenaaaees 225 Installieren einer Anwendung cccceceeee eee eeeeeeeeaceeeeeeeeeeeeneaaaaeeeeeeeeeeeeenaaaaes 228 Importieren eines Anwendungspakets In diesem Abschnitt Import von hochgeladenen Anwendungspaketen 4444444nnnnnn nennen 226 Anwendungspakete vom APS Katalog herunterladen 4444 gt 227 Status eines Download Tasks abfragen uuuuuus2242nnnnnnnnennnnnnnnnnnnnnnnnnnnnnnn nn 228 226 Einrichten ber CLI Import von hochgeladenen Anwendungspaketen Um ein hochgeladenes Anwendungspaket zu importieren verwenden Sie den Befehl im folgenden Format aps lt import package ip gt lt file name gt Beispiel Der folgende Befehl importiert das Paket SugarCRM 5 0 0 16 app zip in das Panel Auf Linux Unix aps import package home root SugarCRM 5 0 0 16 app zip Auf Windows aps import package C Documents and Settings Administrator Desktop SugarCRM 5 0 0 16 app zip Einrichten ber CLI 227 Anwendungspakete vom APS Katalog herunterladen Um ein heruntergeladenes Anwendungspaket z
187. stallieren m ssen Sie ein Zertifikat in das Panel importieren und einer IP Adresse zuweisen Wenn ein Domain Account auf einer solchen IP erstellt wird wird der Domain Hostingparameter SSL Unterst tzung automatisch aktiviert und das installierte Zertifikat wird verwendet um auf diese Domain zuzugreifen Quicklinks Installation von SSL Zertifikaten ber Remote API auf Seite 128 Installation von SSL Zertifikaten ber CLI auf Seite 220 berblick zu Setupvorg ngen 43 Erstellen von Domains und Subdomains Domains Der Erstellungs und Konfigurationsprozess von Domains und Subdomains wurde in Parallels Small Business Panel neu eingerichtet und so einfach wie m glich gestaltet Die Idee ist dass Sie bei der Erstellung einer Domain oder einer Subdomain die grundlegenden Hostingparameter angeben und der Rest der Hostingeinstellungen wird automatisch angepasst Um eine Domain zu erstellen geben Sie die folgenden Argumente an Domainname P Adresse Falls die IP Adresse mit einem SSL Zertifikat verkn pft ist auf Seite 42 dann wird die SSL Unterst tzung automatisch f r die Domain auf dieser IP aktiviert Erforderliche Webhosting Eigenschaften Login und Passwort des FTP Accounts der f r das Hochladen des Websiten Inhalts verwendet wird Wenn eine Webanwendung auf einer Domain installiert wird richtet das Panel automatisch alle f r diese Anwendung ben tigten Dienste ein Aus diesem Grund sind die IP Adres
188. t current_server ssh f root current_server parallels_installer source http updates example com target tmp ppsmbe select release id PPSMBE_10_2_0 install component base install component postgresql install component asp notify email admin example com Done 2 Dieses Beispiel Skript kann angewendet werden wenn der Binarcode des Parallels Installers direkt Uber eine Netzwerkadresse abgerufen wird die Beispiel URL http example com type parallels installer name here sollte durch einen g ltigen Download Link zum Installer ersetzt werden bin sh Verteilung des Panels 19 SERVERS_LIST node1 example com node2 example com for current_server in SERVERS_LIST do ssh f root current_server wget http example com type parallels installer name here o parallels_installer chmod 755 parallels_installer parallels_installer source http updates example com target tmp ppsmbe select release id PPSMBE_10_ 2 0 install component base install component postgresql install component spamassassin notify email admin example com Done 20 Verteilung des Panels Verteilung in einer Parallels Containers Umgebung Dieser Abschnitt besch ftigt sich mit den grundlegenden Schritten die durchgef hrt werden m ssen wenn das Panel mithilfe von Parallels Containers verteilt wird Der Schwerpunkt liegt dabei auf der Erstellung eines Containers mit Parallels Small Business Panel Weitere Info
189. t set gt lt dns gt lt packet gt ANTWORTPAKET lt packet version 1 6 2 0 gt lt system gt lt status gt error lt status gt lt errcode gt 1014 lt errcode gt lt errtext gt Parser error Request is invalid lt errtext gt lt system gt lt packet gt 106 Einrichten ber Remote API Einrichten von Templates f r Ressourceneintr ge ber API RPC k nnen Sie Ressourceneintr ge in dem DNS Zone Template auf folgende Weise ver ndern neue Ressourceneintr ge hinzuf gen existierende Ressourceneintr ge entfernen es ist m glich eine Liste mit den Ressourceneintr ge Akk RR Resource Records abzurufen die bereits in dem Template enthalten sind In diesem Abschnitt Hinzuf gen eines Templates f r Ressourceneintr ge 244444nnnnnnn nennen 106 Informationen ber das DNS Zonen Template abrufen uu 24 nenn 115 Entfernen eines Templates f r Ressourceneintr ge uuunssssssnnnnnnnnnnnnnnnennnn nn 121 Hinzuf gen eines Templates f r Ressourceneintr ge Um ein Template f r DNS Zonen Ressourceneintr ge hinzuf gen erstellen Sie ein XML Abfrage Paket dns add rec Kontrollknoten lt packet version 1 6 2 0 gt lt dns gt lt add_rec gt lt add_rec gt lt dns gt lt packet gt In diesem Abschnitt Struktur des Abfrage Pakets ccccceeeeeeeeseeeceeeeeeeeeeeenseeeaeeeeeeeeesesneeeaaeeeeees 107 Beispiele f r Abfragen mens ee HR
190. t wird Um Traffic und Zeit zu sparen sollten Sie einen benutzerdefinierten Mirror des Panel Repositorys verwenden gt So installieren Sie das Panel Template auf einem Hardware Node von Parallels Containers unter Verwendung des Dienstprogramms vzpkg 1 Beziehen Sie ein Panel Template Uber die Parallels Website http www parallels com and und laden Sie diese auf den Ziel Hardware Node von Parallels Containers hoch 2 Installieren Sie das Anwendungs Template indem Sie den Befehl im folgenden Format ausf hren vzpkg install template q lt d lt Nummer gt gt lt Pfad_ zum Paket gt wobei q die Protokollierung an das Display und die Protokolldatei deaktiviert d debug lt Nummer gt den Ausf hrlichkeitsgrad des Protokolls von 0 auf 10 setzt 22 Verteilung des Panels Beispiel Der folgende Befehl installiert sowohl die Kern als auch die Zusatz Komponenten des Panels vzpkg install template ppsmbel0 debian 5 0 x86 ez 4 0 0 1 pr1 284629 noarch rpm ppsmbel0 extended debian 5 0 x86 ez 4 0 0 1 pr1 284385 noarch rpm gt So verwenden Sie einen benutzerdefinierten Mirror 1 Erstellen Sie einen Mirror wie in dem Abschnitt Mirrors von Linux Unix Distributionen erstellen beschrieben auf Seite 28 2 Bearbeiten Sie auf dem Hardware Node die Datei die die URL des Repositorys deklariert a Offnen Sie zum Bearbeiten die Datei vz template lt Betriebssystem gt lt Version des Betriebs systems gt lt Plattform
191. t filename gt usr local psa tmp li 8FZruf lt filename gt lt import config gt lt aps gt lt packet gt Auf Windows lt packet version 1 6 2 0 gt lt aps gt lt import config gt lt filename gt C Program Files Parallels Plesk tmp li_9D tmp lt filename gt lt import config gt lt aps gt lt packet gt 148 Einrichten ber Remote API Struktur des Antwortpakets Der import config Knoten des ausgegebenen XML Pakets ist wie folgt strukturiert APSImportConfigOutputType r resultType Result status ok error import conia EA Error code if error occurred ee mn Error message if error occurred result erforderlich Verpackt die vom Server abgerufene Antwort Datentyp resultType common xsd status erforderlich Gibt den Ausf hrungsstatus der Operation an Datentyp string Zul ssige Werte ok error errcode erforderlich falls die Operation fehlschl gt Gibt den Fehlercode wieder Datentyp integer errtext erforderlich falls die Operation fehlschl gt Gibt die Fehlermeldung wieder Datentyp string Einrichten ber Remote API 149 Antwort Beispiele Eine positive Antwort vom Server sieht wie folgt aus lt packet version 1 6 2 0 gt lt aps gt lt install gt lt result gt lt status gt ok lt status gt lt result gt lt install gt lt aps gt lt packet gt Folgende negati
192. t packet version 1 6 2 0 gt lt aps gt lt import config gt lt import config gt lt aps gt lt packet gt Die Konfigurationsdatei auf Seite 49 sollte zuvor auf den Server mithilfe des upload Operators auf Seite 151 hochgeladen werden In diesem Abschnitt Struktur des Abfrage Pakets 4444444444H0nnnnnnnnnnnnnnnnnnnnnannnnnnnnnnnnnnnnnnnnn 146 Beispiele f r Abfragen uum444444444nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nn 147 Struktur des Antwortpakets uussssnnssssnnnnnnnnnnnnnnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 148 Antwort Beispiele eis vance sha ia ate cadet de death Sac see diet eeti ae 149 Struktur des Abfrage Pakets Der import config Knoten des XML Abfrage Pakets ist wie folgt strukturiert APSImportConfiginputType import config I E LDS Ea filename erforderlich Gibt den Namen der Konfigurationsdatei an die auf den Server hochgeladen wird Datentyp string Der Wert sollte dem Namen der tempor ren Datei entsprechen die in der upload Antwort siehe Seite 160 indem upload result file Element wiedergegeben wird Einrichten ber Remote API 147 Beispiele f r Abfragen Abfrage Pakete die Konfigurationsdateien von APS Katalogen importieren die zuvor auf den Server hochgeladen wurden sehen wie folgt aus Auf Linux Unix lt packet version 1 6 2 0 gt lt aps gt lt import config gt l
193. ta gt lt result gt lt result gt lt status gt ok lt status gt lt id gt 6 lt id gt lt data gt lt type gt A lt type gt lt host gt mail amp lt domain amp gt lt host gt lt value gt amp lt ip amp gt lt value gt lt opt gt lt data gt lt result gt lt result gt lt status gt ok lt status gt lt id gt 7 lt id gt lt data gt lt type gt CNAME lt type gt lt host gt ftp amp lt idomain amp qt lt host gt lt value gt amp lt domain amp gt lt value gt lt opt gt lt data gt lt result gt lt result gt lt status gt ok lt status gt lt id gt 8 lt id gt Einrichten ber Remote API 121 lt data gt lt type gt PTR lt type gt lt host gt amp lt ip amp gt 24 lt host gt lt value gt amp lt domain amp gt lt value gt lt opt gt 24 lt opt gt lt data gt lt result gt lt get_rec gt lt dns gt lt packet gt Entfernen eines Templates fur Ressourceneintrage Um einen Ressourceneintrag Resource Record von dem DNS Zonen Template zu entfernen erstellen Sie ein XML Paket das den dns del_rec Kontrollknoten enthalt lt packet version 1 6 2 0 gt lt dns gt lt del_rec gt lt del_rec gt lt dns gt lt packet gt In diesem Abschnitt Struktur des Abfrage Pakets 2444444444nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nn 122 Beispiele t r Abfragen en 123 Struktur des AntWortpakeis uncut 124 Antwort Beispiele
194. tatusbericht per E Mail zusendet Ein Bericht ber die erfolgreiche Fertigstellung beinhaltet ein detailliertes Protokoll und eine Liste mit den installierten aktualisierten Paketen enable xml output Diese Option wurde f r die Kommunikation mit dem Panel konzipiert und kann f r die Interaktion mit anderen Anwendungen verwendet werden Wenn Sie diese Option angeben wird die gesamte Ausgabe des Installers in XML eingebunden Bitte beachten Sie dass dieser Code es nicht zul sst dass der Installer Fehler ber den Exitcode mitteilt Der Exitcode ist immer Null und alle Fehler werden innerhalb der XML Ausgabe mitgeteilt query status Da die RPM Datenbank nicht mehrere Zugriffe zul sst sperrt der Installer diese Funktionalit t F hren Sie diese Option aus um herauszufinden ob der Installer aktiv ist Diese Option berpr ft ob eine Sperre vorhanden ist und erstellt entweder einen Exitcode 0 der Installer ist inaktiv 1 der Installer wird ausgef hrt oder eine XML formatierte Ausgabe truncate log L scht die Protokolldatei beim Start des Installationsprogramms f r Parallels Produkte separate log Verwendet eine neue Protokolldatei wenn das Installationsprogramm f r Parallels Produkte neu gestartet wird debug Aktiviert eine detaillierte Ausgabe in der Protokolldatei version Zeigt die Version des Installationsprogramms f r Parallels Produkte an 18 Verteilun
195. tes lt P7 f r den Ressourceneintrag NS Record Parameter und Beispiel lt subdomain_n Gibt den Namen des Hosts So f gen Sie einen neuen an f r den die NS Ressourceneintrag hinzu der Eintragseinstellungen ns lt domain gt als Nameserver bernommen werden 216 Einrichten ber CLI nameserv lt domain_ name Gibt den Namen eines f r den Host lt domain gt definiert gt lt subdoma Nameservers oder eines server dns a ns in_name gt lt d Platzhalters zur Erstellung nameserver ns lt domain gt omain gt eines NS Ressourceneintrags Temp late MX Record Parameter und Beispiel lt subdomain na Gibt den Namen des Hosts So f gen Sie einen neuen me gt an f r den die MX Ressourceneintrag hinzu der Eintragseinstellungen mail lt domain gt als Mailserver bernommen werden f r lt domain gt mit der Priorit t 15 mailexch lt domain_name gt Gibt den Namen eines festlegt lt subdomain Mail Exchangers oder eines server_dns a mx _name gt lt doma Platzhalters an mailexchanger ins mail lt domain gt priority 15 priority lt number gt Gibt die Priorit t des Mail Exchangers an wW CNAME Record Parameter und Beispiel lt subdomain_na Gibt den Namen des Host So f gen Sie einen neuen me gt an f r den die CNAME Ressourceneintrag hinzu Eintragseinstellungen der ns lt domain gt als Alias f r bernommen werden www
196. tname args 0 x 110 292 request Login args 1 y AICINA p Einrichten ber Remote API 87 request Password args 2 se CUPE request Protocol args 3 N 1 9207 Dim packetUri As String args 4 Srequest xml Try Program PrintResult request Send packetUr1 Catch exception As Exception Console WriteLine Request error 0 exception Message End Try End If End Sub The following method is invoked by the RemoteCertificateValidationDelegate Private Shared Function RemoteCertificateVa sender As lidation ByVal Object ByVal certificate As X509Certificate ByVal sslPolicyErrors As SslPolicyErrors As Errors lt gt If sslPolicy SslPolicy Return True End Console WriteLine Certificate error 0 Do not allow this client to communicate with Return False End Function Errors RemoteCertificateNotAvailable ByVal chain As X509Chain Boolean Then Errors sslPolicy unauthenticated servers ByVal sender As Object Private Shared Sub XmlSchemaValidation ByVal e As ValidationEventArgs Console WriteLine Validation error 0 End Sub Private Shared Sub PrintResult I Dim w As New XmiTextWriter Console Out w Formatting Formatting Indented document WriteTo w w Flush Console WriteLine End Sub End
197. tus gt lt result gt lt lic_install gt lt server gt lt packet gt Sie erhalten diesen Fehler falls versucht wird ber das Abfrage Paket einen ung ltigen Lizenzschl ssel zu installieren lt packet version 1 6 2 0 gt lt server gt lt lic_install gt lt result gt lt status gt error lt status gt lt errcode gt 1020 lt errcode gt lt errtext gt The uploaded key file is not valid or does not contain a license key lt errtext gt lt result gt lt lic_install gt lt server gt lt packet gt 100 Einrichten ber Remote API DNS Konfiguration Um den DNS Dienst des Panels ber das API RPC Protokoll zu installieren verwenden Sie bitte den dns Operator Gehen Sie hierzu wie im Folgenden beschrieben vor In diesem Abschnitt BNS Dienst deakiivieren nun einladen 100 Andern des SOA Record Templates 44444snnnnsnnnnnnnnnnnnnnnnnnnennnnnnnnnnn 102 Einrichten von Templates f r Ressourceneintr ge uuuuenssssssnnnnnnnennnnnnnnnnnnnnn 106 DNS Dienst deaktivieren Um den DNS Dienst des Panels per API RPC zu deaktivieren erstellen Sie ein XML Abfrage Paket das den dns disable Kontrollknoten enth lt lt packet version 1 6 2 0 gt lt dns gt lt disable gt lt dns gt lt packet gt In diesem Abschnitt Ablrage Pakel euere 100 ANIWOrBaket 2 arena rer 101 Abfrage Paket Das folgende Abfrage Paket deaktiviert den DNS Dienst lt packet versio
198. typ string Zul ssige Werte ok error errcode erforderlich falls die Operation fehlschl gt Gibt den Fehlercode wieder Datentyp integer errtext erforderlich falls die Operation fehlschl gt Gibt die Fehlermeldung wieder Datentyp string id erforderlich falls die Operation erfolgreich abgeschlossen wird Liefert den eindeutigen Identifier des gerade hinzugef gten DNS Eintrags Datentyp integer 114 Einrichten ber Remote API Antwort Beispiele Eine positive Antwort sieht wie folgt aus lt packet version 1 6 2 0 gt lt dns gt lt add_rec gt lt result gt lt status gt ok lt status gt lt id gt 17 lt id gt lt result gt lt add_rec gt lt dns gt lt packet gt Folgende negative Antwort wird erhalten falls ein Abfrage Paket unzul ssige Werte f r den Ressourceneintrag Resource Record enth lt der hinzugef gt werden soll in unserem Beispiel handelt es sich um einen falsch analysierten und angegebenen Host f r den SRV Eintrag ABFRAGE PAKET lt packet version 1 6 2 0 gt lt dns gt lt add_rec gt lt type gt SRV lt type gt lt host gt LDAP tcp ldap domain test 480908606 tst lt host gt lt value gt 192 0 2 4 lt value gt lt opt gt 5 25 220 lt opt gt lt add_rec gt lt dns gt lt packet gt ANTWORTPAKET lt packet version 1 6 2 0 gt lt dns gt lt add_rec gt lt result gt lt stat us gt error lt status gt
199. u importieren verwenden Sie den Befehl im folgenden Format aps lt download d gt package name lt name gt catalog url lt URL gt package version lt version number gt package release lt release number gt package vendor lt vendor name gt package packager lt packager name gt wobei der Teil keera loon Ur ME URT daf r verantwortlich ist den Ziel APS Katalog zu definieren die URL muss exakt mit der aus der Konfigurationsdatei bereinstimmen Falls nicht angegeben wird das Paket von dem APS Katalog heruntergeladen welches an erster Stelle in der Konfigurationsdatei auf Seite 49 aufgelistet wird der Teil package version lt version number gt package release lt release number gt package vendor lt vendor name gt package packager lt packager name gt daf r verantwortlich ist das genaue Anwendungspaket anzugeben die in der package name Option definiert wurde Falls dieser Teil nicht in dem Befehl angegeben wird und in dem Ziel APS Katalog mehrere Pakete mit demselben Namen existieren dann wird das Paket mit der h chsten Version und Release heruntergeladen Beispiel Mit dem folgenden Befehl wird das Paket mit der h chsten Version und Release der WordPress Anwendung von dem APS Katalog auf http apscatalog com heruntergeladen Auf Linux Unix aps d package name WordPress catalog url http apscatalog com Auf Windows aps d package name WordPress catalog url http ap
200. unter http www parallels com en support usersdoc zusenden Bitte nehmen Sie in Ihren Bericht den Titel der Anleitung des Kapitels und des Abschnitts sowie den Textabsatz auf in dem Sie einen Fehler gefunden haben KAPITEL 1 ber dieses Handbuch Zweck In diesem Handbuch finden Sie wichtige Informationen zur Bereitstellung von Parallels Small Business Panel nachfolgend bezeichnet als das Panel das HSPs Hosting Service Provider erm glichen soll komplette Hosting L sungen f r ihre Kunden bereitzustellen Dieses Dokument ist f r HSP Entwickler gedacht die an der Umsetzung der Panel Bereitstellung arbeiten z B die Automatisierung der Installation der Verteilung die Konfiguration und die Anpassung an spezifische Kundenanforderungen Dieses Dokument enth lt empfohlene Vorgehensweisen die unserer Ansicht nach die besten Vorgehensweisen f r die Installation und die Konfiguration des Panels im Rahmen der Produktbereitstellung sind Diese Vorgehensweisen wurden von uns ausf hrlich getestet und haben sich in unseren Tests als Best Practices bew hrt Dieses Dokument enth lt keinesfalls eine vollst ndige API Funktionsbeschreibung Funktionen und Optionen die nicht wesentlich f r die Bereitstellung sind werden nicht beschrieben Anwendungsbereich Heutzutage empfehlen Service Provider weniger Unmanaged Infrastructure Hosting nicht betreutes Hosting von IT Infrastrukturen und tendieren mehr zu Angeboten mit mehrwertig
201. ur ck 58 Einrichten ber Remote API Die Abbildung oben zeigt die HTTP Operationen als Teil der HTTP Bibliothek Diese Operationen k nnen von Grund auf durchgef hrt werden aber es ist einfacher eine einsatzbereite und getestete HTTP Bibliothek zu verwenden Die Einteilung in HTTP Sender und HTTP Empf nger ist konditional Diese wurde gemacht um die HTTP Operationen senden und empfangen grafisch voneinander zu unterscheiden In diesem Abschnitt Erstellen eines Abfrage Pakets 2444uuuun444nnnnnnnnnnnnnnnnannnnnnnnnnnnnnnnnnnnn nenn 58 Abfragenachrichten versenden 4444444444BHnnnnnnnnnnnnnnnnnnnnnnnnnn nennen 59 Analysieren der Antwort 2 ee exes desie 61 Fehlerhantling i ke kei 63 Client Code Beispiele uunnnsnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnannnnnnnnnnnnnnnnnnnnn 65 Erstellen eines Abfrage Pakets Beim Erstellen eines AP RPC Abfrage Pakets erh lt die Client Anwendung von der grafischen Benutzeroberfl che oder von einem Softwaremodul den Befehl einen bestimmten Vorgang oder mehrere auf einem oder mehrere Panel Objekten auszuf hren Die Anwendung muss den angefragten Befehl in das Format eines XML Pakets konvertieren das mit der Panel XML API kompatibel ist Um den Command to XML Paket Konverter zu implementieren beachten Sie bitte die Struktur von API RPC Paketen und wie diese vom Panel Server verarbeitet werden auf Seite 53 Um die Validierung des e
202. usr local psa tmp li_8FZruf lt file gt lt result gt lt upload gt lt packet gt Falls die hochgeladene Datei die zul ssige Dateigr e upload_max_filesize aus php ini berschreitet sieht die Antwort vom Server wie folgt aus lt packet version 1 6 2 0 gt lt upload gt lt result gt lt status gt error lt status gt lt errcode gt 1023 lt errcode gt lt errtext gt The uploaded fil xceeds the upload max filesize directiv set in php ini lt errtext gt lt name gt li sh lt name gt lt file gt usr local psa tmp li 8FZruf lt file gt lt result gt lt upload gt lt packet gt 162 Einrichten ber Remote API Hochladen von mehreren Paketen Wenn ein Agent die Anfrage stellt die Dateien 1i sh und mybox sh auf den Panel Server hochzuladen dann sieht eine positive Antwort von dem Server wie folgt aus lt packet version 1 6 2 0 gt lt upload gt lt result gt lt status gt ok lt status gt lt name gt li sh lt name gt lt file gt usr local psa tmp li_8FZruf lt file gt lt result gt lt result gt lt status gt ok lt status gt lt name gt mybox sh lt name gt lt file gt usr local psa tmp li_8FZrHts lt file gt lt result gt lt upload gt lt packet gt Einrichten ber Remote API 163 Import von hochgeladenen Anwendungspaketen Um ein hochgeladenes Anwendungspaket auf Seite 151 in das Panel zu importieren erstellen Sie ein XML
203. ve Antwort wird empfangen falls keine Abfrage Datei gefunden werden konnte lt packet version 1 6 2 0 gt lt aps gt lt import config gt lt result gt lt status gt error lt status gt lt errcode gt 1013 lt errcode gt lt errtext gt File usr local psa tmp li_8FZruf does not exist lt errtext gt lt result gt lt import config gt lt aps gt lt packet gt Folgende negative Antwort wird empfangen falls eine Abfrage Datei ber unzul ssige Zugangsberechtigungen verf gt h chstwahrscheinlich wenn f r das Hochladen eine andere Methode als der upload Agent verwendet wird lt packet version 1 6 2 0 gt lt aps gt lt import config gt lt result gt lt status gt error lt status gt 150 Einrichten ber Remote API lt errcode gt 1023 lt errcode gt lt errtext gt Unable to use specified file as config file lt errtext gt lt result gt lt import config gt lt aps gt lt packet gt Installieren von Anwendungen Um Anwendungen auf Domains und Subdomains zu installieren verwenden Sie den aps Operator wie im Folgenden beschrieben In diesem Abschnitt Import von Anwendungspaketen uuussssssssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 150 Installieren einer Anwendung uss4444444444nnnnnnnnnnnnnnnnnnnnnnnnnnnnn nenn 185 Import von Anwendungspaketen In diesem Abschnitt Dateien auf den Server hochladen 44444
204. wZWkvWTFmcStSc0OdSSnNhZ2dRNW56MzgralV5IFRVUDBRK2VrUnAxcUFVa09OWUYy M21FT1FuQ2V5eFNqQ3FrejNyZEhkaVFFQTBKcmhYMGowYWZYWDuJkL2JRUnZVeU93U FBsVWhzNU4gY3FjcndRRDdMQOIsOE9Udk5FaFRrNFo0OGdaM1 ZIRzJ2bitp VGc9PTwvZH NpZzpTaWduYXR1cmVWYWx1 ZT 4gDQotIDxkc2InOktleUluZm8 DQotIDxkc2InOlg1 MDIEY XRhPgOKICA8ZHNpZzpYNTA5Q2VydGlmaWNhdGU TUIJRW5EQONBb1 FDQVJFdORRW UpLb1pJaHZj TKFRRUZCUUF3Z2FZeEN6QUpCZ05W QkFZVEFrSkSNUXN3Q1FZRFZRUUI Fd0pJVFRFUIBNQThHQTFVRUJ4TUITROZOYVd4MGlyNHhIREFhQmdOVkJBb1RFMUS5YY zI5b gt WRDQKIiMnhrY Vc1 bmN5Qk1kR1 F4SFRBYkJnTIZCQXNUIEZFOHVkKR1Z5Ym1GcOIFU mxkbVZzYj NCdFpXNT BNUnd3R2dZRFZRUURFeE5MUVNCeWlyOTBJRO5sY25ScFptbGp ZWFJsTVJ3d0dnWUogS29aSWh2Y05BUWtCRmexcllVQnpkM052Wm5RdVkyOXRNQjRYR FRBNU1EWXdNakEyTURrek0xb1 hEVEOyTVRBeESEQTJNRGIt6TT FvdyBnW UF4Q3pBSkJ nTIZCQVIUQWItKTk1 Rc38dDUVIEVIFRSUV3SkIUVEVS TUE4ROExVUVCeE1JU0dGdGFXeD BiMjJR4SERBYUJnTIZCQW9UIEUxTIhjMjltZENCSWlyeGthVzVuY3ICTWRHUXhIVEFIQmdO VkJBco1 RGRWx1ZEdWeWJtRnNJRVJsZG1Wce2lzQnRaVzUwT VJRd0VnWUQgVIFRREV3d HdjQzF6YldJdGRXNXBIRENDQVNJdORRW UpLb1 pJaHZjTKFRRUJCUUFEZ2dFUEFEQON BUW9DZ2dFQkFNYZRORWVhRFMzciBDS0sxQ1 RaUm9aMTdGVzZU5Z0tBbTIOQmt6V3Zw ZW9VMOINZU5SMTMrdWsOMySIYW1 EQKNHZTBtQnNwb05vWjErWDk3RXVGYzB4b2RvIG gONVgrRUNIZK5kKME1 adzVrSFIjWWFA M2kxSVBBakZMdm5DcE52ZXc1WHpxXQzcwZ0xlen ZNaWxRbWxT YWpLSEFELOEvMGhzyYkl0aDkgeVdxNTZPcDRiT 1hUTDVKNONZV1JHeVRS aFV1MnFPbjZ2Y203Q2Rkb050eWhRdDIJTYIArNDIVMXFJdjMvOFZ3YnZrMzZhT VITVIBIMS BHRk50MIE3RkhKUUxicW1pY 1doLOJBWkpjU2FGMWIPSUhuZ2VlbG9uS GptbzdJWUEvSX cy TU
205. wort des Panel Administrators StandardmaBig handelt es sich dabei um setup Beinhaltet die Version des API RPC Protokolls das fur die Kommunikation mit dem Panel verwendet wird Der verwendete Handler fur den Empfang von Schema Validierungsfehlern Beinhaltet die URL des Panel Agents der das Abfrage Paket auf der Server Seite verarbeiten wird Beinhaltet die URL des Validierungsschemas die in dem Abfrage Paket Ubernommen wird bevor es an die Server Seite versendet wird Beinhaltet die URL des Validierungsschemas die in dem Antwortpaket Ubernommen wird bevor es auf der Client Seite empfangen wird Leitet das Abfrage Paket in Form des XmlIDocument Objekts an die Eingabe Parameter weiter Versendet eine Anfrage und erh lt die Antwort in Form des XmIDocument Objekts Leitet das Abfrage Paket Stream an die Eingabe Parameter weiter Validiert das Abfrage Paket mithilfe des Validierungsschemas agent input xsd Ruft die Elementfunktion Send XmlDocument auf Leitet die URI des Abfrage Pakets XML Datei an die Eingabe Parameter weiter Validiert das Abfrage Paket mithilfe des Validierungsschemas agent input xsd Ruft die Elementfunktion Send XmlDocument auf Erstellt eine HTTP Abfrage bertr gt den HTTP Header und das serialisierte XML Paket auf das Objekt des Typs HttpWebRequest Schickt dieses Objekt zur ck Leitet die URI des agent input xsd Schemas und einen String Reader mit der URI des zu validie
206. ws sollten Sie zwischen der Produktverteilung und dem Setup f nf Minuten Zeit einplanen Diese Verz gerung vor dem Setup ist notwendig da es einige Zeit dauern kann bis Post Installationsskripte und Drittanbieterkomponenten eingerichtet wurden Bereitstellungsvorg nge die in diesem Zeitraum durchgef hrt werden k nnten ansonsten fehlschlagen KAPITEL 3 Verteilung des Panels In diesem Kapitel wird die Verteilungsphase in dem Bereitstellungsworkflow des Parallels Small Business Panel beschrieben Dieses Kapitel deckt sowohl die Installation in Parallels Containers Umgebungen als auch Einzelplatz Installationen ab Dar ber hinaus wird in einem zus tzlichen Abschnitt erkl rt wie Mirrors vom Update Repositorys des Panels erstellt werden In diesem Kapitel Binzelplatz VertenunG i sicrisetecdt nnn ra a aa R a 10 Verteilung in einer Parallels Containers Umgebung cceceeeeeeeeeeeteeeeeeeees 20 Einrichten eines Mirrors mit dem Dienstprogramm RSynC ssssssssssseenneesserrrrrrre 27 10 Verteilung des Panels Einzelplatz Verteilung In diesem Kapitel werden die Automatisierungsm glichkeiten bei der Verteilung des Panels in einer Umgebung ohne Parallels Containers aufgef hrt sei es Linux Unix oder Windows basiert Dieser Abschnitt des Handbuchs erkl rt die Grundlagen der Panel Installation und beinhaltet Anleitungen ber und die Installation des Produkts ber die Befehlszeilenschnittstelle CLI Details zu den
207. ync au delete rsync rsync autoinstall plesk com autoinstall SETEMPLATES 1 0 0 destination directory Mit diesen Befehlen k nnen Sie die Inhalte herunterladen die f r die Installation der Ubuntu und Debian Pakete von Parallels Small Business Panel mithilfe des Parallels Installers ben tigt werden rsync au delete rsync rsync autoinstall plesk com autoinstall debian PPSMBE 10 2 0 destination directory debian rsync au delete rsync rsync autoinstall plesk com autoinstall ubuntu PPSMBE 10 2 0 destination_directory ubuntu Mit diesen Befehlen k nnen Sie die Inhalte herunterladen die f r die Installation der Ubuntu und Debian Pakete f r weitere Site Editor Templates mithilfe des Parallels Installers ben tigt werden rsync au delete rsync rsync autoinstall plesk com autoinstall debian SETEMPLATES _1 0 0 destination directory debian rsync au delete rsync rsync autoinstall plesk com autoinstall ubuntu SETEMPLATES _1 0 0 destination_directory ubuntu 30 Verteilung des Panels Mit diesen Befehlen k nnen Sie die Inhalte herunterladen die f r die Installation der Ubuntu und Debian Pakete des Panels mithilfe der Parallels Containers EZ Templates ben tigt werden Falls Sie einen Mirror f r eine Umgebung ohne Parallels Containers einrichten lassen Sie diesen Schritt aus rsync au delete rsync rsync autoinstall plesk com autoinstall debian PPSMBE 10 2 0 destination_directory debi

Einrichten des Panels

Contents

Download Pdf Manuals

Related Search

Related Contents