PrlSrv_CreateUnattendedCd Function

Creates a bootable ISO-image for unattended Linux installation.

Syntax

PRL_HANDLE PrlSrv_CreateUnattendedCd(
    PRL_HANDLE hServer, 
    PRL_UINT32 nGuestType, 
    PRL_CONST_STR sUserName, 
    PRL_CONST_STR sPasswd, 
    PRL_CONST_STR sFullUserName, 
    PRL_CONST_STR sOsDistroPath, 
    PRL_CONST_STR sOutImagePath
);

File

PrlApiVm.h

Parameters

hServer

A handle of type PHT_SERVER identifying the Virtuozzo Service.

sUserName

User name.

sPasswd

Password.

sFullUserName

Full user name.

sOsDistroPath

A full path to the OS distribution image or folder.

sOutImagePath

A full path to output ISO-image file.

nGuestDistroType

Guest OS version from the (PVS_GUEST_VER_...).

sPath

Full path to the OS distribution image or folder.

Returns

A handle of type PHT_JOB containing the results of this asynchronous operation or PRL_INVALID_HANDLE if there's not enough memory to instantiate the job object.

Remarks

The following steps describe how to prepare a virtual machine for unattended Linux installation:

Create a virtual machine. The machine should have all the necessary devices, like hard drive and CD drive.
Insert Linux installation CD-ROM into the drive (or mount a disk image).
Execute the PrlVm_CreateUnattendedCd function to create a bootable ISO-image.
Set created ISO-image as boot device.
Start the virtual machine. The machine will boot from the created ISO-image.
Perform unattended Windows installation as usual.

To get the return code from the PHT_JOB object, use the PrlJob_GetRetCode function. Possible values are:

PRL_ERR_INVALID_ARG - invalid handle or null pointer was passed.

PRL_ERR_SUCCESS - function completed successfully.

Links

PHT_SERVER