When troubleshooting ZENworks for Desktops you should always be aware of any NetWare error messages that are occurring. ZENworks for Desktops is heavily tied into the NetWare operating system, eDirectory, and file system. Therefore, any error occurring in NetWare could possibly affect ZENworks for Desktops as well. NetWare Server File System ErrorsWhen ZENworks for Desktops is having problems distributing applications, you should always look for errors in the NetWare file system. These errors often help you narrow down the problem to a specific cause and resolution. For example, if the ZENworks for Desktops client gives the user the following error, you might suspect a connection problem with the server and could focus troubleshooting on finding the cause and fixing that problem. 918: This utility was unable to get connection information. Error code: 89FF. Table 19.2 contains common file system errors.
eDirectory ErrorsAnother area you should always review when troubleshooting ZENworks for Desktops is the eDirectory error messages. ZENworks for Desktops uses eDirectory heavily, not only for normal authentication and access, but also as a service for controlling ZENworks for Desktops objects. eDirectory errors can be categorized as follows. eDirectory Operating System Error CodesSome eDirectory background processes require the functionality provided by the NetWare operating system. These processes, such as communication and transaction servers, can return operating system specific error codes to eDirectory. These error codes are then passed to the eDirectory background process that initiated a request. In NetWare 4.x, versions of eDirectory (NDS) can also generate operating system error codes. Usually operating system error codes that are generated by eDirectory have a negative numerical representation, whereas normal operating system error codes have a positive numerical representation. The numerical range for operating system error codes generated by eDirectory is -1 through -256; inversely the numerical range for operating system error codes is 1 through 255. NOTE eDirectory returns the positive numerical error code rather than the negative error code normally used by eDirectory to the application to prevent any incompatibility. Therefore, any occurrence of an error code within the range of 1 to 255 or -1 to -255 should be treated as the same error. eDirectory Client Error CodesThe next class of eDirectory error codes is the client error codes. Some eDirectory background processes require the functionality provided by other eDirectory servers. Use of these functions, such as bindery services, requires that an eDirectory server act as an eDirectory client to the server providing the functionality. Therefore, these functions often result in client-specific error codes being returned to the eDirectory background processes and operations. eDirectory client error codes are generated by the eDirectory client that is built into eDirectory. The eDirectory client error codes fall in the range of codes numbered -301 through -399. eDirectory Agent Error CodesAnother class of eDirectory error codes is the eDirectory agent error codes. eDirectory agent error codes represent errors that originated in the eDirectory Agent software in the server that are returned through eDirectory. These codes are numbered -601 through -799 (or FDA7 through F9FE). NOTE Temporary errors are normal, because the eDirectory database is designed as a loosely consistent database. You should not be alarmed if eDirectory error conditions exist temporarily. However, some errors might persist until the error condition is resolved. Other eDirectory Error CodesSome eDirectory background processes require the functionality provided by other NLM programs, such as timesync.nlm or unicode.nlm. If any of these modules encounter an error, it can be passed on to the ds.nlm. Unicode.nlm and other errors in this category range from -400 to -599. Tools for Troubleshooting eDirectory ErrorsTo effectively troubleshoot eDirectory errors that affect ZENworks for Desktops, you should be familiar with the tools available to troubleshoot eDirectory problems. The following tools are provided to monitor and repair error conditions with eDirectory. The eDirectory Manager UtilityThe eDirectory manager utility provides partitioning and replication services for the eDirectory database on a NetWare server. It also provides repair capabilities for repairing the database from a client workstation, which alleviates the network administrator's total dependence on working from the server console. The DSREPAIR UtilityThe DSREPAIR utility enables you to work from the server console to monitor and repair problems with the eDirectory database on a single-server basis. It does not correct problems on other servers from a single, centralized location. It must be run on each server on which you want to correct eDirectory database errors. The DSTRACE UtilityThe DSTRACE utility enables you to work from the server console to diagnose eDirectory errors. These errors might appear when you are manipulating eDirectory objects with the administration utilities. eDirectory errors also show up on the DSTRACE screen. Table 19.3 contains common eDirectory errors.
|