25.4 Migration Procedure

Perform the following steps for iPrint migration.

  1. Section 25.4.1, Pre-Migration iPrint Configuration

  2. Section 25.4.2, iPrint Consolidate Migration

  3. Section 25.4.3, Verifying the Result of the iPrint Migration

  4. Section 25.4.4, Transfer ID

  5. Section 25.4.5, Post Transfer ID Migration Steps

25.4.1 Pre-Migration iPrint Configuration

Perform the following pre-migration steps on the target server:

  1. Create the Driver Store. For more information, see Creating a Driver Store in the OES 2 SP3: iPrint for Linux Administration Guide.

    If eDirectory server1 value is not pointing to a server that holds a reliable replica, go to the /etc/opt/novell/iprint/conf/idsd.conf and modify the eDirectory server1 value to a server that holds a reliable replica. Change the IDSHostAddress value to the IP address (temporary IP Address) of the migration server. Restart the Driver Store (rcnovell-idsd restart).

  2. Create the Print Manager. For more information, see Creating a Print Manager in the OES 2 SP3: iPrint for Linux Administration Guide.

    If eDirectory server1 value is not pointing to a server that holds a reliable replica, go to the /etc/opt/novell/iprint/conf/ipsmd.conf and modify the eDirectory server1 value to a server that holds a reliable replica. Change the PSMHostAddress value to the IP address (temporary IP Address) of the migration server. Restart the Print Manager (rcnovell-ipsmd restart).

  3. Change the iPrint Apache configuration.

    If AuthLDAPDNURL is not pointing to a reliable LDAP server, change AuthLDAPDNURL in /etc/opt/novell/iprint/httpd/conf/iprint_ssl.conf to a reliable LDAP server. Restart Apache (rcapache2 restart).

  4. Ensure that the admin user is LUM-enabled.

    To check this, enter id admin at the terminal. If the admin user is LUM-enabled, UID and GID information is returned.

  5. Ensure that iprintman authentication is successful.

    Check the authentication by using both the IP address and the DNS name.

    To check the authentication by using the IP address, enter

    iprntman psm -l -s <IP address>

    To check the authentication by using the DNS name, enter

    iprntman psm -l -s<DNS name>

  6. Test iPrint prior to the migration on the target server.

    Using iManager, view the Print Manager and Driver Store. Click a few options to verify that you are not encountering any error.

On the completion of pre-migration steps, perform the Section 25.4.2, iPrint Consolidate Migration

NOTE:You can run the psminfo.nlm on the source server, then copy the psminfo.xml file to the target server at the /opt/novell/iprint/share location. This avoids contacting the source server during migration.

25.4.2 iPrint Consolidate Migration

Migration of the iPrint configuration can be done through the Migration Tool or through the command line interface.

NOTE:When you migrate iPrint from NetWare to OES Linux, Public Access Printers are not migrated.

