4343-PS012-03 NDPS Gateway 2.
Foreword Welcome NDPS Gateway is software that controls devices and print jobs and checks their status in an NDPS (Novell Distributed Print Services) environment, the newest printing system by Novell, Inc. NDPS Gateway provides the following: • Printer Agent configuration • Device control snap-in functionality • NDPS gateway server capabilities Trademark Acknowledgements Ethernet is a registered trademark of Xerox Corporation.
Foreword Screen images shown in this manual may differ slightly from actual ones. Specifications are subject to change without prior notice.
Contents CONTENTS 1 Overview ............................................................ 1 1.1 Features .................................................................... 1 1.2 Supported Platforms ............................................... 2 1.3 Supported Language ............................................... 2 2 Installation ......................................................... 3 2.1 Installing NDPS ........................................................ 3 2.2 Installing NDPS Gateway .....
Contents 4.5 NDPS Printer Gateway Operation ......................... 22 5 NDPS Printer Snap-In Operation .................... 23 5.1 Printer Details Button ............................................ 24 5.1.1 5.1.2 5.1.3 5.1.4 5.1.5 Identification .................................................................24 Feature ..........................................................................25 Status ............................................................................25 Set Defaults ........
Contents 7 Troubleshooting ............................................... 35 7.1 Troubleshooting the NDPS Printer Configuration Module ............................................ 35 7.1.1 Why does the “Authentication failed” message appear? .........................................................35 7.1.2 Why is a particular printer not found in the “Discovered Printers” list? ...............................35 7.2 Troubleshooting the NDPS Printer Gateway Module ..........................................
Contents vi
1 Overview 1 Overview 1.1 Features • NDPS (Novell Distributed Print Services) printing to supported printer models is provided. • Supported devices on an IP network can be detected, and a list for user selection is provided. • Events can be detected, and messages to users can be generated. • NDPS Gateway accesses devices using SNMP (Simple Network Management Protocol) and displays front panel messages and the status of the devices.
1 Overview 1.2 Supported Platforms Environment of server where NDPS Gateway will run The newest Service Pack must be installed, and use of IP must be possible. • NetWare 5 • NetWare 5.1 • NetWare 6 • NetWare 6.5 NDPS • NDPS 2.0 or later Snap-in environment • • • • • • Novell client • For Windows 95/98, NetWare Client v3.32 or later • For Windows NT/2000/XP, NetWare Client v4.83 or later Client Web browser • Internet Explorer 4.0 or later • Netscape 4.
2 Installation 2 Installation This section describes how to install NDPS Gateway, which is composed of different parts. The gateway component provides NDPS service to NDPS clients for non-NDPS printers. The control snap-in utility manages the Printer Agents. Additionally, the configuration utility allows you to configure the NDPS Printer Agents. 2.1 Installing NDPS The NDPS Gateway is added to the Novell NDPS. Therefore, the first step is to install NDPS. 1. When installing NetWare 5.x or 6.
2 Installation 2.2 Installing NDPS Gateway NDPS Gateway will be installed onto a NetWare server from Windows. Note • Before installation, be sure that you are connected to the NetWare server onto which NDPS Gateway will be installed, or that you are logged on with administrator privileges. • Before upgrading NDPS Gateway to a newer version, perform the following two operations. ⋅ Quit NDPS Gateway. ⋅ Then, quit NWADMIN32.
2 Installation • Authenticated NetWare Servers: A list of NetWare servers that are logged in is displayed. • Unauthenticated NetWare Servers: A list of NetWare servers that are connected but not logged in is displayed. 4. From either the “Authenticated NetWare Servers” or the “Unauthenticated NetWare Servers” list, select the server where NDPS Gateway will be installed. 5. To change the installation location to a folder other than that shown in “Destination Folder”, click the [Browse] button.
3 Printer Agent Configuration 3 Printer Agent Configuration Each NetWare printer is represented by an NDPS (Novell Distributed Print Services) Printer Agent. The NDPS client submits a print job to the NDPS Printer Agent. The NDPS PSM (Print Service Manager) passes the job to the gateway, which submits the job to the NetWare printer for printing. In an NDPS environment, users can configure a device as a Public Access Printer or as a Controlled Access Printer.
3 Printer Agent Configuration Controlled Access Printer A Controlled Access Printer enables you to assign NDS privileges for controlling which users can see, use, and manage this device. To configure a Controlled Access Printer, you can simply create an NDPS printer object to represent the device. The newly created NDPS printer object will appear in the NWADMIN utility’s NDS browser. As with other NDS objects, a Controlled Access Printer offers a full range of security options.
3 Printer Agent Configuration 2. Select “Printer Agent List” from the column at the right, and then click the [New] button to create the Printer Agent. The Create Printer Agent dialog appears. (This dialog is the same as that displayed when creating a Controlled Access Printer, as described below.) 3. Enter the Printer Agent name (e.g., PA1) in the “Printer Agent (PA) Name” box. 4. From the list, according to the syntax “NDPS_Manager_Name.
3 Printer Agent Configuration 3.1.2 For a Controlled Access Printer 1. From the NetWare Administrator dialog, select the context under which the Printer Agent is created in this NDS container (e.g., “CONTEXT_99”). 2. From the “Object” menu, select “Create”. The New Object dialog appears. 3. Select “NDPS Printer”, and then click the [OK] button. The Create NDPS Printer dialog appears.
3 Printer Agent Configuration 4. Enter the Printer Agent name (e.g., PA1) into the “NDPS Printer Name” box. 5. Select “Create a New Printer Agent” under “Printer Agent Source”, and then click the [Create] button. The Create Printer Agent dialog appears. 6. Enter the Printer Agent name (e.g., PA1) into the “Printer Agent (PA) Name” box. 7. From the list, according to the syntax “NDPS_Manager_Name.Context_Name”, select the NDPS manager started up from the server console. 8.
3 Printer Agent Configuration 3.2 Configuring a Printer Agent When creating either a Public Access Printer or a Controlled Access Printer, the same Create Printer Agent dialog appears. After completing the dialog, the NDPS Gateway dialog appears. A list of device names and their corresponding IP address is displayed in the NDPS Gateway dialog. Note • To detect devices located in other subnets, click the [Advanced] button. Refer to section 3.4 for details.
3 Printer Agent Configuration 1. From the list, select the device assigned to the Printer Agent, and then click the [Finish] button. The LPR Settings dialog appears, allowing you to select the name of the LPD queue for the selected device. 2. From the list, select the name of the LPD queue to be used, and then click the [OK] button. In the dialog that appears, asking for confirmation, click the [OK] button. A dialog appears, allowing you to select the printer driver for the selected device. 3.
3 Printer Agent Configuration 3.3 Manually Adding a Device Click the [Add Device] button to add other devices that cannot be or have not been automatically detected by the configuration utility. This is useful when you have defined a small network coverage for device detection (e.g., hop count = 0), but you want to configure a distant device. 1. Click the [Add Device] button in the NDPS Gateway dialog. The Add Device dialog appears. 2. Enter the IP address, and then click the [OK] button.
3 Printer Agent Configuration 3.4 Device Detection Settings After clicking the [Advanced] button, various settings can be made to specify the location in which devices are detected. On the “Default Setting” tab of the Advanced dialog, you can change the following two settings: • SNMP Community Setting: You can select a different read community (usually specified as “public”), which is used for communicating with printing devices.
3 Printer Agent Configuration Specifying a searched subnet In the following cases, the location in which devices are searched for should be specified. • If the device is in a location that requires many routers (more than 10 hops) to be transversed • When you wish to use a device that is far from the local subnet • When a larger maximum number of hops results in the list containing many devices • If too many broadcast packets will be sent into the network, resulting in increased network traffic 1.
3 Printer Agent Configuration 3. Click the [Add] button. The Add Subnet dialog appears. 4. In the “IP Address” box, enter the address of the subnet to be added. In the “Subnet Mask” box, enter the subnet mask, and then click the [OK] button. Later, if any devices are found in that specified subnet, they will be added to the list of detected devices in the NDPS Gateway dialog.
4 NDPS User Interface 4 NDPS User Interface This section walks through all the screens that an NDPS user encounters. 4.1 NDPS Printer Manager The NDPS Printer Manager is the major utility that NDPS clients can use to configure and monitor their NDPS printing environment. Note The NDPS Printer Manager is available only with NetWare 5.x. 1. For a Windows 95, 98 or NT client, run “NWPMW32.EXE”, located at “SYS:\PUBLIC\WIN32”, to start up the NDPS Printer Manager.
4 NDPS User Interface The status of the devices are indicated in real time. All NDPS status defined by Novell will be supported. Some of the supported event types can be found in the following dialog. This dialog shows the two types of events: the print job events and the printer events. The print job events are not directly controlled by NDPS Gateway. NDPS Gateway interacts with the NDPS Printer Agent, which could result in various print jobs events.
4 NDPS User Interface 4.2 Installing a Printer Device for a Printer Agent In this dialog, you can select, deselect and configure NDPS printers from client computers. The “Available Printers” box lists all the NDPS printers that have been registered in NDPS. The NDPS printer registration can be performed either based on a program or manually. The Printer Agent lists for the NDPS manager can be modified via NWADMIN (dialog on page 7) or through a C-Worthy interface on the server. Start up “NDPSM.
4 NDPS User Interface NDPS users could select a device from either the “Installed Printers” box or the “Available Printers” box, then click [Printer Information] to display the details of the printer configuration and its real time status. Notice that the user machine is not required to have the printer driver installed in order to see them. NDPS printers support multiple configurations.
4 NDPS User Interface 4.3 NDPS Job Manager The job list of a device can be displayed by double-clicking the device in the printer list of the Novell Printer Manager main screen. The job status basically shows the current state of the Printer Agent. The details of the print job can be displayed by double-clicking the print job. All NDPS job and document attributes defined in NDPS MOD are provided. New job and document attributes will not be added.
4 NDPS User Interface 4.5 NDPS Printer Gateway Operation The operation of the NDPS network requires the coordination of many components. For detailed explanations of NDPS operation, read the Novell NDPS architecture documents and relevant user manuals. This document focuses on the operation of the NDPS Gateway and its snapin program.
5 NDPS Printer Snap-In Operation 5 NDPS Printer Snap-In Operation The snap-in program is started up differently for Controlled Access Printers and Public Access Printers. For Public Access Printers, select “Tools” from the main menu bar, and then click “View NDPS Public Printers”. A box containing a list of all Public Access Printers is displayed. Double-clicking the desired device will start up the snap-in program, shown below.
5 NDPS Printer Snap-In Operation 5.1 Printer Details Button Clicking this button displays a menu listing five available commands: Identification, Feature, Status, Set Defaults and About. 5.1.1 Identification Click this command to display the Novell-defined Identification dialog. It shows the NDPS manager that manages the Printer Agent, the printer manufacturer, model name, printer control DLL name, etc.
5 NDPS Printer Snap-In Operation 5.1.2 Feature Click this command to display the Novell-defined Features dialog, which shows information for supported document formats, duplexing, maximum resolution, printing mechanisms, maximum printing speed and the memory size of the device. 5.1.3 Status When the device encounters problems, the Printer Status dialog reports the related details, such as the event time, event name, location where the event occurred, etc.
5 NDPS Printer Snap-In Operation 5.1.4 Set Defaults Click this command to display the Novell-defined Printer Defaults dialog, which allows the user to configure the default behavior of the devices, such as, the copy count and banner page settings. 5.1.5 About Click this command to display the current version of the NDPS Gateway.
5 NDPS Printer Snap-In Operation 5.2 I/O Info Button Clicking this button displays a menu, allowing you to see information for the selected paper supply trays and paper output trays for the device. 5.2.1 Input Summary This summary gives the device tray names, maximum capacity, paper level, paper size and orientation. Input Configuration Select one of the input trays listed, and then click the [Detail] button to view the tray details.
5 NDPS Printer Snap-In Operation 5.2.2 Output Summary This summary gives output tray information, including the tray name, tray type, unit dimensions and maximum capacity. Output Configuration Select one of the output trays listed, and then click the [Detail] button to view the tray details. You can also double-click one of the output trays listed to view its details.
5 NDPS Printer Snap-In Operation 5.3 Job Info Button Clicking this button displays a menu listing two available commands: Job List and Spooling. Click the “Job List” command to manage the print jobs (move, copy or delete them). Click the “Spooling” command to configure the spooling settings of the Printer Agent.
5 NDPS Printer Snap-In Operation 5.4 Enable/Disable Input Button Clicking this button pauses or resumes spooling (input). When spooling is paused, new print jobs sent from client’s machines are temporarily not accepted. 5.5 Pause/Resume Output Button Clicking this button pauses or resumes printing (output). When printing is paused, printing of jobs is temporarily stopped. 5.6 Polling Setting Button Clicking this button allows the time interval between each status polling to be configured.
5 NDPS Printer Snap-In Operation 5.7 Troubleshooting Button The current printer events are displayed in the order of their severity. In the snap-in dialog, an error icon appears at the point in the device where the error occurred. The icon that appears differs depending on the severity of the error.
5 NDPS Printer Snap-In Operation 5.8 Control Panel Displays The snap-in dialog displays messages showing the device status, such as when it is printing and warming up, or other alert messages. If there is more than one event to be reported, only the most critical and the most recent one will be shown. 5.9 Linking to Web Connection By clicking the Web Connection logo, the default Web browser is started up, and Enbeded Web Page for the currently displayed device appears.
6 NDPS Gateway Server Capabilities 6 NDPS Gateway Server Capabilities With NDPS Gateway on a NetWare server, NDPS Gateway can be set and the device can be observed and controlled. When “Minogegw.nlm” is started up on the NetWare server, the following screen appears. 6.1 Printer List If “Printer List” is selected from the NDPS Gateway screen, a list of Printer Agents that are controlled by NDPS Gateway appears.
6 NDPS Gateway Server Capabilities 6.2 Specifying Printer Settings Select a Printer Agent from the List of Printers screen, and then press the [Enter] key to display a screen containing the available printer settings. • Polling Sleep Time: Specify the length of time (in seconds) for the NDPS Gateway server to acquire the printer information. The default setting is 30 seconds. • Polling Retries: Specify the number of times to retry after a timeout has occurred while accessing the device.
7 Troubleshooting 7 Troubleshooting The programs should work properly if the procedures described above are followed. Nevertheless, something unexpected could cause them to fail to operate normally. This chapter explains how to diagnose any problems. 7.1 Troubleshooting the NDPS Printer Configuration Module 7.1.1 Why does the “Authentication failed” message appear? This occurs only with the QMS (Queue Management Services) port handler.
7 Troubleshooting • Device is not in “Ready” mode — After the device is turned on, it needs some time for initialization. Use the “ping” command to verify the current state of the device. 7.2 Troubleshooting the NDPS Printer Gateway Module 7.2.1 Why is an NDPS Printer Agent in the “Not Bound” state? The NDPS Printer Agent cannot be initialized for some reason. Press the [ENTER] key to bring up the screen, and then select “Shutdown Printer”. Next, press [ENTER] again, and then select “Startup Printer”.
7 Troubleshooting 7.2.2 Why is an NDPS Printer Agent in the “Needs Attention” state? The device has uncorrected problems at that time. Press [ENTER] to look at its details screen. Press [ENTER] in the status field to list all that device’s problems that are uncorrected. The state will be reset to idle after all of the problems are cleared. If the Printer Agent remains in the “Needs Attention” state for a long period of time, you should go to investigate the error.
7 Troubleshooting 7.3 Troubleshooting the NDPS Printer Control Snap-In Module 7.3.1 Why is the Novell Printer Control snap-in opened for a Device? It is likely that the “MltgCtrl.pc2” file is not copied to the right directory. Since it was not found, the Novell printer control snap-in was opened by default. Copy “MltgCtrl.pc2” to the “SYS:\PUBLIC\WIN32” directory. 7.3.2 Why can a screen not be opened? This usually occurs when a message box containing a number appears. 7.3.
7 Troubleshooting 7.4 Troubleshooting the NDPS Module 7.4.1 Why does an event not generate the pop-up or log message on the client machine? First, be sure to check the events. Select the Printer Agent in the NDPS Printer Manager, select “Configuration” and select “Notification”. There are different icons for different notification mechanisms. You will see at least two, the log and pop-up. Make sure that the events are properly set for each notification method.
2005.