NOVELL TECHNICAL INFORMATION DOCUMENT TITLE: Printer Agent Conversion Utility v2.1.0.1 TID #: 2971536 README FOR: pacvrt2g.exe NOVELL PRODUCTS and VERSIONS: iPrint iPrint 1.0 for NetWare 5.1 Novell Distributed Print Services 2.1 Novell Distributed Print Services 3.0 iPrint - NW65 Novell Distributed Print Services - NW65 ABSTRACT: PAcvrt.exe is a windows utility that enables the migration of all NDPS printer agents on the NDPS Manager using the selected target gateway(s) to the selected Novell gateway. In addition, this tool can be used to enable iPrint on all Printer agents on the selected NDPS Manager and to configure the iPrint security options. ----------------------------------------------------------------- DISCLAIMER THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL. NOVELL MAKES ALL REASONABLE EFFORTS TO VERIFY THIS INFORMATION. HOWEVER, THE INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY. NOVELL MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION. ----------------------------------------------------------------- INSTALLATION INSTRUCTIONS: Copy the files to a directory on a Windows workstation that has the Novell Client for Windows installed. << Notes >> Printer agents that are using gateways that are not selected from the "Source Gateways to Convert" check boxes will not be migrated. Only Printer agents that are using the TCP-IP protocol will be migrated. Printer agents that are configured to use the IPX protocol will not be migrated. This is an All or Nothing migration. All printer agents running the selected source gateway(s) will be converted. If "Enable iPrint" options are selected these options will be applied to all printer agents A log file that reports which printers were found, what gateway changes were or were not made, and the iPrint enabling changes that were made is written to C:\PAcvrt_log.txt. This file is displayed after the conversion has been completed. It is recommended that this procedure be done after normal business hours to minimize interruption of print services for users. << Running the Tool >> It is important that the following steps be followed to successfully migrate printer agents to a different gateway, or to enable iPrint on existing printer agents. 1.) Log into the server hosting the NDPS Manager that you want to migrate. You must have admin rights to the file server. This application requires Client32 to be installed on the workstation. 2.) Back up the NDPS Manager's MOD database on the file server BEFORE you do anything. If you want to undo the migration you will need to have a current backup of the database to restore from. To do this, at the server console go to the NDPS Manager's "Available Options" menu and select "NDPS Manager Status and Control". Select "Database Options", then "Backup Database Files". The database should backup rather quickly. <<<< NOTE >>>> You will not be able to undo changes made by this tool if you do not complete this step. 3.) After taking the backup wait 5 minutes to let NDS synchronize. 4.) Create a backup directory off of the \\[PSM Host Volume]\NDPS\[SOME-RANDOM-NUMBER].PSM directory and manually copy the PSMDBSAV.DAT and PSMDBSAV.IDX files to your backup directory. You will need these backup files if you want to back out the changes made by this tool. 5.) Run the PAcvrt.exe utility. After the utility starts, enter the name of the server's NDS Tree in the first edit box. Enter the NDPS Manager's Full NDS Name in the second edit box. (.MyManager.OU.O ) 5.) If you are converting printer agents to a Novell gateway, check the checkboxes for the gateway(s) that you want to convert in the source gateways list. Then select the desired target Novell gateway. << NOTE >> If no source gateways are selected, no printer agents will be converted. 6.) If you are enabling iPrint on Printer Agents, check the "Enable iPrint on all Printer Agents..." check box then select the appropriate iPrint security model. The default is "Allow non-secure connections to printers, (No SSL or authentication)". Or, if you want to enable your printers to use SSL, select "Require secure connection to printers (SSL and authentication)". For additional information on iPrint security models, see the iPrint documentation NOTE: If the "Enable iPrint on all Printer Agents..." check box is not checked no printer agents will be enabled for iPrint. If the checkbox is checked, ALL Printer Agents on the NDPS Manager will be enabled. 7.) Click Start. In testing, the execution time is about 10 seconds to convert 500 printer agents. Your results may vary. << NOTE >> After running pacvrt.exe all printer agents have been updated with the selected Gateway and/or iPrint changes. However, they will continue running under the current Gateway and iPrint configurations until the NDPS Manager is shut down and restarted. Shutting down and restarting the NDPS Manager with 500 printer agents will interrupt print services for about 10 to 20 minutes. Your time may vary depending on the gateway that is currently running, the number of printer agents, and the processor speed of your server. After converting to the NDPSGW.NLM (NOVELL SNMP GATEWAY) shutdown and load times for 500 printer agents should be 2 to 3 minutes. 8.) After the NDPS Manager has been reloaded verify that all of the printer agents are healthy. NOTE: When reloading the NDPS Manager after converting printer agents you may see some Printer Agents who's state is not bound. If you have any printer agents on the server whose state is "Not Bound", shut down and restart that printer agent. This can be done from iManager or from the NDPS Manager console on the file server. The printer agent should load without errors. Subsequent loading of the NDPS Manager should bring all Printer Agents on line without errors. 9.) After verifying that everything is OK back up the NDPS Manager's MOD database to preserve the new gateway settings. 10.) <<<< Remember >>>>, if you ever want to back out the changes made by this tool you need to manually copy the PSMDBSAV.DAT and PSMDBSAV.IDX files to your own backup directory << BEFORE >> you run this tool. ======================== BACKOUT PROCEDURES: <<<< NOTE >>>> If you want to back out the migration changes made by this tool, you will need to complete the following steps: 1.) If the NDPS Manager is currently running, unload it. 2.) From the \\[PSM Host Volume]\NDPS\[SOME-RANDOM-NUMBER].PSM directory, delete or rename the PSMDB.DAT and PSMDB.IDX files. These files are marked as transactional. You will need to remove the transactional setting from those files before you will be able to delete those files. 3.) Copy the PSMDBSAV.DAT and PSMDBSAV.IDX files that you previously saved in step 2.) from your backup directory to the \\[PSM HostVolume]\NDPS\[SOME-RANDOM-NUMBER].PSM directory and rename them to PSMDB.DAT and PSMDB.IDX. 4.) Load NDPSM.NLM. << NOTE >> The backup database is a snapshot of printer agents at the time the backup was made. If you have deleted or created printer agents since making the change to the Novell gateway, those printer agent changes will NOT be included. If you have added printers, you will need to recreate those printer agents. If you have deleted printer agents, you will need to delete those printer agents again. ISSUE: Please send feedback regarding this utility or this readme (positive or negative) to: patchfeedback@novell.com. Use PAcvrt2g.exe as the subject of the message. Your detailed comments are appreciated. TID 10095744: PAcvrt.exe truncates the conversion of long DNS printer names TID 10097128: Converting from HP Gateway to Novell SNMP Gateway the port number is always converted to "Passthrough". Self-Extracting File Name: pacvrt2g.exe Files Included Size Date Time ..\ PACVRT2G.TXT (This file) DPAWIN32.DLL 65536 8-5-2002 5:36:32 pm DPLWIN32.DLL 114688 8-5-2002 5:36:32 pm DPPWIN32.DLL 110592 8-5-2002 5:36:32 pm DPSWIN32.DLL 86016 8-5-2002 5:36:32 pm PACVRT.EXE 486912 5-18-2005 1:22:22 pm ----------------------------------------------------------------- Any trademarks referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information. -----------------------------------------------------------------