Novell is now a part of Micro Focus

Enabling the Automatic Workstation Import (AWI) Debug Screens for Troubleshooting

Novell Cool Solutions: Feature
By Ted Haeger

Digg This - Slashdot This

Posted: 29 Nov 2000

Many features of ZENworks for Desktops 3 rely upon having workstations represented as an object in the corporate directory. Indeed, features such as workstation inventory, remote control, lights-out application distribution, and workstation configuration policies simply don't function without having workstations registered in the directory. Therefore, the Automatic Workstation Import (AWI) service is a critical foundation for a healthy implementation of ZENworks for Desktops 3.

The AWI server agent runs as a service on Windows NT, Windows 2000 or NetWare. Whether on Windows or on NetWare, it is often very helpful to be able to see the service's debug screens. The debug screens can show critical information, such as whether the service is active, information for each workstation as it first contacts the service, and error messages.

The steps outlined below will help you to enable the debug screen on your AWI server for more effective troubleshooting.

Enabling AWI Debug on the NetWare Server

  1. Use a text editor to open SYS:System\zenWSImp.NCF on your AWI Server.
  2. Locate the text "-Dloglevel=0"
  3. Change it to "-Dloglevel=3 -ns"
    This makes AWI agent log verbose (debug level 3) information to a new screen (-ns) on the server.
  4. Save the changes to zenWSImp.NCF
  5. Stop ZENworks by running ZFDstop.ncf and waiting for the services to completely unload.
  6. Start ZENworks by running ZFDstart.ncf.

    Note: If your server is running ZENworks inventory components, you may see an error during the restart. This error is simply caused by a service that ZFDstop.ncf did not unload, and the error can be ignored.

  7. At the console prompt, type JAVA --SHOW to see the list of loaded Java processes. Note the service number of the AutoWSImport service, then switch to the server screen for that Java process. The last line on that screen should read:
    date time Servicing requests.

Enabling AWI Debug on the Windows NT/2000 Server

  1. Use Notepad on your AWI server to open the file \\ntservername\sys\zenworks\AutoWS\zenwsimp.reg.

    Note: Here is the reg file with needed updates embedded. If you double-click the file, you can merge it with your AWI server's registry and skip to step 5.

  2. Find the text "-Dlogfilelevel=2"
  3. Add after it the following "-Dloglevel=3" (This turns on verbose (=3) screen logging.)
  4. On the AWI server, right-click the zenwsimp.reg file and select Merge to merge the file with the AWI server's registry.
  5. Now you need to enable the service to interact with the desktop so you can see the logging screen.

  6. Open the Services Control Panel. At the end of the page find ZENworks Workstation Import service.

  7. Stop the service.
  8. Open the service's Properties screen and select the Log On tab.

  9. Check the box for Allow service to interact with desktop, then click OK. This will cause the service to expose its debug screen when it next starts.
  10. Start the ZENworks Workstation Import service.
  11. The troubleshooting screen should now start and you'll see this screen:

For More Info

There are actually two components that make Automatic Workstation Import work: the client-side Workstation Manager, and the back-end Workstation Import service, which was the subject of this article. For more on the client-side part of deploying Automatic Workstation Import, see this article.)

If you have any questions, the Reverend Ted, aka Ted Haeger, can be reached at

Novell Cool Solutions (corporate web communities) are produced by WebWise Solutions.

© Copyright Micro Focus or one of its affiliates