Jetdirect Admin Guide
Jetdirect Admin Guide
Rev. 5/2010
Installation and Setup Guide for HP Web
Jetadmin 10.2
ENWW 1
NOTE: HP recommends that you fully test HP Web Jetadmin 10.2 in environments where earlier
releases have been integrated into critical business operations. HP Web Jetadmin device
management, alerting, and other features have been greatly improved with the introduction of
HP Web Jetadmin 10.2 and, prior to implementing this software into full production, HP recommends
that you fully test and qualify the application.
Please read all support materials when implementing HP Web Jetadmin 10.2. For current information
regarding HP Web Jetadmin 10.2 software, see the documents on http://www.hp.com/go/
webjetadmin Self Help tab titled Late Breaking News, Supported Devices on HP Web Jetadmin
10.2.
NOTE: If the installation stops with a warning that a reboot is required, reboot the host on which the
HP Web Jetadmin 10.2 installer is running. Then relaunch the installer to continue to installation.
Operating Systems (server and client ● For the server: .NET Framework ● HP Web Jetadmin now supports
unless otherwise noted) 3.5 SP1 is the minimum required. 32-bit and 64-bit versions of all
supported Windows operating
● Microsoft Windows XP systems.
Professional (with SP2 and above)
● Print queue creation and print path
● Microsoft Windows Server 2003 management are not supported
(with SP 2 and above) from Microsoft Windows Vista,
Microsoft Windows 7, Microsoft
● MicrosoftWindows Server 2008
Windows 64–bit systems, and
● Microsoft Vista Business Edition Microsoft Windows Server 2008
either running HP Web Jetadmin
● Microsoft Windows 7 or as print queue management
servers.
Virtual Machine (Optional Platform) ● VMWare Server ● For a VMWare server, the virtual
machine network must be set to
● VMWare ESX bridged to facilitate HP Web
● Microsoft Virtual Server Jetadmin 10.2 communications.
Client Hardware ● PC with 1.8 GHz or greater ● If .NET is not detected, the
processor (2.4 GHz software will provide assistance for
recommended) steps to install .NET Framework.
● RAM
Database ● Microsoft SQL Server 2008 ● Microsoft SQL Server 2008 can be
installed on 64 bit operating
● Microsoft SQL Server 2005 systems and also as a customer
Express Edition database platform.
● Microsoft SQL Server 2005 ● Microsoft SQL Express Edition, if
Standard, Workgroup, or not present, is added at install
Enterprise Editions time.
HP Web Jetadmin Client Application ● Required: Internet Explorer 6, 7, or ● Internet Explorer is required to
8 start the HP Web Jetadmin Smart
Client application. For browser
● Required: 1024 x 768 display requirements and limitations,
resolution. check Windows operating system
support documentation.
Shared print queue creation support ● Windows XP Professional or ● Print queue creation and print path
Windows Server 2003 management are not supported
from Microsoft Windows Vista,
Microsoft Windows 7, Microsoft
Windows 64–bit systems, and
Microsoft Windows Server 2008
either running HP Web Jetadmin
or as print queue management
servers.
NOTE: HP Web Jetadmin 10.2 is supported on platforms with Microsoft Windows and .NET
Framework high-priority updates. During each development cycle, HP Web Jetadmin 10.2 is regularly
tested on platforms with current Microsoft updates. HP will investigate all customer software issues
presented by post-release updates. The document Late Breaking News for HP Web Jetadmin 10.2
(found on http://www.hp.com) will be updated periodically to provide the latest software issue
information.
NOTE: New! HP Web Jetadmin now requires Windows HTTP SSL service to be loaded. HP Web
Jetadmin is now using SSL communication through port 8050 to communicate with newer HP devices
and now requires Windows SSL support.
NOTE: The Universal Print Driver for 64–bit operating systems and for 32–bit operating systems
cannot be installed into HP Web Jetadmin 10.2 driver repository at the same time. Both have the
same versioning detail and HP Web Jetadmin 10.2 is not able to distinguish between the two.
Ports
HP Web Jetadmin 10.2 listens on several ports continuously and opens other ports for specific
functionality. Below are the ports used by the system hosting HP Web Jetadmin 10.2 and also remote
ports:
Table 2 Ports
ENWW Ports 5
Table 2 Ports (continued)
NOTE: Port Number 0 denotes a random system port number. The I/O column represents
communication direction with respect to the HP Web Jetadmin 10.2 server host. Random source
ports are used when communicating to ports on remote IP address.
NOTE: All random ports assignments are made by the operating system hosting HP Web Jetadmin.
Uninstall
Command Line uninstall is also possible. Here is the syntax:
msiexec.exe /qn /uninstall <ProductCode> <Property1=Value1>
<Property2=Value2> <...>
Usage Examples
● To perform a basic silent install:
WjaSetup.exe /S /v/qn /V"WJA_EULA=ACCEPT"
● To perform a silent install with the application installed to "C:\WJA" and the database installed to
"C:\WJADB":
WjaSetup.exe /S /v/qn /V"WJA_EULA=ACCEPT INSTALLDIR=C:\WJA
DATABASEDIR=C:\WJADB"
● Media Administration
● Time Zone
● Tray Administration
● IPv6 – Enable
● Weekly Timer
● LDAP Settings
● Authentication Manager
● VuLDAP
For example, in HP Web Jetadmin 10.1 you had a Configuration Template with three configuration
options: SNMP Trap Destination Table, Control Panel Language, and Auto Continue. After
upgrading from HP Web Jetadmin 10.1 to HP Web Jetadmin 10.2, this template would only contain
Auto Continue, as the other two configuration options are incompatible.
If this dialog box is displayed, follow these steps:
1. Either copy the information listed and paste it into a word processor, or make sure you can view
it later in the Application Log.
2. Select whether to let this dialog appear again for other clients, or dismiss it forever.
NOTE: After this dialog box is dismissed by selecting Do not show again, you must access
the Application Log to retrieve this information if you did not copy it.
3. Access each of the configuration templates or tasks containing a configuration option that was
not upgraded and add that configuration option again.
Post-Installation Actions
NOTE: The HP Web Jetadmin 10.2 server will start automatically as a Microsoft Service. The
HP Web Jetadmin 10.2 server cannot accept HP Web Jetadmin client connections until the HP Web
Jetadmin server has fully loaded all services into memory. Dependent upon your HP Web Jetadmin
server available system resources, it may take 1-2 minutes for all services to completely load after
initial server installation or server reboot.
The first time you launch HP Web Jetadmin 10.2 after installation, a pop-up dialog is displayed stating
that no devices have been discovered. You can opt to launch discovery settings at this point.
Once the installation is complete, HP Web Jetadmin 10.2 can be launched from a supported browser
by entering the hostname or IP address of the computer on which it is installed, followed by the port
number and path. Typical default port numbers for Web services have a value of 80. Since HP Web
Jetadmin 10.2 may be running simultaneously with another Web service on the same computer,
HP Web Jetadmin 10.2 uses a port number of 8000. If desired, the port value may be altered.
Here is an example of the URL used to activate HP Web Jetadmin 10.2 on a supported Windows
desktop:
http://myhost:8000
All that is needed to start the Smart Client session is a browser. Administrator rights are not required
to run Smart Client applications but .NET 2.0 is required to be installed; local administrator rights
might be required prior to the installation.
Some characteristics about Smart Client are:
● The HP Web Jetadmin 10.2 server is initially contacted through http/https.
● The server transfers about 2 MB of Smart Client application to the client where it is saved to disk
and runs as the user logged onto the computer.
● The Smart Client application, running on the client, executes commands to download the
HP Web Jetadmin 10.2 client files (about 50 MB) and starts UIExec.exe (browser is now
inactive).
1. Access the Control Panel on the HP Web Jetadmin 10.2 host computer and go to
Administrative Tools > Local Security Policy.
2. Go to Local Policies > Security Options.
3. Locate the item Network access: Sharing and security model for local accounts.
4. Change the setting to Classic - local users authenticate as themselves.
To ensure this feature works properly, see Minimum System Requirements for HP Web Jetadmin
10.2 on page 2.
Alternate Log-in
In some cases, the client host and the server hosting HP Web Jetadmin 10.2 may not reside on the
same Windows security domain or may not reside on any Windows security domain. Since the
release of HP Web Jetadmin 10.2 an alternate log-in prompt is provided so that you can enter log-in
credentials other than those being used by the current Windows session. Normally, HP Web
Jetadmin uses single sign-on functionality to pass the user identity, currently logged into the local
desktop Windows session, onto HP Web Jetadmin. HP Web Jetadmin checks this identity either
through local Windows users at the server host or through Windows security domain identities. When
HP Web Jetadmin fails to authenticate this identity (for any reason) it will display the alternate log-in
prompt.
The alternate log-in prompt is handy for a variety of use-cases. For example:
● An HP Web Jetadmin authorized user is accessing software from another unauthorized person’s
desktop.
● An HP Web Jetadmin server is on a security domain but end-user desktops are not; end users
do have log-in identities within this domain that have been given access rights within HP Web
Jetadmin Users and Roles.
NOTE: The port number within <value> can be any unused port number value. In this case,
Port 8099 was used for illustrative purposes.
3. Save the file.
4. Restart the HP Web Jetadmin service (HPWJAService).
5. Open the port number on any firewall or similar application.
Default Settings
Table 3 Default Settings for HP Web Jetadmin 10.2
Alerts history retention 30 days Tools > Options > Shared > Server
Maintenance > Alerts
Alerts polling rate: Critical alert 5 minutes Tools > Options > Device
interval Management > Device Polling >
Alerts
Alerts polling rate: Maximum 24 hours Tools > Options > Device
communication interval Management > Device Polling >
Alerts
Application Log: Maximum number 20,000 Tools > Options > Application
of entries Management > Application Log
Application Log: Save log entries for 60 days Tools > Options > Application
Management > Application Log
Background polling options: Polling 2 seconds Tools > Options > Device
interval Management > Device Polling >
Background
Background polling options: Time 10 seconds Tools > Options > Device
between polling intervals Management > Device Polling >
Background
Configuration history retention 30 days Tools > Options > Shared > Server
Maintenance > Configuration
Device Filters: Time period for device 14 days Tools > Options > Device
to remain “New” Management > Device Filters > New
Devices Filter
Device list polling options: Number 2 Tools > Options > Device
of devices per poll Management > Device Polling >
Device List
Device list polling options: Polling 5 seconds Tools > Options > Device
interval Management > Device Polling >
Device List
Device tab options: Devices to allow 10 Tools > Options > Device
in multi-view Management > Device Tabs >
General
Device tab polling options: Polling 5 seconds Tools > Options > Device
interval Management > Device Polling >
Device Tabs
Device tab polling options: Time 2 seconds Tools > Options > Device
between polling intervals Management > Device Polling >
Device Tabs
Device tab polling options: Number 3 Tools > Options > Device
of devices per poll Management > Device Polling >
Device Tabs
Discovery history retention 90 days Tools > Options > Shared > Server
Maintenance > Discovery
Firmware upgrade options: Time 3 hours Tools > Options > Device
between retries Management > Firmware > General
Reports Data Collection Times: 12:00 AM Tools > Options > Device
Accessory Inventory Management > Reports > Data
Collection Times
Reports Data Collection Times: 12:00 AM Tools > Options > Device
Device Inventory Management > Reports > Data
Collection Times
Reports Data Collection Times: 12:00 AM Tools > Options > Device
Device Utilization Management > Reports > Data
Collection Times
Reports Data Collection Times: 12:00 AM Tools > Options > Device
Device Utilization by User Management > Reports > Data
Collection Times
Reports Data Collection Times: 12:00 AM Tools > Options > Device
Event Log History Management > Reports > Data
Collection Times
Reports Data Collection Times: 12:00 AM Tools > Options > Device
Hourly Peak Usage Management > Reports > Data
Collection Times
Reports Data Collection Times: 12:00 AM Tools > Options > Device
Supply Utilization Management > Reports > Data
Collection Times
Reports data retention 1 year Tools > Options > Shared > Server
Maintenance > Reports
SNMPv1 timeout value 500ms Tools > Options > Shared >
Network > SNMP
SNMPv3 timeout value 1000ms Tools > Options > Shared >
Network > SNMP
Supply polling options: Polling 5 seconds Tools > Options > Device
interval Management > Device Polling >
Supplies
Supply polling options: Time 10 seconds Tools > Options > Device
between polling intervals Management > Device Polling >
Supplies
Device list polling options: Time 7 seconds Tools > Options > Device
between polling intervals Management > Device Polling >
Device List
2. Create a catalog with a name on the remote database. Record the catalog name.
3. Create a user on the database with database owner rights to the catalog from Step 2. Record
the username and remember the password.
4. In the config file directory. For example, on Vista: C:\Windows\ServiceProfiles
\NetworkService\AppData\Local\Hewlett-Packard\HPWebJetadmin\WjaService
\config, create a file named DatabaseSettings.config.xml.
In the file type:
<ipmc:configuration xmlns:ipmc="www.hp.com/schemas/imaging/ipmc/config/
2004/02/24">
<property name="DatabaseConnectionFactory.MachineName">
<type>HP.Imaging.Wjp.Sdk.Core.Framework.ConfigurationItemString</type>
<value>insert machine name here</value>
</property>
<property name="DatabaseConnectionFactory.UserName">
<type>HP.Imaging.Wjp.Sdk.Core.Framework.ConfigurationItemString</type>
<value>insert username here</value>
</property>
<property name="DatabaseConnectionFactory.PlainTextPassword">
<type>HP.Imaging.Wjp.Sdk.Core.Framework.ConfigurationItemString</type>
<value>insert plain text password here</value>
</property>
</ipmc:configuration>
If the instance name is not a default instance, insert a property into the file:
<property name="DatabaseConnectionFactory.InstanceName">
<type>HP.Imaging.Wjp.Sdk.Core.Framework.ConfigurationItemString</type>
Report Types
The HP Eco Solutions reports are pre configured SAP Crystal Reports 2008 that let you view your
environmental settings of your systems. For more information about using Crystal Reports 2008, see
http://www.sap.com/solutions/sapbusinessobjects. For a PDF version of the “Crystal Reports 2008
SP1 User's Guide”, visit http://help.sap.com/businessobject/product_guides/cr2008V1/en/
xi3-1_cr_usergde_en.pdf.
There are four HP Eco Solutions reports:
Device Settings and Reports the availability of ● Device count: quantity of devices detectable by HP Web
Capabilities paper-saving features as Jetadmin 10.2.
well as the availability and
use of energy-saving ● Duplex-capable devices: the percentage of all reported
features. devices with automatic duplex feature installed, listed by
individual device status. This shows your total opportunity
to drive paper savings via duplexing.
Copy/Digital Send Reports devices without ● Device count: quantity of devices detectable by HP Web
Capabilities Exception copy or digital send Jetadmin 10.2.
capability; addition of digital
send capability can enable ● Copy-capable devices: devices with copy capability; such
digital, rather than paper- devices can also scan to locally connected devices.
based, information
● Digital send-capable devices: devices capable of copying
management, reducing to file and copying for digital sending.
paper consumption.
Device Paper Usage and Reports device use, ● Total count: paper throughput, in sheets.
Digital Processing showing both paper-based
and digital information ● Simplex sheets: number of single-sided prints.
management. This allows
● Duplex sheets: number of sheets of paper printed in
comparison of simplex and
duplex (double-sided) mode; includes sheets printed on
duplex printing, as well as
one side while the device is in duplex mode.
the use of digital send
capability rather than copy. ● Simplex versus duplex: percentages of one-sided and two-
sided printing. A higher percentage of simplex pages
indicates potential to save paper with duplex printing.
Top 5 Paper Usage Reports the printers with ● Simplex count: number of single-sided prints.
the greatest paper usage
among selected groups, ● Duplex count: number of sheets of paper printed in duplex
enabling prioritized follow- (double-sided) mode; includes sheets printed on one side
up. while the device is in duplex mode.
NOTE: C:\Program Files is the default location, but on any user system this could be a
different drive and/or folder.
2. Use the -x option to extract a properties file (Uninstaller.exe -x=properties.xml).
3. After manually editing the properties file, use the -v option to validate a properties file
(Uninstaller.exe -v=properties.xml).
4. Use the -s option to run the Uninstaller in silent mode using the given properties.xml file
(Uninstaller.exe -s=properties.xml).
Confirmation and agreement to the HP Web Jetadmin End User License Agreement (EULA) is
required before download of the product and is found in the registration process. The EULA is also
located in HP Web Jetadmin from the top menu bar under Help > About.
ENWW 29
Index
M
manually restarting 12
30 Index ENWW