Performing Initial Server Setup

Initial server setup is performed right after installing Plesk on a server. This operation includes:

To initially set up Plesk server, use the initial_setup operation.

Note: Using the initial_setup operation later on to change administrator's password or personal info is prohibited. For this purposes, use the set operation instead.

In this chapter:

Request Packet Structure

Response Packet Structure

Samples

 

Request Packet Structure

A request XML packet starting server initial setup contains the initial_setup operation node:

<packet>
  <server>
    <initial_setup>
      ...
    </initial_setup>
  </server>
</packet>

 

The initial_setup node is presented by complex type initialSetupType (plesk_server.xsd) and structured as follows:

Important: When creating request packets, put nodes and elements in the order they follow in the packet structure.

 

Response Packet Structure

The initial_setup node of the response packet is structured as follows:

 

Samples

A request packet performing initial setup of Plesk server can look as follows:

<packet version="1.4.2.0">
<server>
<initial_setup>
   <admin>
      <admin_cname>JohnDoe BV.</admin_cname>
      <admin_pname>John Doe</admin_pname>
      <admin_phone>+49 89333333</admin_phone>
      <admin_fax>+49 893333303</admin_fax>
      <admin_email>john@doe.de</admin_email>
      <admin_address>Theatinerstrasse 96</admin_address>
      <admin_city>Muenchen</admin_city>
      <admin_state>Bavaria</admin_state>
      <admin_pcode>80333</admin_pcode>
      <admin_country>DE</admin_country>
      <send_announce>true</send_announce>
   </admin>
   <password>setup</password>
   <server_name>com3.doe.de</server_name>
</initial_setup>
</server>
</packet>

Response:

<packet version="1.4.2.0">
<server>
<initial_setup>
   <result>
      <status>ok</status>
      <server_name>com3.doe.de</server_name>
   </result>
</initial_setup>
</server>
</packet>

A negative response received from server may look as follows:

<packet version="1.4.2.0">
<server>
<initial_setup>
   <result>
      <status>error</status>
      <errcode>1003</errcode>
      <errtext>Initial setup already completed</errtext>
      <server_name>com3.doe.de</server_name>
   </result>
</initial_setup>
</server>
</packet>

Such error is received if the request packet sent to the server tried to perform initial setup on a server where it has already been done.