upgrade technical note - upgrading from hp web jetadmin …h10032.jetadmin 10.2 service release 4...

1

Technical white paper

Upgrade Technical Note – Upgrading from HP Web Jetadmin 10.2 Service Release 4 and Earlier – Important Additional Release Details

Table of contents

Overview 2

Device details stored in HP Web Jetadmin templates or active tasks 2

HP Web Jetadmin filtering details stored in device lists or in device groups 3

Summary 7

Appendix—HP Web Jetadmin column items affected by a Service Release 5 upgrade 8

2

Overview

It is important for administrators to know about changes that will occur when upgrading from HP Web Jetadmin 10.2 Service Release 4 (10.2.71771) to newer versions of HP Web Jetadmin 10.2, specifically Service Release 5 (10.2.73942), Service Release 5 Hotfix (10.2.74918), Service Release 6 (10.2. 77156), and later releases. In essence, HP has changed device data structures to improve both usability and reliability. Many of these data structures have been updated to include details added to device settings through firmware development. Many of the improvements will help preserve columns and filtering settings over OS or environment changes, whereas today filter settings based on strings data can be prone to issues. Because of the updates performed in the newer HP Web Jetadmin version, certain functionality changes will take place that include changes to existing customer settings. This document outlines the upgrade changes that will take place. Administrators should be fully aware of these changes before performing this upgrade and should also take a few pre-upgrade actions to ensure success.

NOTE: It is very important to run a backup of HP Web Jetadmin before upgrading. HP Web Jetadmin contains a backup script set with instructions in the directory %PROGRAMFILES%\Hewlett-Packard\Web Jetadmin 10\WJABackupRestore\. Use the WJABackupRestoreInstructions.txt file to learn more about these scripts. Keep your backup files and directories in a safe location and always note the version of HP Web Jetadmin from which the backup is taken.

Device details stored in HP Web Jetadmin templates or active tasks

Devices can be configured manually via Configuration Templates or scheduled tasks. In the case of Configuration Templates, administrators can store device configuration settings in a template for later use or for application through HP Web Jetadmin Automatic Groups. Scheduled tasks that contain device settings that have not yet been applied to the devices might also exist. In both cases, HP Web Jetadmin can write changes to both stored templates and scheduled tasks as part of an upgrade feature that is initiated just after the installer upgrades HP Web Jetadmin and starts the HPWJA Service. Many of these changes take place in the background and administrators do not have to take action.

In a few cases, functionality has changed enough that HP Web Jetadmin notifies the administrator of a template or scheduled task change. In these cases, the notification alerts the administrator that a specific configuration item has been removed from the template.

Here is an example of an upgrade notification where configuration items were removed from the template. In Service Release 5, HP Web Jetadmin can potentially remove two configuration items from both templates and scheduled tasks. These configuration items are:

Address Book Management (replaced by Import/Export Address Book) Access Control for Device Applications (replaced by Access Control for Device Functions)

Here are some steps administrators should take before performing the upgrade:

1. Back up HP Web Jetadmin as noted in the beginning of this document.

2. Locate templates that include the configuration items noted above.

3. Capture and note all settings related to these configuration items.

3

4. Locate past histories that show device configuration using either affected templates or scheduled configurations.

5. Capture and note all settings related to these configuration items.

After the upgrade is complete and on the first client startup, the dialog shown in Figure 1 appears. Use this dialog to address templates and scheduled task changes that took place during the upgrade.

Figure 1: Configuration Items Removed by an Upgrade

HP Web Jetadmin filtering details stored in device lists or in device groups

As stated previously, device data structures in HP Web Jetadmin 10.2 Service Release 5 have changed. Because of these changes, filter settings put in place before the upgrade are impacted. Filter functions in HP Web Jetadmin based on user settings made before the upgrade might no longer work as expected, but remain in place after the upgrade has finished. After the installation, HP Web Jetadmin displays a notice that certain filters require adjustment. The remainder of this document describes the upgrade process as it relates to HP Web Jetadmin filtering.

After the HP Web Jetadmin installer is first launched and the installer application detects upgrade, a notice is displayed (Figure 2). The notice conveys to the administrator that certain filters, including those used in automatic grouping, might be affected. The notice also asks the administrator to back up the HP Web Jetadmin instance prior to doing the upgrade. This is the only portion of the install/upgrade that conveys the

