4.1 Configuring Virtual Environment

You must download the iPrint Appliance and configure the virtual environment where you plan to run the appliance.

The process of downloading the iPrint Appliance and configuring the virtual environment differs, depending on which virtual environment you plan to use to run the iPrint Appliance.

4.1.1 VMware Configuration

  1. Download the iPrint software (iPrintAppliance.x86_64-version.ova.zip) to your workstation.

  2. Extract the iPrintAppliance.x86_64-version.ova.zip file on your workstation. The iPrint-version folder is created with the .ova file.

    NOTE:On a VMware workstation, do not extract the iPrintAppliance.x86_64-version.ova.zip file using the default Windows extractor. On deploying this file, you may receive an error message, Access is Denied. To resolve this issue, extract the file using any other third-party extractor.

  3. On a Web browser, enter the URL for the VMware Web Client and login with the root credentials.

  4. Right-click on the Virtual Machines and click Create/Register VM.

  5. On the Select creation type page, select Deploy a virtual machine from an OVF or OVA file, then click Next.

  6. In the Select OVF and VMDK files page, specify the name for the virtual machine. For example, iPrint_5.0. Upload the .ova file of iPrint, and click Next.

  7. On the Select Storage page, select a storage repository where the disk images for the imported VMs will be placed. Review the datastore details, and select an appropriate disk format from the available options. Retain all the other default settings, and click Next.

  8. In the Deployment options page, uncheck Power on automatically (so that the VM can be powered on after adding the disks), and click Next.

  9. Review the screen and click Finish to successfully deploy the iPrint Appliance.

  10. Add a secondary disk to store the appliance configuration and log information.

    1. Right-click the virtual machine iPrint_5.0, then select Edit settings.

    2. On the Virtual Hardware tab, click Add hard disk > New standard hard disk. This adds the second hard disk. Recommended size is 50 GB.

    3. The iPrint VM now has two (2) hard disks. Click Save to successfully add the hard disks.

  11. Power on the appliance (virtual machine).

  12. Continue with Initial Appliance Configuration.

4.1.2 Citrix Xen Configuration

  1. Download the iPrint software (iPrintAppliance.x86_64-version.xva.zip) to your management workstation.

    You can download the software from the Novell Customer Center (NCC) Or you can download an evaluation version of the software from the Novell Downloads page.

  2. Extract the iPrintAppliance.x86_64-version.xva.zip file on your management workstation.

  3. In the Citrix XENCenter client, right-click the server on which you will install iPrint Appliance, then click Import.

    The Import XVA Package wizard is displayed.

  4. Import Source: Browse to iPrintAppliance.x86_64-version folder and select the .xva file.

  5. Home Server:

    Select the server that you want to nominate as home server for this VM. Click Next.

  6. Storage: Select one or more storage repositories (SRs) where the disk images for the imported VMs will be placed, then click Import.

  7. Networking: To map an incoming virtual network interface to a target network, select a network from the list in the Network column, then click Next.

    The Network and MAC address shown in the list of the VMs are stored as part of the definition of the original (exported) VM in the export file.

  8. Review all the import settings.

    NOTE:Do not select the option Start VMs after import. If you select this option the VM will start without user intervention. We need to add a secondary hard disk before starting the VM.

    Click Finish to begin the import process and close the wizard. The import progress is displayed in the status bar at the bottom of the XenCenter window and also on the Logs tab.

  9. Add a separate hard disk for the appliance. The appliance configuration details will be stored in this location.

    1. In the Citrix XENCenter client, select the virtual machine that you just created, and click on the Storage tab.

      The Virtual Disks page is displayed.

    2. Click Add.

      The Add Virtual Disk dialog box is displayed.

    3. In the Name field, specify the name of the virtual disk.

    4. In the Size field, specify the amount of hard disk space that you want to allocate. 50 GB is recommended.

    5. Click Add.

  10. Power on the appliance (virtual machine).

  11. Continue with Initial Appliance Configuration.

