HP Web Jetadmin Proxy Agents Readme

HP Web Jetadmin Proxy Agents Readme
HP Web Jetadmin Proxy Agents
Readme
Copyright and License
Trademark Credits
© 2014 Copyright Hewlett-Packard
Development Company, L.P.
Adobe®, Acrobat®, and PostScript® are
trademarks of Adobe Systems Incorporated.
Reproduction, adaptation, or translation
without prior written permission is prohibited,
except as allowed under the copyright laws.
Apple and the Apple logo are trademarks of
Apple Computer, Inc., registered in the U.S. and
other countries. iPod is a trademark of Apple
Computer, Inc. iPod is for legal or rightholderauthorized copying only. Don't steal music.
The information contained herein is subject to
change without notice.
The only warranties for HP products and
services are set forth in the express warranty
statements accompanying such products and
services. Nothing herein should be construed
as constituting an additional warranty. HP shall
not be liable for technical or editorial errors or
omissions contained herein.
c01840757
Edition 14, 5/2014
Microsoft®, Windows®, Windows® XP, and
Windows Vista® are U.S. registered trademarks
of Microsoft Corporation.
Table of contents
1 Proxy agents ................................................................................................................................................. 1
2 HP SNMP Proxy Agent 10.3.0010 ..................................................................................................................... 2
Features ................................................................................................................................................................. 2
System requirements ............................................................................................................................................ 2
Install HP SNMP Proxy Agent ................................................................................................................................. 3
Standalone installation ....................................................................................................................... 4
Silent installation/network installation ............................................................................................. 4
Error logging .......................................................................................................................................................... 5
Supported devices ................................................................................................................................................. 5
Questions and answers ......................................................................................................................................... 5
Revision history (partial) ....................................................................................................................................... 6
3 HP WS Pro Proxy Agent 10.3.6 ........................................................................................................................ 7
System requirements ............................................................................................................................................ 7
Install HP WS Pro Proxy Agent .............................................................................................................................. 8
Standalone installation ....................................................................................................................... 8
Silent installation ................................................................................................................................ 9
Install HP WS Pro Proxy Agent with User Account Control enabled .................................................. 9
Error logging .......................................................................................................................................................... 9
Configure the HP WS Pro Proxy Agent service behind a firewall .......................................................................... 9
Supported devices ............................................................................................................................................... 10
Questions and answers ....................................................................................................................................... 10
Revision history (partial) ..................................................................................................................................... 11
ENWW
iii
iv
ENWW
1
Proxy agents
NOTE: The most current version of this Readme is available from the HP Support Center.
A proxy agent is client-side software that allows HP Web Jetadmin to discover and manage devices that are
connected directly to the network. The proxy agent is capable of passing the same types of queries to PCconnected devices that are typically passed to network-connected devices. Therefore, HP Web Jetadmin can
gather additional device information about PC-connected devices, such as remaining toner levels, page
counts, and status.
HP provides the following proxy agents:
●
HP SNMP Proxy Agent works by exposing object identifiers (OIDs) in the printer management
information base (MIB) to the Microsoft® SNMP service that runs on the host PC where the device is
connected through a USB port.
●
HP WS Pro Proxy Agent is a Web service that runs under the network service account on a PC
workstation and replicates a device's services from the host computer's USB interface to its network
interface.
While most devices support HP SNMP Proxy Agent, a few devices require HP WS Pro Proxy Agent.
The HP Proxy Agents package includes the following:
●
HP SNMP Proxy Agent—Separate MSI installers for the 32-bit and 64-bit operating systems
●
HP WS Pro Proxy Agent—A single MSI installer for both the 32-bit and 64-bit operating systems
To download the HP Proxy Agents package, go to www.hp.com/go/webjetadmin, click Download Now, and
then follow the instructions.
As a general rule, you should install both HP SNMP Proxy Agent and HP WS Pro Proxy Agent. However, be
aware that there are a few devices that HP Web Jetadmin can discover through both HP SNMP Proxy Agent
and HP WS Pro Proxy Agent. If you install both proxy agents on a machine where HP Web Jetadmin discovers
one of these devices, the device appears in the device list twice.
For more information about the proxy agents, see the Discovering PC-Connected Devices in HP Web Jetadmin
white paper. This white paper is available from the HP Support Center.
ENWW
1
2
HP SNMP Proxy Agent 10.3.0010
●
Features
●
System requirements
●
Install HP SNMP Proxy Agent
●
Error logging
●
Supported devices
●
Questions and answers
●
Revision history (partial)
HP SNMP Proxy Agent is installed on a desktop client PC. HP Web Jetadmin uses HP SNMP Proxy Agent to
discover and manage HP printers and scanners that are connected locally (for example, through a USB
connection). HP SNMP Proxy Agent exposes management objects through the Microsoft SNMP service on the
client PC. In HP Web Jetadmin, a simple PC-connected discovery finds the locally attached devices.
HP Web Jetadmin can then gather additional device information—such as remaining toner levels, page
counts, and status—through the proxy.
Features
HP SNMP Proxy Agent includes the following functionality:
●
HP Web Jetadmin queries the HP-proprietary and standard management objects in the supported
devices. Different devices offer varying levels of support, but many devices expose the model name,
engine page count, supplies levels, serial number, and so on.
●
HP Web Jetadmin supports reading and writing information on PC-connected devices.
●
HP Web Jetadmin detects status changes in a PC-connected device by polling or manually refreshing the
device. HP Web Jetadmin does not support traps for PC-connected devices.
●
A discovery must complete successfully before a PC-connected device is available in HP Web Jetadmin.
●
HP SNMP Proxy Agent and HP Web Jetadmin support multiple PC-connected devices (for example,
through a USB connection) on a single desktop client PC.
●
HP SNMP Proxy Agent adds support for some HP Officejet Pro devices through the HP Officejet Basic
Driver - IT Professional Use Only driver package.
●
HP Web Jetadmin can perform a PC-connected discovery by using the IP broadcast method.
HP Web Jetadmin uses an SNMP query for the IP broadcast packet. However, this discovery method
yields limited results because some systems and many networks block IP broadcast traffic for security
and overall management reasons. The workstation or server that HP Web Jetadmin sends the IP
broadcast to must have an SNMP service that responds to these packets. For a comprehensive and
scaled discovery plan, HP recommends that you also use other discovery methods, such as IP range and
Specified addresses.
System requirements
HP SNMP Proxy Agent is supported on the following Microsoft operating systems:
2
Chapter 2 HP SNMP Proxy Agent 10.3.0010
ENWW
●
Windows XP Professional (x86)
●
Windows XP Professional x64 Edition
●
Windows Vista Business (x86)
●
Windows Vista Business (x64)
●
Windows 7 Professional SP1 (x86)
●
Windows 7 Professional SP1 (x64)
●
Windows 8 Enterprise (x86)
●
Windows 8 Enterprise (x64)
●
Windows 8.1 Enterprise (x86)
●
Windows 8.1 Enterprise (x64)
●
Windows Server 2003 Standard Edition
●
Windows Server 2003 Standard x64 Edition
●
Windows Server 2008 Standard (x86)
●
Windows Server 2008 Standard (x64)
●
Windows Server 2008 R2 (x64)
●
Windows Server 2008 R2 SP1
●
Windows Server 2012
●
Windows Server 2012 R2
To allow queries from the HP Web Jetadmin server, the Windows SNMP service must be installed, configured,
and running as follows:
●
Configure the SNMP service Properties so that Accepted community names includes public with READ
ONLY rights.
●
Enable a configuration so that it can be modified by choosing and configuring a READ WRITE community
name.
●
Configure the SNMP service Properties to Accept SNMP packets from any host or from
HP Web Jetadmin.
NOTE: Microsoft does not include the SNMP service with the Home editions of Windows. The exact
mechanism for installing the SNMP service varies depending on the Windows version. In Windows 7, go to
Control Panel > Programs and Features, click Turn Windows features on or off on the sidebar, and then
enable the Simple Network Management Protocol (SNMP) feature.
Firewall settings must permit HP Web Jetadmin to query the proxy agent using SNMP. UDP port 161 should
be open.
NOTE: Not all versions of Windows automatically enable UDP port 161 when you install the SNMP service. If
the SNMP service is running, but cannot be accessed from a remote machine, the firewall on the PC might be
blocking SNMP traffic.
Install HP SNMP Proxy Agent
●
ENWW
Standalone installation
Install HP SNMP Proxy Agent
3
●
Silent installation/network installation
You must install the Microsoft SNMP service prior to installing HP SNMP Proxy Agent. You can install HP SNMP
Proxy Agent either before or after you install the HP printer driver.
Two installation modes are available through standard tools such as Microsoft Systems Management Server
(SMS)—standalone mode and silent/network mode.
Standalone installation
The standard (non-silent) installation takes input in the form of responses to dialog boxes. To initiate a
standalone installation of HP SNMP Proxy Agent, run one of the following commands:
●
Msiexec /i "HP SNMP Proxy_32_10_3_0010.msi"
●
Msiexec /i "HP SNMP Proxy_64_10_3_0010.msi"
The installer then guides you through a series of dialogs.
Silent installation/network installation
The silent mode (without a UI) is provided for push-based installations. To initiate a silent installation of
HP SNMP Proxy Agent, run one of the following commands:
●
Msiexec /i "HP SNMP Proxy_32_10_3_0010.msi" /qn
●
Msiexec /i "HP SNMP Proxy_64_10_3_0010.msi" /qn
The following switches are also available with this installer:
●
/s
Executes a silent extraction of the packaged binaries on the client system.
●
/qn
Executes the MSI in silent mode. Specifying /s applies this setting.
●
/i
Installs the package.
●
/fv
Ugrades an existing package.
●
/x
Uninstalls an existing package.
●
PERMITTEDMANAGERS="ipaddress1;ipaddress2;...;ipaddressn"
Sets up the SNMP service to respond to requests only from the specified IP addresses. This parameter is
used from the command line. An empty string, such as PERMITTEDMANAGERS="", removes all
existing entries that the proxy installer previously made. A value of "*" indicates that the SNMP service
should be able to receive values from any server.
●
VALIDCOMMUNITIES="communityname1;communityname2;...communitynamen"
Sets up the SNMP service to respond only to servers that send a request with one of the specified
community names. This parameter is used from the command line.
4
Chapter 2 HP SNMP Proxy Agent 10.3.0010
ENWW
Error logging
By default, the installer creates the snmpprinst.log file in the Windows folder. This is a hardcoded aspect of
the installer and currently cannot be overridden.
Supported devices
For a complete list of the devices that can be discovered with HP SNMP Proxy Agent, see the Discovering PCconnected Devices in HP Web Jetadmin white paper. This white paper is available from the HP Support Center.
Questions and answers
Question
Answer
Why does HP Web Jetadmin fail to discover
my locally attached device?
The following troubleshooting steps might help analyze this problem:
●
On the HP Web Jetadmin server, verify basic network connectivity with the PC
client. Substitute the IPv4 address of the client PC for IPAddr in the following
command:
ping IPAddr
●
On the HP Web Jetadmin server, use a third-party tool, such as Net-SNMP
snmpget, to verify a successfully installed, configured, and running SNMP service
and firewall on the client PC. Substitute the IPv4 address of the client PC for
IPAddr in the following command:
snmpget -v1 -c public IPAddr 1.3.6.1.2.1.1.1.0
●
On the HP Web Jetadmin server, use a third-party tool, such as Net-SNMP
snmpget. Substitute the IPv4 address of the client PC for IPAddr in the following
command:
snmpget -v1 –c public IPAddr 1.3.6.1.4.1.11.2.4.3.13.1.0
If SNMP and the proxy agent are functioning, the proxy agent responds with an
INTEGER value greater than zero. If the proxy agent has not been successfully
installed, the response is NO SUCH NAME.
●
The following registry key identifies the proxied devices on the client PC:
HKLM\SOFTWARE\Hewlett-Packard\HP SNMP Proxy\PrnId
If the device does not appear in this list, restart the SNMP service or reboot the PC.
If the device is installed, powered on, and working (for example, you can print to it),
but the device still does not appear in this list, the device's driver might not
implement an enterprise device management interface.
After I run a PC-connected discovery and
the locally attached devices are
discovered, how do I know which devices
are PC-connected devices?
Discovered PC-connected devices are displayed in the device lists with the networkconnected devices.
To display a device list that includes only those devices that were discovered as PCconnected devices, enable a filter. Go to View > Preferences, select Device Filters,
double-click PC-Connected Devices, and then click OK.
To display the PC Connected column, which identifies the devices that are PC-connected,
on any device list, display the device list, right-click in a column header, and then select
Customize. In the Select Columns wizard, select All from the Category list, double-click
PC Connected in the Available Columns list, and then click OK.
Can I generate reports about my locally
attached devices by using the
HP Web Jetadmin Reports feature?
ENWW
Yes. Reports about PC-connected devices should be possible. However, the data that
HP Web Jetadmin can collect differs from device to device.
Error logging
5
Question
Answer
What happens when the IP address of the
client PC changes?
HP Web Jetadmin finds the proxied devices on the new IP address during the next
successful discovery.
Can I use any version of HP Web Jetadmin
to manage PC-connected devices?
HP SNMP Proxy Agent requires HP Web Jetadmin 10.2 or later for full functionality.
Revision history (partial)
The following table provides a partial history of the improvements and fixes made for HP SNMP Proxy Agent.
Table 2-1 Revision history for HP SNMP Proxy Agent (partial)
Proxy version
Release date
Improvements and fixes
10.3.0010
HP Web Jetadmin 10.3 SR1 (10.3.85669)
●
26-November-2012
Updated HP SNMP Proxy Agent to use the latest
language monitor DLL in HP Universal Print Driver
(UPD) 5.6 or later.
If UPD 5.6 or later is used, HP SNMP Proxy Agent
10.3.0010 is required to display the toner levels.
6
Chapter 2 HP SNMP Proxy Agent 10.3.0010
ENWW
3
HP WS Pro Proxy Agent 10.3.6
●
System requirements
●
Install HP WS Pro Proxy Agent
●
Error logging
●
Configure the HP WS Pro Proxy Agent service behind a firewall
●
Supported devices
●
Questions and answers
●
Revision history (partial)
HP WS Pro Proxy Agent supports HP printers that use Web services to communicate with HP Web Jetadmin
and do not support enough of SNMP for HP SNMP Proxy Agent to discover them. HP WS Pro Proxy Agent runs
under the less-privileged network service account when it is installed on workstations.
System requirements
HP WS Pro Proxy Agent is supported on the following Microsoft operating systems:
ENWW
●
Windows XP Professional (x86)
●
Windows XP Professional x64 Edition
●
Windows Vista Business (x86)
●
Windows Vista Business (x64)
●
Windows 7 Professional SP1 (x86)
●
Windows 7 Professional SP1 (x64)
●
Windows 8 Enterprise (x86)
●
Windows 8 Enterprise (x64)
●
Windows 8.1 Enterprise (x86)
●
Windows 8.1 Enterprise (x64)
●
Windows Server 2003 Standard Edition
●
Windows Server 2003 Standard x64 Edition
●
Windows Server 2008 Standard (x86)
●
Windows Server 2008 Standard (x64)
●
Windows Server 2008 R2 (x64)
●
Windows Server 2008 R2 SP1
●
Windows Server 2012
●
Windows Server 2012 R2
System requirements
7
NOTE: If User Account Control (UAC) is enabled on the Windows client, you must run the installation for
HP WS Pro Proxy Agent as an administrator.
HP WS Pro Proxy Agent requires Microsoft .NET Framework 4.0. The installer verifies that the correct version
is installed.
Install HP WS Pro Proxy Agent
●
Standalone installation
●
Silent installation
●
Install HP WS Pro Proxy Agent with User Account Control enabled
Two installation modes are available through standard tools such as Microsoft Systems Management Server
(SMS)—standalone mode and silent mode.
Standalone installation
To initiate a standalone installation of HP WS Pro Proxy Agent, run the following command:
Msiexec /i HPWSProxyService_10_3_6.msi WJAHOSTIP=xxx.xxx.xxx.xxx
WJADISCOVERYPORT=xxxxx LEDMDISCOVERYPORT=xxxxx
CAUTION: The installer does not support the /a switch on the command line. If you use the /a switch, the
installation fails.
●
WJAHOSTIP=xxx.xxx.xxx.xxx
Optional. The host IP address of the HP Web Jetadmin server where HP WS Pro Proxy Agent sends WS
Probe Hello packets when the service starts and when the service detects that the host machine has
changed IP addresses. This parameter keeps PC-connected devices up-to-date in HP Web Jetadmin
device lists without requiring another discovery. If this parameter is not specified, the HP Web Jetadmin
host IP address is not configured for HP WS Pro Proxy Agent to use.
●
WJADISCOVERYPORT=xxxxx
Optional. The port where HP WS Pro Proxy Agent sends WS Probe Hello packets. The port specified for
this parameter must be the same as the port on which HP Web Jetadmin is configured to listen for PC
connect WS Hello messages. The default is port 27893.
●
LEDMDISCOVERYPORT=xxxxx
Optional. The UDP port on which HP WS Pro Proxy Agent listens for discovery probe requests. The port
specified for this parameter must be the same as the port on which HP Web Jetadmin is configured to
send PC connect WS probes. The default is port 27893.
The following are examples of the standalone installation command:
●
To install HP WS Pro Proxy Agent with the default values for the optional parameters, enter the
following command:
msiexec /i HPWSProxyService_10_3_6.msi
●
To install HP WS Pro Proxy Agent by specifying values for the optional parameters, enter the following
command:
msiexec /i HPWSProxyService_10_3_6.msi WJAHOSTIP=1.2.3.4
WJADISCOVERYPORT=27893 LEDMDISCOVERYPORT=27893
The installer then guides you through a series of dialogs.
8
Chapter 3 HP WS Pro Proxy Agent 10.3.6
ENWW
Silent installation
The silent mode (without a UI) is provided for push-based installations. To initiate a silent installation of
HP WS Pro Proxy Agent, run the following command:
msiexec /i HPWSProxyService_10_3_6.msi /quiet HPWSProxyService_10_3_6.msi
WJAHOSTIP=xxx.xxx.xxx.xxx WJADISCOVERYPORT=xxxxx LEDMDISCOVERYPORT=xxxxx
CAUTION: The installer does not support the /a switch on the command line. If you use the /a switch, the
installation fails.
The optional parameters are the same as described in Standalone installation on page 8.
The following are examples of the silent installation command:
●
To install HP WS Pro Proxy Agent with the default values for the optional parameters, enter the
following command:
msiexec /i HPWSProxyService_10_3_6.msi /quiet
●
To install HP WS Pro Proxy Agent by specifying values for the optional parameters, enter the following
command:
msiexec /i HPWSProxyService_10_3_6.msi /quiet WJAHOSTIP=1.2.3.4
WJADISCOVERYPORT=27893 LEDMDISCOVERYPORT=27893
Install HP WS Pro Proxy Agent with User Account Control enabled
If User Account Control (UAC) is enabled, you must run the installation command from the elevated
(administrator) Command Prompt.
Error logging
HP WS Pro Proxy Agent logs errors during execution. The log file is located in one of the following directories:
●
On a 32-bit operating system:
C:\Program Files\Hewlett-Packard Company\HPWSProxy\HPWSProxy\bin\
●
On a 64-bit operating system:
C:\Program Files (x86)\Hewlett-Packard Company\HPWSProxy\HPWSProxy\bin\
Configure the HP WS Pro Proxy Agent service behind a firewall
For the HP WS Pro Proxy Agent service to work behind a firewall, you must add the proxy service and/or the
ports the proxy service uses to the firewall exception list. The proxy service uses two TCP ports for HTTP or
HTTPS communication with HP Web Jetadmin and one UDP port for discovery.
NOTE: At this time, the two TCP ports are dynamic. The HP WS Pro Proxy Agent service requests the two
TCP ports on the first startup.
To add the proxy service and its ports to the firewall exception list, perform the following steps:
1.
Add the HPDeviceProxyService.exe file from the proxy installation directory to the firewall exception
list. The HPDeviceProxyService.exe file is located in one of the following directories:
●
ENWW
For a default installation on a 32-bit operating system:
Error logging
9
C:\Program Files\Hewlett-Packard Company\HPWSProxy\HPWSProxy\bin\
●
For a default installation on a 64-bit operating system:
C:\Program Files (x86)\Hewlett-Packard Company\HPWSProxy\HPWSProxy\bin\
NOTE: In many cases, adding an exception or rule to the firewall to allow a specific service also allows
an HP Web Jetadmin discovery to take place. If the additional step of adding ports is required, proceed
to step 2.
2.
Add the TCP and UDP ports that the HP WS Pro Proxy Agent service uses to the firewall exception list.
The TCP and UDP port numbers are defined in the following registry entries:
●
For a 32-bit operating system:
HKEY_LOCAL_MACHINE\SOFTWARE\Hewlett-Packard\HPLedmProxyAgent
●
For a 64-bit operating system:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Hewlett-Packard\HPLedmProxyAgent
The values of Port and WSTransferPort must be added to the firewall exception list as TCP ports. The
values for Port and WSTransferPort might vary from one host PC to another, depending on the
availability of free ports on the host system. By default, the HP WS Pro Proxy Agent service finds free
ports starting at port 8020.
The value of LEDMDiscoveryPort must be added to the firewall exception list as the UDP port. The value
of LEDMDiscoveryPort is the same as the value the administrator set while installing HP WS Pro Proxy
Agent.
Supported devices
For a complete list of the devices that can be discovered with HP SNMP Proxy Agent and HP WS Pro Proxy
Agent, see the Discovering PC-connected Devices in HP Web Jetadmin white paper. This white paper is
available from the HP Support Center.
Questions and answers
Question
Answer
How do I detect whether a proxy is
installed and which proxy is installed?
You can access Add/Remove Programs to see which proxy is installed, but Add/Remove
Programs might not provide the version of the installed proxy.
Does HP Web Jetadmin use ICMP to
discover devices through HP WS Pro Proxy
Agent?
Yes. HP Web Jetadmin does an initial test on the IP address to determine if it is active.
The hosting system must respond or HP Web Jetadmin cannot discover devices. In some
cases, ICMP can be blocked by a firewall, but should be enabled to ensure that the
discovery works. You can issue a simple Windows command at the administrator
command window to add ICMP to the protocols that the Windows firewall allows. The
following is an example:
"netsh firewall set icmpsetting type = all mode = enable"
CAUTION: Before you issue a Windows command to change the firewall settings, make
sure that you read and understand all the related Windows documentation.
Can I use the /a switch when installing
HP WS Pro Proxy Agent by using MSIEXEC?
10
Chapter 3 HP WS Pro Proxy Agent 10.3.6
No. The installer does not support the /a switch. If you use the /a switch, the
installation fails. You must use the /i switch. For more information about the command
syntax, see Standalone installation on page 8 and Silent installation on page 9.
ENWW
Revision history (partial)
The following table provides a partial history of the improvements and fixes made for HP WS Pro Proxy
Agent.
Table 3-1 Revision history for HP WS Pro Proxy Agent (partial)
Proxy version
Release date
Improvements and fixes
10.3.6
HP Web Jetadmin 10.3 SR6 (10.3.93671)
●
16-May-2014
ENWW
Updated the UIO version to fix device communication
errors that occur for the following PC-connected
devices:
◦
HP LaserJet Pro 200 color M251
◦
HP LaserJet Pro 400 Printer M401
◦
HP LaserJet Pro 400 MFP M425
◦
HP LaserJet Pro 200 color MFP M276
●
Added the ability to manage the new HP Officejet
Pro 8610, HP Officejet Pro 8620, and HP Officejet
Pro 8630 devices with the HP Officejet Pro MFP
Universal Plug-in (UPI).
●
Updated HP WS Pro Proxy Agent to detect a printer
when the VMware Workstation is installed on the
same machine.
Revision history (partial)
11
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising