Server Configuration: init_conf Utility

The init_conf utility is used to perform the initial configuration of Parallels Plesk Panel through CLI. By using this utility, you can also edit certain parameters configured during the initial configuration of the Parallels Plesk Panel server. By using this utility, you can perform the following tasks:

Usage

init_conf <command> [
<option_1> [<param>]
[<option_2> [<param>]]
... [<option_N> [<param>]]
]

Example

The following command sets the default IP address to 192.0.2.14 and sets its type to shared; sets the network mask to 255.255.255.0 and the network interface name to eth0 for the default IP address; adds shared IP addresses 192.0.2.46 and 192.0.2.47 to Parallels Plesk Panel; sets the Parallels Plesk Panel administrator's name to John Doe and the administrator's password to adminpass; sets the administrator's phone number to 555-5555, fax number to 333-3333, and email address to admin@example.com; sets the administrator's company name to Megacompany Inc., street address to 45 Trail street, city to New York, ZIP code to 10292, and country to United States.

# ./init_conf --init -default-ip 192.0.2.14 -netmask 255.255.255.0 -iface eth0 -ip-type shared -hostname example.com -shared_ips add:192.0.2.46,192.0.2.47 -name "John Doe" -passwd mypass -phone 555-5555 -fax 333-3333 -email admin@example.com -company "Megacompany Inc." -address "45 Trail street" -city "New York" -zip 10292 -country US -state NY

Commands

Command

Parameter

Description

Example

--init

 

Initializes a non-configured Parallels Plesk Panel server.

Requires following options: -name, -passwd, -phone, -company, -email, -address, -city, -country, -state, -pcode.

 

Note: The -state option is required only if the -country option value is US.

To set the Parallels Plesk Panel default IP address to 192.0.2.14, make the address shared, set the network mask to 255.255.0.0, network interface name to eth0, and specify the Parallels Plesk Panel administrator's personal information:

# ./init_conf --init -default-ip 192.0.2.14 -netmask 255.255.0.0 -iface eth0 -ip-type shared -name "John Doe" -passwd mypass -phone 555-4444 -fax 555-4433 -email admin@example.com -address "45 Trail street" -city "New York" -country US -state NY -zip 10292

--update or -u

 

Updates the Parallels Plesk Panel administrator's personal information.

To set the Parallels Plesk Panel administrator's email address to admin@example.com:

# ./init_conf --update -email admin@example.com

or

# ./init_conf -u -email admin@example.com

--check-configured or -c

 

Checks whether Parallels Plesk Panel is configured. Returns 0 on success, 1 otherwise.

To check if Parallels Plesk Panel is configured:

# ./init_conf --check-configured

or

# ./init_conf -c

--help or -h

 

Displays help on the use of the utility.

To view help on the use of the init_conf utility:

# ./init_conf --help

or

# ./init_conf -h

Options

Option

Parameter

Description

Example

-company

<string>

Specifies the Parallels Plesk Panel administrator's company name.

Required with the --init.

To set the Parallels Plesk Panel administrator's company name to Megacompany:

# ./init_conf -u -company Megacompany

-name

<string>

Specifies the Parallels Plesk Panel administrator's contact name.

Required with the --init.

To set the Parallels Plesk Panel administrator's contact name to John Doe:

# ./init_conf -u -name "John Doe"

-passwd

<password>

Specifies the Parallels Plesk Panel administrator's password for access to Parallels Plesk Panel.

Required with the --init.

To set the Parallels Plesk Panel administrator's password to sample:

# ./init_conf -u -passwd sample

-phone

<number>

Specifies the Parallels Plesk Panel administrator's phone number.

Required with the --init.

To set the Parallels Plesk Panel administrator's phone number to 323-4455:

# ./init_conf -u -phone 323-4455

-fax

<number>

Specifies the Parallels Plesk Panel administrator's fax number.

To set the Parallels Plesk Panel administrator's fax number to 323-4433:

# ./init_conf -u -fax 323-4433

-email

<string>

Specifies the Parallels Plesk Panel administrator's email address.

Required with the --init.

To set the Parallels Plesk Panel administrator's email address to admin@example.com:

# ./init_conf -u -email admin@example.com

-addr

<string>

Specifies the Parallels Plesk Panel administrator's street address.

Deprecated. Use -address option instead.

To set the Parallels Plesk Panel administrator's street address to 45 Trail street:

# ./init_conf -u -addr "45 Trial Street"

-address

<string>

