The default reinstallation, as performed by the prlctl reinstall
command, creates a new private area for the broken container as if it were created by the prlctl create
command and copies the private area of the broken container to the /old
directory in the new private area so that no file is lost. There is also a possibility of deleting the old private area altogether without copying or mounting it inside the new private area, which is done by means of the --skipbackup
option. This way of reinstalling corrupted containers might in certain cases not correspond exactly to your particular needs. It happens when you are accustomed to creating new containers in some other way than just using the prlctl create
command. For example, you may install additional software licenses into new containers, or anything else. In this case you would naturally like to perform reinstallation in such a way so that the broken container is reverted to its original state as determined by you, and not by the default behavior of the prlctl create
command.
To customize reinstallation, you should write your own scripts determining what should be done with the container when it is being reinstalled, and what should be configured inside the container after it has been reinstalled. These scripts should be named vps.reinstall
and vps.configure
, respectively, and should be located in the /etc/vz/conf
directory on the hardware node. To facilitate your task of creating customized scripts, the containers software is shipped with sample scripts that you may use as the basis of your own scripts.
When the prlctl reinstall <UUID>
command is called, it searches for the vps.reinstall
and vps.configure
scripts and launches them consecutively. When the vps.reinstall
script is launched, the following parameters are passed to it:
Option | Description |
---|---|
| Container UUID. |
| The path to the container temporary private area. This path designates where a new private area is temporarily created for the container. If the script runs successfully, this private area is mounted to the path of the original private area after the script has finished. |
| The path to the container original private area. |
You may use these parameters within your vps.reinstall
script.
If the vps.reinstall
script finishes successfully, the container is started, and the vps.configure
script is called. At this moment the old private area is mounted to the /old
directory inside the new one irrespective of the --skipbackup
option. This is done in order to let you use the necessary files from the old private area in your script, which is to be run inside the running container. For example, you might want to copy some files from there to regular container directories.
After the vps.configure
script finishes, the old private area is either dismounted and deleted or remains mounted depending on whether the --skipbackup
option was provided.
If you do not want to run these reinstallation scripts and want to stick to the default prlctl reinstall
behavior, you may do either of the following:
-
Remove the
vps.reinstall
andvps.configure
scripts from the/etc/vz/conf
directory, or at least rename them; -
Modify the last line of the
vps.reinstall
script so that it would readexit 128
instead ofexit 0
.
The exit code 128
tells the utility not to run the scripts and to reinstall the container with the default behavior.