4

filter upgrade notice. The remainder of the filtering upgrade details are conveyed after the installation is complete.

Figure 2: HP Web Jetadmin Installation Message

After the installation is completed and the HP Web Jetadmin client is started, notification is made through two different display items (Figure 3 and Figure 4) linked from the HP Web Jetadmin Application Log. Multiple messages are possible in each. These notices are conveyed for both stored filters and automatic group filters.

Figure 3: HP Web Jetadmin Upgrade – Group Issue Message

5

Figure 4: HP Web Jetadmin Upgrade – Filter Issue Message

These messages (encountered at first client startup) are displayed only once. The groups and filters messages remain in the HP Web Jetadmin Application Log. Locate the application log by selecting View, Application Log on the HP Web Jetadmin menu bar. In the application log, sort by the Action Details field, and look for the text “Upgrade - Group Issue” or “Upgrade - Filter Issue”. The details are also noted in the HP Web Jetadmin upgrade log, which is typically located in one of the following directories:

• DRIVE:\Documents and Settings\NetworkService\Local Settings\Application Data\Hewlett-Packard\HPWebJetadmin\WjaService\tracing\

• DRIVE:\Windows\ServiceProfiles\NetworkService\AppData\Local\Hewlett-Packard\HPWebJetadmin\WjaService\tracing\

The following are examples of both of the HP Web Jetadmin logs.

Figure 5: HP Web Jetadmin Application Log

6

After the upgrade is complete and the filter and groups details are known, the administrator should begin to address all issues noted. The process for addressing these issues is simple. The following items can cause the HP Web Jetadmin upgrade to flag an issue:

1. Filter is invalid

2. Column text string used in filter has changed or is no longer usable

3. Column property used in filter has changed

4. Column used has been replaced by <other column>

5. Column has been made Obsolete

The first three cases require that the filtering issue be investigated and addressed because the filters noted are no longer functional. The fourth and fifth issues indicate either a newer column exists or the column is no longer valuable and is being made obsolete. In the case where a newer, replaced by column exists, the filter or column continues to function, but the obsolete item will be removed from HP Web Jetadmin at some future time.

NOTE: The release where this removal will occur is to be determined. HP will notify customers through the support documentation when the removal occurs.

Administrators should switch to replacement items quickly to obtain optimal support. Most items that are simply obsolete will also be removed in a future HP Web Jetadmin release. Obsolete items really do not have a simple one-to-one replacement. Administrators should work with the new Counters, Supplies, or other columns and sub-columns to find the correct solution. In some cases, obsolete simply means the item is no longer of value and will be removed at a future date.

For each logged item, evaluate the issue message content for the affected filter name. Edit the filter by using either the Groups or Filtering editor interface, depending on where the filter is being used. In many cases, the editor will reveal that the filter is not valid due to a name change.

The example condition shown in the Filter Editor (Figure 6) reveals that filter element names are invalid. In this case, the data elements must be changed to valid data elements because of renaming. Here are some steps that should be taken to address a specific filter issue:

1. Copy the contents of the Advanced Filter Editor into Notepad or some other text editor.

2. Clear the contents of the HP Web Jetadmin editor UI, and enter Basic edit mode.

3. Through the Basic edit interface, acquire new filter data elements and rebuild filtering according to the messages revealed in filter issue logging.

7

Figure 6: Filter Editor – Advanced Edit Mode

NOTE: Names listed in the Advanced Filter Editor are HP Web Jetadmin Programmatic Names. Use the tables supplied in the Appendix to determine HP Web Jetadmin Service Release 5 filter editor names. At this time, the Appendix and this document are English only.

NOTE: See the HP Web Jetadmin Service Release 5 Columns and Filters white paper that describes new HP Web Jetadmin column functionality. This white paper is available at the HP Web Jetadmin support page.

Summary

Understanding upgrade changes and correcting issues is sometimes necessary with complex features such as filtering and configuration templates. Watch HP Web Jetadmin support content and helpful white paper for details.

https://support.hp.com/us-en/product/hp-web-jetadmin-software/27905/manuals

8

Appendix—HP Web Jetadmin column items affected by a Service Release 5 upgrade