Specifies the Parallels Plesk Panel administrator's street address.

Required with the --init.

To set the Parallels Plesk Panel administrator's street address to 45 Trail street:

# ./init_conf -u -address "45 Trial Street"

-city

<string>

Specifies the Parallels Plesk Panel administrator's city.

Required with the --init.

To set the Parallels Plesk Panel administrator's city to New York:

# ./init_conf -u -city "New York"

-state

<string>

Specifies the Parallels Plesk Panel administrator's state/province.

Required with the --init.

To set the Parallels Plesk Panel administrator's state to NY:

# ./init_conf -u -state NY

-zip

<string>

Specifies the Parallels Plesk Panel administrator's postal/zip code.

Required with the --init.

To set the Parallels Plesk Panel administrator's zip code to 10292:

# ./init_conf -u -zip 10292

-country

<string>

Specifies the Parallels Plesk Panel administrator's country.

The parameter of the command must be a valid two-letter country code as described in ISO-3166 (for example, "AU" stands for Australia).

Required with the --init.

To set the Parallels Plesk Panel administrator's country to United States:

# ./init_conf -u -country US

-hostname

<domain_name>

Specifies the Parallels Plesk Panel server's host name.

Used with the --init only.

To set the server's host name to host.example.com:

# ./init_conf --init -hostname host.example.com -name <..> -passwd <..> -phone <..> -email <..> -addr <..> -city <..> -country <..> -state <..> -zip <..>

-shared_ips

add:<ip_1>,<ip_2>, ...,<ip_n>

Sets the IP addresses specified by the parameters as shared.

The IP addresses must be added to the server IP address pool before they can be assigned the shared status.

Used with the --init only.

To set IP addresses 192.0.2.46 and 192.0.2.47 as shared IP addresses:

# ./init_conf --init -shared_ips add:192.168.123.46,192.168.123.47 -name <..> -passwd <..> -phone <..> -fax <..> -email <..> -addr <..> -city <..> -country <..> -state <..> -zip <..>

-send_announce

true|false

Allows/Prohibits sending to the Parallels Plesk Panel administrator email notifications on new products and promotions from Parallels.

To subscribe the Plesk administrator to Parallels notifications about new products and promotions lists of Parallels:

# ./init_conf -u -send_announce true

-def_client

 

Creates the default client account MyDomains for the Plesk administrator.

Deprecated.

To create the default client account for the Parallels Plesk Panel administrator:

# ./init_conf --init -def_client -name <..> -passwd <..> -phone <..> -fax <..> -email <..> -addr <..> -city <..> -state <..> -zip <..>

-default-ip

<IP_address>

Specifies the default IP address during initial Parallels Plesk Panel configuration.

This option is used with the --init only.

If this address has not yet been added to the server IP address pool, the option requires use of the -netmask, -iface, and -ip-type options.

To set the Parallels Plesk Panel default IP address to 192.0.2.14, make the address shared, set the network mask to 255.255.0.0, and network interface name to eth0:

# ./init_conf --init -default-ip 192.0.2.14 -netmask 255.255.0.0 -iface eth0 -ip-type shared -name <..> -passwd <..> -phone <..> -fax <..> -email <..> -addr <..> -city <..> -country <..> -state <..> -zip <..>

-netmask

<IPaddress|nn>

Specifies a network mask for the default IP address in Parallels Plesk Panel during initial Parallels Plesk Panel configuration.

Used with the --init only.

-iface

<dev>

Specifies a name for the network interface for the default IP address during initial Parallels Plesk Panel configuration.

Used with the --init only.

-ip-type

shared|exclusive

Specifies the type of the default IP address during initial Parallels Plesk Panel configuration.

Used with the --init only.

-admin_info_not_required

true|false

Defines whether Parallels Plesk Panel Administrator's personal info (except for email) is marked as Required or not.

Is false by default.

To initialize Parallels Plesk Panel server so that the Parallels Plesk Panel Administrator after entering his credentials to freshly-installed Parallels Plesk Panel got directly to Administrator's desktop skipping all 'first-login configuration' screens:

# ./init_conf -u -admin_info_not_required true

-license_agreed

true|false

Defines whether the Parallels Plesk Panel license agreement is accepted.

Is false by default.

To initialize Parallels Plesk Panel server so that the Parallels Plesk Panel Administrator after entering his credentials to freshly-installed Parallels Plesk Panel automatically agrees the license agreement:

# ./init_conf -u -license_agreed true

Please send us your feedback on this help page.