The ZENworks for Servers 3 policy engine runs on the NetWare Server, provides enforcement of server policies, and installs server software packages. The commands listed in Table B.1 are available from the ZENworks for Servers 3 console. The console is labeled as ZfS in the screens list.
Table B.1. List of Console Commands for ZENworks for Servers 3 Console
COMMAND | DESCRIPTION |
---|
cls | Clears the screen and places the prompt at the top of the screen. |
down ! | Downs the server, ignoring any downing policy that may be in effect. |
down cancel | Cancels the current down process. If the server is still sending out messages and so forth from the down policy, the down is cancelled, the logins are re-enabled, and so forth to bring the server back to its previous state. Any previously dropped connections will, obviously, be lost. |
down reset | Downs the server by performing a reset of the server. If a downing policy is administered it is enforced. |
down restart | Downs the server and restarts the hardware, bringing the system back up. If a downing policy is administered, it is enforced. |
down server | Downs the server and does not bring the server back up, enforcing the downing policy if one is administered. |
down status | Reports whether the server is in the process of handling a down request. It tells you, for example, how many minutes before the down actually occurs. |
events fire <eventid> | Fires an event as if the event actually happened in the server. The eventid is the exact string that is displayed on the events list. It is not a number, but the name of the class handling the event. |
events list | Lists all the events that the ZENworks for Servers 3 system is monitoring and the Java process that is watching for the event. |
events status | This command is nonfunctional. |
exit | Terminates the policy engine and unloads the processes. Any other enforcer or other Java processes related to ZENworks for Servers 3 policy management will continue. |
exitall | Terminates the policy engine and all other Java processes. This command unloads JAVA.NLM, resulting in every Java process (even Java processes that are not related to ZFS) being terminated. |
help | Provides help on the ZENworks for Servers 3 console commands. You may also enter help <command> to get more specific help on individual commands. |
listplugins | Lists the plug-ins that are in the system. |
package list | Lists the current set of installed software packages and the dates that they were installed. An asterisk by the item means that requesting a rollback can uninstall that package. |
package process <file> | Processes the specified .CPK (software package) file and installs it onto the server. |
package rollback | Uninstalls the last package installed (shown with an asterisk in the package list). |
policy eventbased | Displays the policies that are effective on this server that are activated by an event on the server. |
policy list | Lists the current effective policies. Also displays a policy number with each effective policy. This number is used in the policy enforce command. |
policy plugins | Displays the current plug-ins that are in the policy engine. There is a policy plug-in called an enforcer for each policy that can be associated with the server. These enforcers are responsible for making the policy effective when launched by the scheduler. This command also lists the event handler that watches events that occur on the server (for example, down server) that may be monitored by the engine because a policy may affect behavior. |
policy refresh | Causes the policy engine to refresh its configuration and policy information by going to eDirectory and getting all policies and re-caching them internally and rescheduling any scheduled policies. |
policy refreshonly | Retrieves from eDirectory all the effective policies associated with this server and refreshes them into the server's cache of the policies. This does not refresh or reschedule any scheduled policy. |
policy rescheduleonly | Retrieves from eDirectory all the scheduled effective policies associated with this server, refreshes them into the server's cache of the policies, and reschedules them. |
policy schedules | Displays the policy schedules that are to be fired on this server. |
policy status | Displays information about the configuration of the policy engine. This information includes tree, engine state, search policy name, policy top container, refresh seconds (time between reads of eDirectory for new or updated policies), search level, search order, and search type. Search order and type are a set of single-digit values that represent an order from left to right. Search order values are as follows: 0 = object, 1 = group, 2 = container. Search type values are as follows: 0 = root, 1 = container, 2 = partition, 3 = specified container. |
prompt [new prompt] | Displays the current prompt, if none is given on the command line. If a new string prompt is given, the new prompt is set as the prompt for the console. No quotes are required for the parameter. The system automatically tacks on the > character after the prompt. |
refresh | Manually requests that the server refresh its configuration policy. This does not read all policies, only the ZENworks for Servers 3 policy associated with this server. Use the policy refresh command to read all other policies. |
setfilelevel [#] | Sets the following level number for the messages to be sent to the log file: 0 = No Messages; 1 = Errors; 2 = Successes & Level 1; 3 = Warnings & Level 2; 4 = Information & Level 3; 5 = Trace information & Level 4; 6 = Developer trace information & Level 5. If no level number is entered, the current level is displayed. This command does not change the messages that are sent to the console. |
showschedule | Displays the currently scheduled actions and the Java classes (plug-in) that handle the action when the schedule fires. |
showvars | Lists the current variables that are defined on the system. This gives the keys and their values. |
status | Displays status information on the policy engine, including base path, number of plug-ins loaded, number of events registered, number of scheduled items, and the current console message level. |
time | Displays the current date and time of the server. |
version | Displays the current version of the ZENworks for Servers 3 Policy Manager. |
The commands listed in Table B.2 are the debug commands that are available with the policy engine. The debug commands enable you to access some of the debugging features of ZENworks for Servers 3 to troubleshoot problems. These commands are not supported by Novell, Inc., and may not be fully functional. These commands are valid even if debug is not turned on in the console.
Table B.2. List of Debug Console Commands for ZENworks for Servers 3 Console
COMMAND | DESCRIPTION |
---|
Addtables | Adds tables to the Sybase database for logging policy messages and events. |
Debug | Instructs user to use the debugon command to turn on help for debug commands. |
Debugoff | Turns off help for debug commands. |
Debugon | Turns on help for debug commands. |
Deltables | Deletes the log tables that were created in the Sybase database for logging policy messages and events. All the data that are in the tables will be lost. |
echo <command><console> | Sends the given command to the specified ZENworks for Server 2 console, such as distributor or subscriber. echo help distributor, for example, causes the distributor console to execute the help command. |
load <module name> | Loads the specified Java class module into the Java engine. |
logconsoleoutputoff | Turns off sending all characters displayed on the console to the log file. |
logconsoleoutputon | Turns on sending all characters displayed on the console to the log file. |
off | Performs a clear screen, just like cls. |
q | Quits the policy engine. This is the same as exit. |
resolve [ip address|dns name] | Resolves a given IP address or DNS name. This returns the IP address and the DNS name known to the system. |
send <message> | Performs a broadcast of the message to all connected users. |
setconsolelevel [#] | Sets the following level of messages to display on the policy engine console: 0 = No Messages; 1 = Errors; 2 = Successes & Level 1; 3 = Warnings & Level 2; 4 = Information & Level 3; 5 = Trace information & Level 4; 6 = Developer trace information & Level 5. The level is the same as the setfilelevel command. The default level is 4, but it can be specified in the ZFS policy. The level is reset back to the level specified on any refresh or restart of the policy engine. |
showstates | Displays the various Java components (in policy engine threads) that are currently active and the state they are in, such as downing in five minutes and so forth. |
spc <dn><plugin><cmd><string> | Executes a "server procedure call" to the specified server DN. The call causes the plug-in specified to be loaded and the command with the given string parameters to be launched. This can be used to launch an enforcer on a remote server. |
threads | Lists the current threads that the policy engine is managing. |