Resolution:
Description:
============
NullPointerException displayed when executing TIBCO TraUpgradeManage Utility

Environment:
===========
Operating System(s): All
TIBCO Runtime Agent 5.6 and lower

Symptoms:
========
- The output from executing TraUpgradeManager™ (5.6 or lower) will be

./traUpgradeManager -path /tibco -jre /tibco/jre/1.6.0

WRAPPER - start method threw an exception
Exception in thread "main" java.lang.NullPointerException
        at com.tibco.administrator.command.tool.TraUpgradeManager.a(TraUpgradeManager.java:157)
        at com.tibco.administrator.command.tool.TraUpgradeManager.main(TraUpgradeManager.java:58)

Cause:
=====
During TraUpgradeManager™(5.6 or lower) execution; the process will acquire the list of all installed TIBCO software (via the vpd.properties.tibco.&lthost>). The utility will resolve (using InetAddress Java Class) the &lthost> part of the file by DNS or by reading the host file.

If the component can not find a proper vpd.properties.tibco.&lthost> file then the temporary registry file(vpd.properties) will be zero bytes.

- After setting up debug levels in Hawkagent.cfg; the following warning may be found in the Hawk.log

"HWKLMA-070403 C:\WINDOWS\vpd.properties.tibco.&lthost> does not yet exist. Will try reopening it later"

Resolution:
==========
If a domain exists (5.6 or lower) then setup extra trace levels in hawkagent.cfg (setting -tsm_traceLevel to -1).

The tsm.log will now contain the following entry:

"=== Inventory file: C:\WINDOWS\vpd.properties.tibco.&ltresolved hostname>"

Ensure that &ltresolved hostname> matches the entries in your host file and DNS server both in spelling and case. If it does not then update as required.

Additional notes:

Host file location:
- On Windows: C:/Windows/system32/drivers/etc/hosts
- On Linux/UNIX: /etc/host

If the host name is fine then check the dns entry
- nslookup host or (Windows/UNIX/Linux)
- or by ensuring /etc/nsswitch.conf contains "hosts: dns files" then ping the host (UNIX/Linux only)