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.ovf.zip) to your workstation.

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

    NOTE:On a VMware workstation, do not extract the iPrintAppliance.x86_64-version.ovf.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. In the vSphere client, click File > Deploy OVF Template.

  4. Browse to and select the .ovf file from the iPrint-version file folder.

  5. Click Next.

  6. Click Next again.

  7. In the Name field, specify name for the iPrint appliance, then click Next.

  8. Select the location to store the virtual machine files, then click Next.

  9. Click Next to accept the disk format.

  10. Review the deployment settings, then click Finish.

    On successful deployment, ensure to add a secondary disk before starting the VM.

  11. Add a secondary disk for the appliance. The appliance configuration details will be stored in this location.

    1. In the vSphere client, right-click the virtual machine that you just created, then click Edit Settings.

      The Virtual Machine Properties page is displayed.

    2. On the Hardware tab, click Add.

      The Add Hardware dialog box is displayed.

    3. Select Hard Disk, then click Next.

    4. Select Create a new virtual disk, then click Next.

    5. Specify the disk space, then click Next. Recommended size is 40 GB.

    6. In the Advanced Options, continue with the default selection, then click Next.

    7. Review the settings, then click Finish.

  12. Power on the appliance (virtual machine).

  13. Continue with Initial Appliance Configuration.

4.1.2 Citrix Xen Configuration

Using OVF Format

  1. Download the iPrint software (iPrintAppliance.x86_64-version.ovf.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.ovf.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 OVF/OVA Package wizard is displayed.

  4. Import Source: Browse to F folder and select the .ovf file.

  5. Location:

    Click Next to continue with the default settings.

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

  7. Networking: To map an incoming virtual network interface to a target network, select a network from the list in the Target 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. Security:

    If the selected OVF/OVA package is configured with security features such as certificates or a manifest, select Verify manifest content to verify the list of files in the package. If the packages are digitally signed, the associated manifest is verified automatically and so the Verify manifest content option is not available on the Security page.

    Click Next.

  9. OS Fixup Settings: Since the VMs are created on XenServer, select Don’t use Operating System Fixup, then click Next.

  10. Transfer VM Settings: Configure the network settings, then click Next.

    1. Select a network from the list of network interfaces.

    2. To configure networking settings manually, select Use these network settings and enter the IP address, subnet mask and gateway.

      We recommend you to provide the same IP address that you plan to use for iPrint VM server. However, you can also provide a temporary IP address.

  11. Review all the import settings and then 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.

  12. 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. 40 GB is recommended.

    5. Click Add.

  13. Power on the appliance (virtual machine).

  14. Continue with Initial Appliance Configuration.

Using XVA Format

  1. Download the iPrint software (iPrintAppliance.x86_64-version.xva.tar.gz) 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.tar.gz 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. 40 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.xen.tar.gz) to the current directory on the host server. For example: /var/lib/xen/images/iPrint1

  6. Untar the iPrintAppliance.x86_64-version.xen.tar.gz file in the directory where you downloaded it.

    You can use the following command to untar the file:

    tar -Sxvzf iPrintAppliance.x86_64-version.xen.tar.gz

    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 11 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: 4 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. 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 untared in Step 6.

      Protocol: Select file:.

      Size (GB): The default size is 40.1 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.

  14. 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.

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

  15. Click OK > Apply.

  16. 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 14.

  17. Continue with Initial Appliance Configuration.

4.1.4 Hyper-V Configuration (Not Available for Beta)

  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.vhd.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.vhd.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. 4 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 .vhd 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 VHD, 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. 40 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.