ZENworks for Servers 3 Policy Engine

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.



Novell's ZENworks for Servers 3. Administrator's Handbook
Novell's ZENworks for Servers 3. Administrator's Handbook
ISBN: 789729865
EAN: N/A
Year: 2003
Pages: 137

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net