Programmatic Name HP WJA 10.2 SR5 Name

AccessoriesInventoryEnabled Data Collection Enabled (Accessory Inventory)

ADDescription Active Directory Description

AdfScanCount ADF Scan Count (Replaced by Scan Usage Counters)

ADLocation Active Directory Location

ADName Active Directory Name

ADPath Active Directory Path

AnyCustomSize<all counts> Any Custom <all counts> (Obsolete)

AutoSendSettings AutoSend

AutoSenseMode Auto Sense Mode

AverageBlackCoverage Black Average Coverage (Obsolete)

AverageCyanCoverage Cyan Average Coverage (Obsolete)

AverageMagentaCoverage Magenta Average Coverage (Obsolete)

AverageTonerCoverage Average Coverage (Obsolete)

AverageYellowCoverage Yellow Average Cartridge Coverage (Obsolete)

CAC Color Access Control

CapBanner Banner (Obsolete)

CapEnhancedRes Enhanced Resolution (Obsolete)

CapGreyscale Grayscale (Obsolete)

CapJetsend JetSend (Obsolete)

ColorGeneralOffice<all counts> General Office - Color <all counts> (Obsolete)

ColorProfessional<all counts> Professional - Color<all counts> (Obsolete)

Commercial10<all counts> Commercial 10 <all counts> (Obsolete)

Custom<all counts> Custom <all counts> (Obsolete)

DefaultSignInMethod Default Sign In Method (Replaced by Access Control for Device Functions)

DeviceGroupMembership Device Groups

DeviceStatus Status

DigitalSendSMTPServerAddress SMTP Server (Replaced by Outgoing Servers)

DNSServerDomainNameColumn DNS - Domain Name (Replaced by DNS Server)

DNSServerPrimaryColumn DNS - Primary Server (Replaced by DNS Server)

DNSServerSecondaryColumn DNS - Secondary Server (Replaced by DNS Server)

Dpi DPI (Obsolete)

DpiBlack DPI Black (Obsolete)

DpiColor DPI Color (Obsolete)

9


DpiColorOptimized DPI Color (Optimized) (Obsolete)

DpiOptical Optical Resolution (Obsolete)

DSAccessLDAPServer Digital Sending - Accessing the LDAP Server

DSDefaultFromAddressCombo Digital Sending - Default 'From:' Address (Replaced by Network Folder Scan Settings)

DSDefaultScannerSettings Digital Sending - Default Scanner Settings (Replaced by Network Folder Scan Settings)

DSEmailAttachmentSettings Digital Sending - Email Attachment Settings

DSFaxServiceMaxBaudRateReceive Fax Maximum Baud Rate - Receive (Replaced by Fax Receive Settings)

DSFaxServiceMaxBaudRateSend Fax Maximum Baud Rate - Send (Replaced by Fax Send Settings)

DSSConfigCombo Digital Sending Service

DSTimeOutPreferences Digital Sending - Auto Reset Settings

EmailAddressMessageSettings Email Address/Message Settings

EmailFileSettings Email File Settings

EmailNotificationSettings Email Notification Settings

EmailScanSettings Email Scan Settings

EwsLinkInformation Embedded Web Server Other Links (Replaced by Other Links)

EWSSecurity EWS Security

EwsTimeServiceCombo Time Services

FaxSendSetup Fax Send - Setup (Replaced by Fax Send Settings)

FileSystemExternalNFSSupported NFS Access (Replaced by File System External Access)

FileSystemExternalPJLSupported PJL Access (Replaced by File System External Access)

FileSystemExternalPMLSupported PML Access (Replaced by File System External Access)

FileSystemExternalPSSupported PS Access (Replaced by File System External Access)

FolderFileSettings Network Folder File Settings

FolderNotificationSettings Network Folder Notification Settings

FolderScanSettings Network Folder Scan Settings

Foolscap<all counts> Foolscap<all counts> (Obsolete)

GetDSMDeviceDiskFontsMacros Fonts and Macros

GetDSMDeviceDiskJobs Disk Jobs

GetDSMDeviceResidentFonts Resident Fonts

GetDSMDeviceStorageMedia Storage Media

HasEnvelope Envelope Feeder (Obsolete)

HasExtraTray Extra Tray (Obsolete)

