4.1 Deploying iPrint Appliance and Configuring the Virtual Environment

You must download the iPrint Appliance and configure the virtual environment where you plan to run the appliance. This includes configuring the system resources.

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 (iPrint.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 iPrint.x86_64-version.ovf.zip file on your management workstation so that the iPrint-version file folder appears.

    NOTE:On a VMware workstation, do not extract the iPrint.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.

    NOTE:If the virtualization software you are using does not support .ovf, you must convert the .ovf file to .vmx using the VMware OVF Tool available on the VMware Website.

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

  5. Click Next.

  6. Click Next again.

  7. In the Name field, rename the iPrint appliance to a name of your choice, then click Next.

  8. Click Next to accept the default for the disk format.

  9. Click Finish.

  10. (Optional) Create a separate VMware hard disk for the appliance. This is the location where you will store your iPrint files.

    1. In the vSphere client, right-click the virtual machine that you just created, and for which you want to create secondary storage, 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. In the Disk Size field, specify the amount of hard disk space that you want to allocate. 40 GB is recommended.

    6. Select a datastore, then click OK.

    7. Click Next.

    8. Click Finish.

  11. Increase the amount of memory that VMware allocates for the iPrint appliance.

    1. In the Virtual Machine Properties window, select Memory, then increase the setting to a suitable size for your environment. 4 GB is recommended.

    2. Click OK to exit the Virtual Machine Properties window.

  12. Power on the appliance (virtual machine).

  13. Continue with Section 4.2, Initial Appliance Configuration.

4.1.2 Citrix Xen Configuration

  1. Download the iPrint software (iPrint.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 iPrint.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 iPrint.x86_64-version 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. (Optional) Create a separate hard disk for the appliance. This is the location where you will store your iPrint files.

    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 Section 4.2, 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 (iPrint.x86_64-version.xen.tar.gz) to the current directory on the host server. For example: /var/lib/xen/images/iPrint1

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

  6. Untar the iPrint.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 iPrint.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. (Optional) Create 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.

    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. 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 Section 4.2, 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 (iPrint.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 on the Novell Downloads page.

  4. Extract the iPrint.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. (Optional) 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 Section 4.2, Initial Appliance Configuration.