Maintaining a local mirror of Plesk Autoinstall Servers helps you to avoid wasting a lot of time and traffic on downloading the same files again and again when installing or updating multiple Plesk servers. Local mirrors are available via HTTP, and can be specified as sources for downloading Plesk packages in the course of installation or upgrade.

Prerequisites for a Local Mirror Repository

  1. Virtual host used for mirroring should have all script handlers (php, pl, cgi, py, fcgi etc) disabled.
  2. Virtual host or directory used for mirroring should have option +FollowSymLinks set.
  3. Unless the other sources are specified, the following must be accessible from the machine, where the script is being run, and from the destination machine:
    • rsync://rsync.autoinstall.plesk.com/autoinstall for Plesk for Linux,
    • rsync://autoinstall-win.plesk.com/autoinstall for Plesk for Windows.
  4. PHP must be compiled with support of the below extensions on the machine, where the script is being run (see http://www.php.net/manual/en/ssh2.installation.php):
    • ssh2_connect,
    • simplexml,
    • XML DOM.
  5. Plesk for Windows and Plesk for Linux mirrors can not be located in the same folders. Mirrors must be created in separate paths.

Configuring a Local Mirror Repository

  1. Download and unzip the Plesk Mirror Setup tool

    # wget https://support.plesk.com/hc/en-us/article_attachments/12388062580887/mirrorctl-3.1.4.zip
    # unzip mirrorctlv2.0.1.zip
    # cd mirrorctl
    
  2. Check for available product versions

    Use the show-all-releases command to view available products and os-list command to view OSes supported by particular product:

    # ./mirrorctl show-all-releases
    

    image 76560

    # ./mirrorctl os-list --release=PLESK_12_0_18
    

    image 76562

  3. Select product versions you want mirrored

    Use cfg --add and cfg --remove to edit the list of product versions that are to be mirrored:

    # ./mirrorctl cfg --add --release=PLESK_12_0_18 --os=cos5_i386
    # ./mirrorctl cfg --add --win --release=PANEL_12_0_18_WIN --cfg-file=./plesk_win_mirror
    
  4. Save the configuration of the local mirror repository to a file

    Use cfg --export to save the created configuration to a file:

    # ./mirrorctl cfg --export --path=./
    

    The configuration will be saved to a file mirror.xml at the specified location.

    <?xml version="1.0" encoding="UTF-8"?>
    <xml>
        <release name="PLESK_12_0_18" version="12.0.18">
            <os name="cos5_i386"/>
        </release>
    </xml>
    

    To load a saved configuration from a file, use cfg --import:

    # ./mirrorctl cfg --import --cfg-file=./mirror.xml
    
  5. Create the mirror repository

    First, create a directory for the mirror:

    # mkdir /var/www/html/mirror/
    # mkdir /var/www/html/mirror_windows/
    

Then, use the update command to synchronize the mirror with the official repository:

# ./mirrorctl update --path=/var/www/html/mirror/
# ./mirrorctl update --win --path=/var/www/html/mirror_windows/ --cfg-file=./plesk_win_mirror

Note: This repository can be used to install only the product versions and OSes, which were specified in the mirror configuration. All other versions will not be available in this repository for autoinstaller utility.

Check the list of product versions available in the created repository:

# ./mirrorctl show-all-releases --src-host=/var/www/html/mirror/
# ./mirrorctl show-all-releases --win --src-host=/var/www/html/mirror_windows/

image 76566

The local mirror repository can now be used in the process of installing and upgrading Plesk.

Using a Local Mirror Repository

A mirror can be used in either of the following ways:

  • by changing DNS resolving and setting up the mirror web host so that https://autoinstall.plesk.com (for Plesk Linux) or http://autoinstall-win.plesk.com/ (for Windows) would point to the mirror;

  • by specifying the URL to the mirror in the SOURCE variable of the /root/.autoinstallerrc file on the machine where autoinstaller is launched;

    [root@container ~]# cat  /root/.autoinstallerrc
    SOURCE=http://uri.of.local.mirror/here/
    
  • by specifying the mirror URL in the --source option when launching autoinstaller in interactive mode.

Maintaining Remote Mirror Repositories

Plesk Mirror Setup tool can manage repositories that are located on the same file system as well as on remote servers. To specify remote source and remote destination mirrors, the --path and --src-host options are used.

Use --path to specify the remote destination mirror:

  1. Using a particular user, password and host:

    --path=user:UserSecurePassword@mymirror.tld:344/var/www/html/
    --path=user:UserSecurePassword@192.168.100.100:22/var/www/html/
    --path=root:RootSecurePassword@localhost:/var/www/html/
    
  2. Using SSH keys authorization (both private and public keys are required):

    --path=192.168.100.100:/var/www/html/
    

    If default RSA pair (id_rsa & id_rsa_pub) for current user does not exist, then default DSA pair (id_dsa & id_dsa.pub) from $HOME/.ssh/ folder will be used.

    --path=user@mymirror.tld:344/var/www/html/
    
  3. Using particular SSH keys as additional options for mirrorctl utility:

    --path=root@mymirror.tld:344/var/www/html/ --private-key=~/.ssh/id_mirror --public-key=~/.ssh/id_mirror.pub
    

Use --src-host to specify the remote source mirror:

  1. Using rsync via SSH protocol:

    --src-host=test@192.168.100.100:/var/www/html/test-mirror/
    --src-host=mytestmirror.tld:/var/www/html/test-mirror/
    
    • In the above case it is forbidden to specify user password or SSH port (22).
    • In case --src-host option is used, the user who launches the tool must have SSH keys authorization set up for him to be able to connect to the host specified under --src-host option and under the user specified via that option.
    • If the --src-host option is used along with the --path option, then, again, the user specified in the --path option must have SSH keys authorization set up for him to be able to connect from the host specified in the --path option to the host specified under --src-host option and under the user specified via --src-host option.
  2. Using rsync daemon on the source host:

    --src-host=rsync://mytestmirror.tld:873/testmirror
    

Example of rsync configuration:

# head /etc/rsyncd.conf
[testmirror]
path = /var/www/html/test-mirror/
comment = Test repository
# cat /etc/xinetd.d/rsync
service rsync
{
# disable = yes
socket_type = stream
wait = no
user = root
server = /usr/bin/rsync
server_args = --daemon
log_on_failure += USERID
}

Example 1: Setting up periodic updates for the local mirror repository

Goal: make sure my mirror with selected product versions is up to date.

  1. Create the mirror configuration by adding the needed product versions and operating systems:

    # /home/user/mirrorctl/mirrorctl cfg --add --release=PLESK_12_0_18 --os=cos5_i386 --cfg-file=/var/www/html/mirror/myconfig.xml
    # /home/user/mirrorctl/mirrorctl cfg --add --release=PLESK_12_0_18 --os=rhel5_i386 --cfg-file=/var/www/html/mirror/myconfig.xml
    # /home/user/mirrorctl/mirrorctl cfg --add --release=PLESK_11_5_30 --os=cos5_i386 --cfg-file=/var/www/html/mirror/myconfig.xml
    # /home/user/mirrorctl/mirrorctl cfg --add --win --release=PANEL_12_0_18_WIN --cfg-file=/var/www/html/mirror/windows_myconfig.xml
    
  2. Configure crontab to automatically update the mirror:

    $ crontab -l
    # m h dom mon dow command
    59 23 * * * cd /home/user/mirrorctl/ && ./mirrorctl update --path=/var/www/html/mirror/ --cfg-file=/var/www/html/mirror/myconfig.xml > ./mirror-cron.log 2>&1
    59 22 * * * cd /home/user/mirrorctl/ && ./mirrorctl update --win --path=/var/www/html/mirror_windows/ --cfg-file=/var/www/html/mirror/windows_myconfig.xml > ./mirror-cron-win.log 2>&1
    

Example 2: Adding new operating systems

Goal: add another operating system for a particular product version to my mirror.

  1. Import the current configuration of the repository that you created earlier using mirrorctl utility:

    # ./mirrorctl cfg --import --path=/var/www/html/mirror/ --cfg-file=myconfig
    
  2. Add the new OS for a product version:

    # ./mirrorctl cfg --add --release=PLESK_12_0_18 --os=deb6.0_i386 --cfg-file=myconfig
    
  3. Synchronize the mirror:

    # ./mirrorctl update --path=/var/www/html/mirror/ --cfg-file=myconfig
    

Example 3: Downloading a particular OS/version

Goal: download a particular OS for a particular product version to my mirror from the official repository without downloading other mirrored versions/OSes.

  1. Generate a configuration file containing only the OSes/product versions that you wish to download:

    # ./mirrorctl cfg --add --release=PLESK_12_0_18 --os=cos5_i386 --cfg-file=./temp-config
    # ./mirrorctl cfg --add --release=PLESK_12_0_18 --os=cos5_x86_64 --cfg-file=./temp-config
    
  2. Download the specified OSes to an existing repository using push command:

    # ./mirrorctl push --path=/var/www/html/mirror/ --cfg-file==./temp-config
    

Example 4: Creating a mirror for testing new product versions

Goal: create a test mirror for a new product version, test that version and upload only that tested version (without the latest official updates, which I have not yet tested) to the main repository.

  1. Create a test mirror for all OSes of the new product version:

    # ./mirrorctl cfg --add --release=PLESK_12_0_18 --os=all --cfg-file=./test-config
    # ./mirrorctl update --path=/var/www/html/test-mirror/ --cfg-file=./test-config
    
  2. Test the new version;

  3. Upload the whole product version to the main repository:

    # ./mirrorctl push --src-host=/var/www/html/test-mirror/ --path=/var/www/html/mirror/ --cfg-file=./test-config
    

Warning: If --src-host option is not used, then the new product version will be uploaded from the official repository and may be different from the one you have tested.

Example 5: Creating a mirror for testing product releases for new OSes

Goal: create a test mirror with a list of particular OSes for already mirrored product versions with the latest updates, test those OSes and then upload some of the tested OSes to the main repository.

  1. Create a test mirror where several OSes will be available for selected product version:

    # ./mirrorctl cfg --add --release=PLESK_12_0_18 --os=cos5_i386 --cfg-file=./test-config
    # ./mirrorctl cfg --add --release=PLESK_12_0_18 --os=cos5_x86_64--cfg-file=./test-config
    # ./mirrorctl update --path=/var/www/html/test-mirror/ --cfg-file=./test-config
    
  2. Get the list of available product releases and OSes from the test mirror created above:

    # ./mirrorctl show-all-releases --src-host=/var/www/html/test-mirror/
    # ./mirrorctl os-list --release=PLESK_12_0_18 --src-host=/var/www/html/test-mirror/
    
  3. Generate a new configuration file containing only those releases and OSes from the test mirror, which you would like to add to the main mirror:

    # ./mirrorctl cfg --add --release=PLESK_12_0_18 --os=cos5_i386 --src-host=/var/www/html/test-mirror/ --cfg-file=push.xml
    
  4. Check the created configuration file for the availability of the releases/OSes in the test repository:

    # ./mirrorctl cfg --check --src-host=/var/www/html/test-mirror/ --cfg-file=push.xml
    
  5. Upload the selected releases and OSes from the test mirror to the main repository:

    # ./mirrorctl push --src-host=/var/www/html/test-mirror/ --path=/var/www/html/mirror/ --cfg-file=push.xml
    

Warning: If --src-host option is not used, then the new product version will be uploaded from the official repository and may be different from the one you have tested.

Warning: If the --cfg-file option is not specified, the default configuration file BUILD/config.xml (relative to the directory the tool is located in) will be used. I.e. only the versions/OSes from that configuration file will be uploaded to the main repository.

Warning: If the --cfg-file option is specified incorrectly, the configuration file specified for the push command will be used.