HasNUpPrinting N-Up Printing (Obsolete)

HasRamDisk RAM Disk (Obsolete)

HasSerialIR Serial IR (Obsolete)

HciCapability HCI (High Capacity Input) (Obsolete)

HcoCapability HCO (High Capacity Output) (Obsolete)

HomeScreenApplications Home Screen Applications

HomeScreenLanguageSelection Home Screen Language Selection

10


IndexCard3x5<all counts> Index Card 3x5 <all counts> (Obsolete)



InternationalB5<all counts> International B5 <all counts> (Obsolete)

InternationalC5<all counts> International C5 <all counts> (Obsolete)

InternationalC6<all counts> International C6 <all counts> (Obsolete)

InternationalDL<all counts> International DL <all counts> (Obsolete)

IPGateway Default Gateway (Replaced by IPv4 Information)

IPNetmask Subnet Mask (Replaced by IPv4 Information)

IPProtocolStackEnabled IP Protocol Stack (Obsolete)

IPv6Enabled IPv6 -- Enable (Replaced by IPv6 Information)

ISOA6Postcard<all counts> A6 Postcard <all counts> (Obsolete)

ISOAndJISA3<all counts> A3 <all counts> (Obsolete)




ISOB5<all counts> B5 <all counts> (Obsolete)

JapanesePostcardWithTab<all counts> Japanese Postcard with Tab <all counts> (Obsolete)

JapanseEnv2<all counts> Japanese Envelope #2 <all counts> (Obsolete)

JapanseEnvLong3<all counts> Japanese Long Envelope #3 <all counts> (Obsolete)

JapanseEnvLong4<all counts> Japanese Long Envelope #4 <all counts> (Obsolete)

JapansePostcardDouble<all counts> Japanese Postcard Double <all counts> (Obsolete)

JapansePostcardSingle<all counts> Japanese Postcard Single <all counts> (Obsolete)

JetdirectFirmwareAvailable Jetdirect Firmware - Available

JetDirectModel Jetdirect Model

JISB4<all counts> JIS B4 <all counts> (Obsolete)



JISExecutive<all counts> JIS Executive <all counts> (Obsolete)

LDAPAuthenticationAccessLDAPServer LDAP - Accessing the Server

LDAPSignInSetup LDAP Sign In Setup

Ledger<all counts> Ledger <all counts> (Obsolete)

Letter<all counts> Letter <all counts> (Obsolete)

MarkersuppliesLevelPercent<marker type> Estimated % <marker type> Supply Levels (Replaced by Supplies)

MarkersuppliesMaintenancePagesRemaining Maintenance Kit - Estimated Pages Remaining (Replaced by Supplies)

MarkersuppliesSerialNumberBlack Black Cartridge Serial Number (Replaced by Supplies)

MarkersuppliesSerialNumberBlack Black Cartridge Serial Number (Replaced by Supplies)

MarkersuppliesSerialNumberCyan Cyan Cartridge Serial Number (Replaced by Supplies)

MarkersuppliesSerialNumberMagenta Magenta Cartridge Serial Number (Replaced by Supplies)

11


MarkersuppliesSerialNumberYellow Yellow Cartridge Serial Number (Replaced by Supplies)

Monarch<all counts> Monarch <all counts> (Obsolete)

NeededCreds Credentials Required

NetworkEnableFeatures9100 9100 Printing (Replaced by Network Enable Features)

NetworkEnableFeaturesEWS EWS Config (Replaced by Network Enable Features)

NetworkEnableFeaturesFTP FTP Printing (Replaced by Network Enable Features)

NetworkEnableFeaturesIPP IPP Printing (Replaced by Network Enable Features)

NetworkEnableFeaturesIPV4 IPv4 Multicast Config (Replaced by Network Enable Features)

NetworkEnableFeaturesIPV4Column Enabled Features - IPv4 Multicast (Replaced by Network Enable Features)

NetworkEnableFeaturesLPD LPD Printing (Replaced by Network Enable Features)

NetworkEnableFeaturesMDNS mDNS Config (Replaced by Network Enable Features)

NetworkEnableFeaturesMDNSColumn Enabled Features - mDNS (Replaced by Network Enable Features)