Using the Migration Tool

  1. Launch the Migration Tool on the target server in one of the following ways:

    Desktop: Click Computer > More Applications > System > Novell Migration Tools.

    Terminal: Log in as the root user and enter miggui at the terminal prompt.

    For details on configuring the source and target server information, selecting a migration type, opening a project, and on all the tool buttons, see Section 2.0, Overview of the Migration GUI.

  2. Authenticate to the source and target servers.

  3. Select Novell iPrint, then click Configure. The iPrint configuration window is displayed.

  4. Configure the following parameters to proceed with the migration process:

    Print Objects

    Parameter

    Description

    Print Managers

    Source Print Manager

    Specify the active Print Manager on the source server. The source Print Manager can be either an NDPS manager (for NetWare5.1 or 6.5) or iPrint Manager (for OES 1 and OES 2 Linux). To go directly to a context of your choice, specify the context in Search Base and click Search. The objects in the specified context are displayed.

     

    Target Print Manager

    The Target Print Manager field is populated with the name of the Active Print Manager running on the target server. This field is editable, and you can also specify a different name for the Active Print Manager. To go directly to a context of your choice, specify the context in Search Base and click Search. The objects in the specified context are displayed.

    Click Get Printers to select printer objects from the source Print Manager.

     

    eDirectory Server

    Select this option if the target server does not hold an eDirectory replica. Specify the IP address of the target server that holds the reliable eDirectory replica.

    Printer Objects

    Source printers

    Displays all the printers of the Active Print Manager available on the source server. The printers that already exist on the target server are indicated by an asterisk (*).

     

    Select All

    Selects all the printers listed in the Printer Objects dialog box.

     

    Filter

    Specify the search pattern in the Filter field. This displays the printers in the Printer Agents list. This field is case sensitive.

    Create target printer objects in

    Context same as source printer context

    Select this option to use the same context as the source printers on the target server.

     

    Target context

    This option is selected by default. This option allows you to create source printers under a different context on the target server. This option does not maintain the context hierarchy of the source printer.

    To go directly to a context of your choice, specify the context in the Search Base and click Search. The objects in the specified context are displayed.

     

    Do Not Migrate Existing Target Printers

    If the printer names on source server match the printer names on the target server, the target printer properties and attributes are overwritten by the source printer properties and attributes.

    The printers that already exist on the target server are represented by an asterisk (*).

    Other Options

    Parameter

    Description

    Target Driver Store

    Target Driver Store DN

    The Target Driver Store DN field is auto populated with the Driver Store associated with the PSM object, if the driver store is running. This field is editable, and you can also specify the name of the Driver Store. To directly go to a context of your choice, specify the context in the Search Base and click Search. The objects in the specified context are displayed.

    To directly go to a context of your choice, specify the context in the Search Base and click Search. The objects in the specified context are displayed.

    IMPORTANT:If the target Driver Store is hosted by a server that is not hosting the Print Manager, you can not select the Driver Store's eDirectory Server. To resolve this, go to Driver Store's /etc/opt/novell/iprint/conf/idsd.conf and update the DSServer1 value to the address of a server that holds the replica. Restart the Driver Store (rcnovell-idsd restart) after making the change.

     

    Target Driver Store is remote

    If the Driver Store is running on the remote server (other than the target server), the Target Driver Store is remote check box is enabled and is populated with the IP address or the DNS name of the remote server.

     

    Additional source Print Broker to be migrated to the above target Driver Store (optional)

    Click the plus button (+) and specify the IP address or the DNS name of the Source Broker. Select the Source Broker Volume from the drop-down list and click OK. The list is populated with the IP address or DNS name of the Source Broker and Broker volume name. You can add multiple Source Brokers to the list.

    To remove the Source Broker from the list, select the IP address or DNS name and click the minus button (-). You can remove one Broker at a time.

    Printer Drivers

    Do not Migrate Printer Drivers and the association of the Printer Agents with the Driver

    Selecting this option does not migrate Printer Drivers and the association of Printer Agents with the Driver.

     

    Migrate Printer Driver if the driver is not present in the target Driver Store

    Selecting this option migrates the Printer Drivers that are not present in the target Driver Store. This also migrates all the associations of the Printer Agents with the Driver.

     

    Migrate all Printer Drivers. This overwrites the Printer Driver on the target Driver Store

    Selecting this option overwrites the target drivers if the driver names in the target Driver Store are the same as the source Driver Store. This also migrates all the association of the Printer Agents with the Driver.

    Printer Driver Profile

    Migrate Printer Driver Profile

    If the profiles are the same on the target server as the source server, the target profiles are overwritten.

    iPrint.ini File

    Migrate iPrint.ini File

    If you migrate printer agents from two or more print managers, the iPrint.ini file on the target server is replaced by the iPrint.ini of the last source server.

  5. Click OK to finish the configuration and go back to the migration screen.

Using the Command Line Utility

You can use iprintmig to migrate iPrint. For more information, see iPrintmig Man Page.

  1. Use one of the following methods to migrate to an OES 2 SP3 Linux server:

    • From a terminal prompt on the target server, run iprintmig to migrate the printers on the source server to the target server. Before running the utility, set the environment variable for safely transferring the password.

      For safe transmission of passwords to the script via an environment variable or via the -P/-T options, see Using Passwords.

      IMPORTANT:This method is safe and recommended.

      Syntax: iprintmig -s source_server -u source_username_only -U target_username_only -a -x psminfo.xml -I cn=ids,o=example,c=us -i ids.example.com -c ou=iPrint,o=example,c=us

    • From a terminal prompt on the target server, run iprintmig to migrate the printers on the source server to the target server by specifying the password.

      IMPORTANT:The password is visible to users in this method.

      Syntax: iprintmig -s source_server -u source_username_only -p source password -U target_username_only -t target password -a -x psminfo.xml -I cn=ids,o=example,c=us -i ids.example.com -c ou=iPrint,o=example,c=us

