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, Testing the Result of 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 in the target server:

  1. Create Driver Store.

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

  2. Create Print Manager.

    If eDirectory server1 value is not pointing to the reliable replica holding server, go to the /etc/opt/novell/iprint/conf/ipsmd.conf and modify the eDirectory server1 value to a reliable replica holding server. 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 the reliable LDAP server, change the AuthLDAPDNURL in the /etc/opt/novell/iprint/httpd/conf/iprint_ssl.conf to a reliable LDAP server. Restart Apache (rcapache2 restart).

  4. Ensure that admin user is LUM enabled.

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

  5. Ensure that iprintman authentication is successful.

    Check the authentication using IP Address and DNS name both.

    To check the authentication using IP Address, enter

    iprntman psm -l -s <IP address>

    To check the authentication using DNS name, enter

    iprntman psm -l -s<DNS name>

  6. Test iPrint prior to the migration.

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

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

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

25.4.2 iPrint Consolidate Migration

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

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 at a terminal prompt, enter miggui.

    For details on configuring source and target server information, selecting a migration type, opening a project, and 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 the 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 the 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 field is case sensitive. This displays the printers in the Printer Agents list.

    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

    Select this option to create the 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

    Select this option to avoid migrating the same printers, if the printer names on source server match the existing printer names on the target server under the same context. Otherwise, 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 indicated 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.

     

    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 on 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 on the minus button (-). You can remove one Broker at a time.

     

    Migrate Printer Drivers

    If the driver names are same on the source Driver Store and the target Driver Store, the target drivers are overwritten. If you do not select this option, the association of the Printer Agent still remains intact with the driver.

     

    Migrate Printer Driver Profile

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

     

    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.

  6. On completion of the migration, if you have created or added any additional printers on the source server you can use the Sync option to migrate those printers and its associated drivers to the target server.

    Sync option can only be used when you have migrated all the printers from the source server (that is, if you have selected Select All option from the GUI).

Using the Command Line Utility

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

  1. Use one of these 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 providing 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

25.4.3 Testing the Result of iPrint Migration

  1. Manage your iPrint objects using iManager.

  2. Install few printers on test workstation.

  3. Run reports to verify all the information migrated.

    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 the expected values.

25.4.4 Transfer ID

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 Transfer ID, do the following:

  1. Go to the /etc/opt/novell/iprint/conf/ipsmd.conf and change the PSMHostAddress value to the source server's IP or DNS (preferably a CNAME was used). Ensure to use whatever address 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 to the workstations.

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

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

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

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

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

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

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

  7. Test your iPrint. Using iManager, manage the Print Manager, Driver Store, and printers to test iPrint.

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