NetworkEnableFeaturesSLP SLP Config (Replaced by Network Enable Features)

NetworkEnableFeaturesTelnet Telnet Config (Replaced by Network Enable Features)

OutgoingServers Outgoing Servers

Photo4x6<all counts> Photo 4x6 <all counts> (Obsolete)

PowersaveTimeout Sleep Delay Time (Replaced by Sleep Delay (Minutes))

PpmColorBluetooth PPM Color, Bluetooth (Obsolete)

PpmColorUSB PPM Color, USB (Obsolete)

PpmMonoBluetooth PPM Black & White, Bluetooth (Obsolete)

PpmMonoUSB PPM Black & White, USB (Obsolete)

PrinterFirmwareAvailable Printer Firmware - Available

PrinterPersonalityRevision Printer Personality Revision (Obsolete)

PrinterTotalCharge Total Printer Usage (Replaced by Print Usage Counters)

QuietMode Quiet Mode

RamInstalled Installed RAM (Obsolete)

ROC16k<all counts> 16K <all counts> (Obsolete)

ROC8k<all counts> 8K <all counts> (Obsolete)

SecureDiskInstalled Secure Disk (Replaced by Storage Media)

SecureDiskStatus Secure Disk Status (Replaced by Storage Media)

SMTPSettings SMTP Gateway Settings (Replaced by Outgoing Servers)

SupplyBlackAndYellowPrinthead Black and Yellow Printhead (Replaced by Supplies)

SupplyBlackCartridge Black Cartridge (Replaced by Supplies)

SupplyBlackImageDrum Black OPC (Replaced by Supplies)

SupplyBlackPrinthead Black Printhead (Replaced by Supplies)

SupplyBlackPrinthead Black Printhead (Replaced by Supplies)

SupplyBlackPrinthead1 Black Printhead 1 (Replaced by Supplies)

SupplyBlackPrinthead2 Black Printhead 2 (Replaced by Supplies)

SupplyBlueAndGreenPrinthead Blue and Green Printhead (Replaced by Supplies)

12


SupplyBlueCartridge Blue Cartridge (Replaced by Supplies)

SupplyBondingAgent Bonding Agent (Replaced by Supplies)

SupplyCleaningKit Cleaning Kit (Replaced by Supplies)

SupplyColorInkCartridge Color Ink Cartridge (Replaced by Supplies)

SupplyCyanAndMagentaPrinthead Cyan and Magenta Printhead (Replaced by Supplies)

SupplyCyanAndMatteBlackPrinthead Cyan and Matte Black Printhead (Replaced by Supplies)

SupplyCyanAndMatteBlackSecondaryPrinthead Cyan and Matte Black Printhead 2 (Replaced by Supplies)

SupplyCyanCartridge Cyan Cartridge (Replaced by Supplies)

SupplyCyanImageDrum Cyan OPC (Replaced by Supplies)

SupplyCyanPrinthead Cyan Printhead (Replaced by Supplies)

SupplyCyanPrinthead1 Cyan Printhead 1 (Replaced by Supplies)

SupplyCyanPrinthead2 Cyan Printhead 2 (Replaced by Supplies)

SupplyDocumentFeederKit Document Feeder Kit (Replaced by Supplies)

SupplyFeedRoller Feed Roller (Replaced by Supplies)

SupplyFuserKit Fuser (Replaced by Supplies)

SupplyGlossEnhancerAndGrayPrinthead Gloss Enhancer and Gray Printhead (Replaced by Supplies)

SupplyGlossEnhancerCartridge Gloss Enhancer Cartridge (Replaced by Supplies)

SupplyGrayAndPhotoBlackPrinthead Gray and Photo Black Printhead (Replaced by Supplies)

SupplyGrayCartridge Gray Cartridge (Replaced by Supplies)

SupplyGreenCartridge Green Cartridge (Replaced by Supplies)

SupplyImageDrum OPC (Replaced by Supplies)

SupplyLamp Lamp (Replaced by Supplies)

SupplyLevelsStatusTray1 Tray 1 Media Level in % (Replaced by Trays)






SupplyLightCyanAndLightMagentaPrinthead Light Cyan and Light Magenta Printhead (Replaced by Supplies)