Migrating One Printer at a Time

Example: iprintmig -s source_server_name -u source_admin -U target_admin -n printer1 -x psminfo.xml -I cn=ids,o=example,c=us -i ids.example.com -c ou=iPrint,o=example,c=us -N

Migrating a Few Printers at a Time

Example: iprintmig -s source_server_name -d target_server_name -u source_admin -U target_admin -x psminfo.xml -I cn=ids,o=example,c=us -i ids.example.com -c ou=iPrint,o=example,c=us -n printer1 -n printer2 -n printer3 -n printer4 -L

Migrating All Printers

Example: iprintmig -s source_server_name -d target_server_name -u source_admin -U target_admin -x psminfo.xml -I cn=ids,o=example,c=us -i ids.example.com -c ou=iPrint,o=example,c=us -a -N

Migrating Printers by Using SSL

Example: iprintmig -s source_server -u source username -U target username -a -I cn=ids,o=example,c=us -i ids.example.com -c ou=iPrint,o=example,c=us -ssl -port LDAP port -N

Migrating Printers without SSL

Example: iprintmig -s source_server -u source username -U target username -a -I cn=ids,o=example,c=us -i ids.example.com -c ou=iPrint,o=example,c=us -port LDAP port -N

IMPORTANT:Ensure that you verify the result of iPrint migration after completing the consolidate migration, as described in the section Section 25.4.3, Verifying the Result of the iPrint Migration.

25.4.3 Verifying the Result of the iPrint Migration

  1. Manage your iPrint objects by using iManager.

  2. Install few printers on the test workstation.

  3. Run reports to verify all the migrated information:

    1. Go to https://<MigrationServerIP>/PsmStatus/GenerateReportSettings.

    2. Select the check box for Printer Drivers, Associated NDS Printer, and other options known to exist on the NetWare Printer Agents.

    3. Click Generate Report.

    4. Verify that all the printer agents have expected values.

25.4.4 Transfer ID

IMPORTANT:Ensure that you verify the result of iPrint migration prior to start of the Transfer ID, as described in the section Section 25.4.3, Verifying the Result of the iPrint Migration. Do not start the Transfer ID process until the migrated iPrint service on the target server successfully completes the outlined tests.

Before performing transfer ID, ensure that you have met all the prerequisites and the migration is completed successfully.

We recommend to complete the consolidate migration before starting the Transfer ID without selecting the Novell iPrint service. For more information, see Section 9.0, Preparing for Transfer ID.

25.4.5 Post Transfer ID Migration Steps

On completion of the Transfer ID, confirm the following values:

  1. Go to /etc/opt/novell/iprint/conf/ipsmd.conf and change the PSMHostAddress value to the source server's IP address or DNS name (preferably a CNAME was used). Use the address that was used when you loaded with the /dnsname or /ipaddress switch. If you are unsure, view the name by which the iPrint printers are installed at the workstations.

    Change the eDirectory server1 value to a reliable eDirectory server address.

  2. Go to /etc/opt/novell/iprint/conf/idsd.conf and change the IDSHostAddress value to the source server's IP address or DNS name (which is now the target server's IP or DNS).

    Change the eDirectory server1 value to a reliable eDirectory server address.

  3. Go to /etc/hosts and ensure that entries are correct for the new identity.

  4. Go to /etc/opt/novell/iprint/httpd/conf/iprint_ssl.conf and update the AuthLDAPDNURL "ldaps://[address..]" to any reliable LDAP server.

  5. Go to /etc/opt/novell/iprint/httpd/conf/iprint_g.conf and update the address after the ServerName entry. Ensure that you choose the new identity IP address.

  6. Restart the Print Manager (rcnovell-ipsmd restart), Driver Store (rcnovell-idsd restart), and Apache (rcapache2 restart).

  7. Use iManager, manage the Print Manager, Driver Store, and printers to test iPrint.

    NOTE:If you encounter an error while managing the Print Manager, the possible reason for that could be that one of the certificates is not updated. To troubleshoot, refer to the Cool Solutions article Certificate Re-creation Script for OES1 and OES2.