ipmanage.exe: IP Addresses

The ipmanage.exe utility serves to manage Plesk IP addresses. This utility allows the following:

  • registering IP addresses in Plesk database
  • removing IP addresses from Plesk database
  • assigning an SSL certificate to an IP
  • changing a network interface for an IP
  • viewing a list of available IP addresses, SSL certificates, and interfaces

 

Location

%plesk_cli%

Usage
ipmanage.exe <command> [<IP>] [
<option 1> <param> [<option 2> <param>] ... [<option N> <param>]
]

 

Example

The following command creates IP address 192.0.2.10 with a subnet mask 255.255.255.0, sets the Local Area Connection interface for it, makes this IP address exclusive (available for using by only one client), and assigns the SSL certificate called My certificate to the IP.

ipmanage.exe --create 192.0.2.10 -mask 255.255.255.0 -interface "\"Local Area Connection"\" -type exclusive -ssl_certificate "My certificate<code>"</code>

 

Commands
Command Parameter Description Example

--create or -c

<IP>

Creates an IP address in Plesk database.

Requires -type, -ssl_certificate, -mask, -interface options.

See Example above.

--update or -u

<IP>

Changes IP address properties.

To change IP 192.0.2.123 type to exclusive:

ipmanage.exe --update 192.0.2.123 -type exclusive

--remove or -r

<IP>

Removes an IP address from Plesk database.

To remove IP 192.0.2.123:

ipmanage.exe --remove 192.0.2.123

--reread

 

Rereads the IP addresses.

To reread the IP addresses:

ipmanage.exe --reread

--ip_list or -l

 

Outputs the list of existing IP addresses.

To view the list of existing IP addresses:

ipmanage.exe --ip_list

--ssl_list or -s

 

Outputs the list of available SSL certificates.

To view the list of available SSL certificates:

ipmanage.exe --ssl_list

--inter_list or -f

 

Outputs the list of available network interfaces.

To view the list of available network interfaces:

ipmanage.exe --inter_list

--xml-info or -xi

 

Displays information about all available IP address in the XML format.

To view information about all available IP addresses in the XML format:

ipmanage.exe --xml-info

or

ipmanage.exe -xi

--reset_ssl_certificate

 

Specifies a default SSL certificate to all available IP addresses.

To set default SSL certificate to all available IP addresses:

ipmanage.exe --reset_ssl_certificate

--auto-remap-ip-addresses

true|false

Defines whether to perform the automatic mapping of IP addresses on Plesk startup. Use the option in cases when the registered IP addresses are changed (for example, when cloning a VPS with Plesk).

To enable automatic mapping of IP addresses on Plesk startup:

ipmanage.exe --auto-remap-ip-addresses

--change-ip

<IP>

Reassigns the IP address.

To reassign the IP 192.168.1.2 to 192.168.1.3:

ipmanage.exe --change-ip 192.168.1.2 -mask 255

.255.255.0 -interface "\"Local Area Connection"\" -ip 192.168.1.3

--help or -h

 

Outputs help on the utility use.

ipmanage.exe --help

Options
Option Parameter Description Example

-type

shared|exclusive

Defines the IP address type: an exclusive IP can be used by only one client, a shared IP can be used by many clients.

Required with --create.

To change IP 192.0.2.123 type to exclusive:

ipmanage.exe -u 192.0.2.123 -type exclusive

-ssl_certificate

<name>

Specifies a name of SSL certificate to be used for the IP.

Required with --create.

To assign a default certificate to IP 192.0.2.1:

ipmanage.exe -u 192.0.2.1 -ssl_certificate "Default Certificate"

-mask

<mask>

Specifies the IP subnet mask.

Used with --create only.

Required with --create.

To create an IP with 24-bit mask see Example above.

-interface

<dev>

Specifies the name of the physical network interface.

Used with --create only.

Required with --create.

To create an IP for the network interface "Local Area Connection" see Example above.

-ftps

true|false

Allows\prohibits using FTPS, i.e., accessing FTP associated with the IP over SSL.

To allow FTPS on IP 192.0.2.1:

ipmanage.exe -u 192.0.2.1 -ftps true

-public_ip

<IP>

Maps an internal IP to a public one to create NAT. Used with the --create and --update commands.

To map an internal IP 192.168.1.2 to a public IP 92.68.1.2:

# ./ipmanage -u # ./ipmanage -u -public_ip 92.68.1.2

-ip

<IP>

Maps the target IP address.

To reassign the IP 192.168.1.2 to 192.168.1.3:

ipmanage.exe --change-ip 192.168.1.2 -mask 255

.255.255.0 -interface "\"Local Area Connection"\" -ip 192.168.1.3

 

Notes

  1. It is preferable that the name of the SSL certificate is specified as a double-quoted string. If the name of the SSL certificate contains spaces, double quotes are mandatory.
  2. The name of the network interface must be specified as a double-quoted string. If the name of the network interface contains spaces, then it must be enclosed with "\" characters.
    For example, the default name for the network adapter used in Windows is Local Area Connection. To specify it, use the following format:
    -interface "\"Local Area Connection"\"