4.1.3 Xen Configuration

  1. Log in to the host server either locally or from a remote workstation.

    You can use the following command to log in to the host server from a remote workstation on Linux:

    ssh -X root@host_ip_address

    You must use the -X in the command in order to display the GUI installation program. The steps in this section use the GUI installation program to configure the server.

  2. Navigate to the /var/lib/xen/images directory on the host server.

  3. Create a new directory inside the images directory where you can download the iPrint software.

    The name of this directory must be the same as the name that you plan to use for your iPrint virtual appliance. For example, if you plan to name the iPrint appliance iPrint1, the name of this new directory must also be iPrint1.

  4. Change to the directory that you just created. For example, /var/lib/xen/images/iPrint1.

  5. Download the iPrint software (iPrintAppliance.x86_64-version.qcow2.zip) to the current directory on the host server. For example: /var/lib/xen/images/iPrint1

  6. Unzip the iPrintAppliance.x86_64-version.qcow2.zip file in the directory where you downloaded it.

    You can use the following command to unzip the file:

    unzip iPrintAppliance.x86_64-version.qcow2.zip

    A iPrint-version directory is created, which contains a .raw file that you will use to run the virtual image. This process can take a few minutes.

  7. From the host server, run the following command to launch the GUI configuration menu:

    vm-install

    The Create a Virtual Machine wizard is displayed.

  8. Click Forward.

  9. Select I have a disk or disk image with an installed operating system, then click Forward.

  10. Leave SUSE Linux Enterprise Server 15 selected, then click Forward.

  11. Rename the virtual machine by clicking Name of Virtual Machine, then specifying a new name in the Name field. Then click Apply. For example, iPrint1.

  12. Configure the amount of memory and number of CPUs that Xen allocates for the iPrint appliance.

    1. On the Summary page, click Hardware, then specify the following information:

      Available Memory: Displays the amount of available memory that is available on the host server.

      Initial Memory: 8 GB is the recommended minimum amount of memory.

      Maximum Memory: Set this to the same value that you set for Initial Memory.

      Available Processors: Displays the number of available processors on the host server.

    2. Click Apply.

  13. Select the Peripheral Devices and specify the keyboard translation map file. Then click Apply.

    For example, (keymap: en-us).

  14. Configure the bootable disk image:

    1. On the Summary page, click Disks.

    2. Click Harddisk.

    3. On the Virtual Disk page, specify the following information:

      Source: Click Browse, then browse to the .raw file that you unzipped in Step 6.

      Protocol: Select file:.

      Size (GB): The default size is 50 GB. This cannot be changed.

      Create Sparse Image File: This option is not available.

      Read-Only Access: Do not select this option.

    4. Click OK.

  15. Add a separate Xen hard disk. You must add a hard disk to the virtual machine before you choose this option. If you have not already added a hard disk, click Power Off Virtual Machine, modify the virtual machine settings to add a hard disk, then power on the virtual machine.

    1. On the Disks page, click Harddisk.

    2. On the Virtual Disk page, specify the following information:

      Source: This field should already contain the path to the .raw file that will be created when the virtual machine is created. If desired, you can rename the disk in the source field from disk0 to a name of your choosing.

      Storage Format: Select the qcow2 format.

      Size (GB): Specify the amount of hard disk space that you want to allocate. 50 GB is recommended.

  16. Click OK > Apply.

  17. Click OK to save your changes and to create and power on the virtual machine.

    IMPORTANT:Do not power on the appliance until you have created a separate Xen hard disk for the appliance, as described in Step 15.

  18. Continue with Initial Appliance Configuration.

4.1.4 Hyper-V Configuration

  1. Log in to the host server either locally or from a remote workstation.

    You can use Windows Remote Desktop to log in to the host server from a remote workstation.

  2. Create a new directory in the location where you want each virtual machine to reside (for example, C:\Users\Public\Documents\Hyper-V\Virtual Hard Disks). In a later step, you will download the iPrint software to this directory.

    As a best practice, give this directory the same name as the name that you plan to use for your iPrint virtual appliance. For example, if you plan to name the iPrint appliance iPrint1, the name of this new directory should also be iPrint1.

  3. Download the iPrint software (iPrintAppliance.x86_64-version.vhdx.zip) to the directory on the host server that you created in Step 2.

    You can access the software from the Novell Customer Center (NCC). Or, you can access an evaluation version of the software from this location.

  4. Extract the iPrintAppliance.x86_64-version.vhdx.zip file to the directory on the host server that you created in Step 2.

  5. Open the Hyper-V Manager.

  6. In Hyper-V Manager, right-click the disk name in the Action Pane in the left-hand column of the Hyper-V Manager window. This is the disk where you want to create the new virtual machine. Then click New > Virtual Machine.

    The New Virtual Machine Wizard is displayed.

  7. Review the Before You Begin page, then click Next.

  8. In the Name field, specify a name for the new virtual machine. For example, iPrint1.

  9. Click Next.

  10. In the Startup memory field, specify the amount of memory (in MB) to allocate to the virtual machine. 8 GB is the recommended minimum for a iPrint.

  11. Click Next.

  12. On the Configure Networking page, select the networking card of your choice, then click Next.

  13. Configure the bootable disk image:

    1. On the Connect Virtual Hard Disk page, select Use an existing virtual hard disk, then browse to the .vhdx file that was in the downloaded .zip file that you extracted in Step 4.

    2. Click Open to select the file, then click Next.

  14. Click Finish.

  15. Create a separate Hyper-V hard disk for the appliance. You must add a hard disk to the virtual machine before you choose this option. If you have not already added a hard disk, click Power Off Virtual Machine, modify the virtual machine settings to add a hard disk, then power on the virtual machine.

    NOTE:If you do not add a hard disk to the virtual machine, then iPrint Appliance is installed on the default partition. The default partition is /sda.

    1. In Hyper-V Manager, right-click the disk that you just created, then click Settings.

    2. In the Hardware section, select IDE Controller 1, select Hard Drive, then click Add.

    3. Select Virtual hard disk, then click New.

    4. Review the Before You Begin page, then click Next.

    5. On the Choose Disk Format page, select VHDX, then click Next.

    6. On the Choose Disk Type page, select Fixed size, then click Next.

    7. On the Specify Name and Location page, specify the following information, then click Next:

      Name: Specify a name for the hard disk. For example, iPrintDisk2.

      Location: Specify the location where you want the hard drive to be located.

  16. On the Configure Disk page, select Create a new blank virtual hard disk, then specify a size for the hard disk. 50 GB is recommended.

  17. Click Next.

  18. Review the summary information, then click Finish.

  19. Click Apply > OK.

  20. Right-click the virtual machine, then click Start.

    IMPORTANT:Do not start the appliance until you have created a separate Hyper-V hard disk for the appliance, as described in Step 15.

  21. Right-click the virtual machine, then click Connect.

  22. Continue with Initial Appliance Configuration.