3.1 Downloading and Configuring iPrint Appliance

3.1.1 Downloading the 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 system resources and so forth.

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.

VMware Configuration

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

    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.

  2. Extract the iPrint.x86_64-version.ovf.zip file on your management workstation so that the iPrint-version file folder appears.

  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. The default of 4 GB might not be sufficient except in a very limited testing environment.

    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.

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

  12. Power on the appliance (virtual machine).

  13. Continue with Section 3.1.2, Installing iPrint Appliance.

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. The default of 4 GB might not be sufficient except in a very limited testing environment.

  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 3.1.2, Installing iPrint Appliance.

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. The default of 4 GB might not be sufficient except in a very limited testing environment.

  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 3.1.2, Installing iPrint Appliance.

3.1.2 Installing iPrint Appliance

  1. After you have downloaded the iPrint appliance, configured the virtual environment, and powered on the appliance, click the Console tab.

  2. After the appliance starts, select your preferred keyboard layout in the Keyboard Language drop-down, then accept the license agreement. You can change the language the license agreement is displayed in from the License Language drop-down.

    The iPrint Appliance Configuration page is displayed.

  3. On the configuration page, specify the following network information:

    Root password and confirmation: The root password for your iPrint appliance.

    Vaadmin password and confirmation: The preferred user to use when logging in to the appliance.

    Hostname: The fully qualified DNS host name associated with the appliance’s IP address. For example, myiPrint.mynetwork.example.com.

    IP Address: The static IP address for the appliance. For example, 172.17.2.3.

    Network Mask: The network mask associated with the appliance’s IP address. For example, 255.255.255.0.

    Gateway: The IP address of the gateway on the subnet where your iPrint virtual appliance is located. For example, 172.17.2.254.

    DNS Servers: The IP address of a primary DNS server for your network. For example, 172.17.1.1.

    NTP Server: The IP address or DNS name of the reliable external Network Time Protocol (NTP) server your OES server uses. For example, time.example.com.

    For the best results, set up NTP in accordance with the VMware best practices guidelines.

    Region: Your local region.

    Time Zone: Your local time zone.

  4. Click Next.

  5. Select the data storage location.

    • Hard Disk (recommended): 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.

    • Remote NFS: You must export the remote directory before you choose this option.

      IMPORTANT:If you want to configure iPrint Appliance using the Remote NFS option, you must ensure that the NFS share is mounted on OES or Netware, and configure the NFS share with the rights rw,no_root_squash,fsid=0.

  6. Click Next.

  7. (Conditional) If you selected Hard Disk in Step 5, specify the following options, then click Next:

    Hard Drive: Select the hard drive you are using.

    If you created a secondary VMware hard disk for this appliance as described in Step 10, it is automatically detected and sdb is displayed as the hard drive. Accept the defaults for the other options on this page and skip to Step 8.

    If you have not created a secondary VMware hard disk, you will notice a warning message. You can change the settings, or you can choose to continue the installation anyway.

    Use an existing partition: Select this option to use an existing partition.

    Create a new partition: Select this option to create a new partition.

    Partition size: Specify the partition size.

    Filesystem type: Specify the type of file system.

  8. (Conditional) If you selected Remote NFS in Step 5, specify the following options:

    NFS Server Hostname: Specify the host name of the NFS server. Windows servers are not supported.

    Remote Directory: Specify the path to the remote directory.

  9. Click Configure.

    The iPrint Appliance installation process begins. A message stating, “The system is ready for appliance configuration” is displayed. After the installation is complete, a URL and an IP address to access the iPrint Appliance Management Console is displayed. Using a Web browser, navigate to the Management Console URL.

    NOTE:Ignore the WARNING message that is displayed in the command prompt.

    The iPrint Appliance installation is now complete. You must configure iPrint Appliance before you can start printing. Continue with Section 4.0, Setting Up iPrint Appliance.