SupplyLightCyanAndLightMagentaSecondaryPrinthead Light Cyan and Light Magenta Printhead 2 (Replaced by Supplies)

SupplyLightCyanCartridge Light Cyan Cartridge (Replaced by Supplies)

SupplyLightGrayAndPhotoBlackPrinthead Light Gray and Photo Black Printhead (Replaced by Supplies)

SupplyLightGrayAndPhotoBlackSecondaryPrinthead Light Gray and Photo Black Printhead 2 (Replaced by Supplies)

SupplyLightMagentaCartridge Light Magenta Cartridge (Replaced by Supplies)

SupplyMagentaAndYellowPrinthead Magenta and Yellow Printhead (Replaced by Supplies)

SupplyMagentaAndYellowSecondaryPrinthead Magenta and Yellow Printhead 2 (Replaced by Supplies)

SupplyMagentaCartridge Magenta Cartridge (Replaced by Supplies)

SupplyMagentaImageDrum Magenta OPC (Replaced by Supplies)

SupplyMagentaPrinthead Magenta Printhead (Replaced by Supplies)

13


SupplyMagentaPrinthead1 Magenta Printhead 1 (Replaced by Supplies)

SupplyMagentaPrinthead2 Magenta Printhead 2 (Replaced by Supplies)

SupplyMaintenanceCartridge Maintenance Cartridge (Replaced by Supplies)

SupplyMaintenanceKit Maintenance Kit (Replaced by Supplies)

SupplyMatteBlackAndRedPrinthead Matte Black and Red Printhead (Replaced by Supplies)

SupplyMatteBlackAndYellowPrinthead Matte Black and Yellow Printhead (Replaced by Supplies)

SupplyMatteBlackCartridge Matte Black Cartridge (Replaced by Supplies)

SupplyPhotoBlackCartridge Photo Black Cartridge (Replaced by Supplies)

SupplyRedCartridge Red Cartridge (Replaced by Supplies)

SupplyRollerKit Roller Kit (Replaced by Supplies)

SupplySeparationPad Separation Pad (Replaced by Supplies)

SupplySpittoon Drum Spittoon (Replaced by Supplies)

SupplyStapler Stapler (Replaced by Supplies)

SupplyStaplerSecondary Stapler (Secondary) (Replaced by Supplies)

SupplyStaplerTertiary Stapler (Tertiary) (Replaced by Supplies)

SupplyTonerCollectionUnit Toner Collection Unit (Replaced by Supplies)

SupplyTransferKit Transfer Kit (Replaced by Supplies)

SupplyTray1 Tray 1 (Replaced by Trays)







SupplyWebWipe Web Wipe (Replaced by Supplies)

SupplyYellowCartridge Yellow Cartridge (Replaced by Supplies)

SupplyYellowImageDrum Yellow OPC (Replaced by Supplies)

SupplyYellowPrinthead Yellow Printhead (Replaced by Supplies)

SupplyYellowPrinthead1 Yellow Printhead 1 (Replaced by Supplies)

SupplyYellowPrinthead2 Yellow Printhead 2 (Replaced by Supplies)

SurfacesCountColor Total Count Color (Replaced by Print Sheet Counters)

SystemLogServer System Log Server (Replaced by System Log Server Info)

TotalChargeScanner Total Digital Copy Usage (Replaced by Scan Usage Counters)

TrapTable SNMP Trap Destination Table

Unknown<all counts> Unknown <all counts> (Obsolete)

UsbFileSettings USB File Settings

UsbNotificationSettings USB Notification Settings

UsbScanSettings USB Scan Settings

USEnvelopeA2<all counts> Standard US Invitation <all counts> (Obsolete)

14


UserPinAuthentication User PIN Authentication

USExecutive<all counts> Executive <all counts> (Obsolete)

USLegal<all counts> Legal<all counts> (Obsolete)

USLetterR<all counts> Letter-R <all counts> (Obsolete)

WINSServerPrimaryColumn WINS - Primary Server (Replaced by WINS Server)

WINSServerSecondaryColumn WINS - Secondary Server (Replaced by WINS Server)

hp.com/go/getconnected

Current HP driver, support, and security alerts delivered directly to your desktop

© Copyright 2020 HP Inc. 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.

c02700120, Rev. 5, September 2020

http://www.hp.com/go/getconnected