C.1 ZENworks Server Management Console Commands

Table C-1 lists the ZENworks Server Management server console commands with short descriptions of the commands. The table also indicates at which server console prompt you can give a command.

The column heading M is for the server’s main console prompt and Z for the ZENworks Server Management prompt. Under a console prompt column, a Y indicates that you can issue the command at that prompt and a – indicates that you cannot issue the command at that prompt.

Table C-1 Console Commands

Command

M

Z

Description

HELP

Y

Y

Displays a list of available commands. Only the commands applicable to a component are displayed.

HELP command

Y

Y

Displays help for the specified command.

CLS

Y

Y

Clears the screen. Useful for quickly recognizing which information is new when you enter a command.

DOWN option

Y

Y

This is similar to the command used on the server’s main console prompt. However, if you use DOWN at the ZENworks Server Management prompt, server policy settings for downing the server are followed.

For the ZENworks Server Management prompt, this command has several options:

  • DOWN SERVER: Downs the server only; does not bring it back up.

  • DOWN STATUS: Displays the current down status.

  • DOWN RESTART: Downs the server, then restarts it.

  • DOWN RESET: Downs the server, then resets it.

  • DOWN CANCEL: Allows you to cancel the down, up to when the server is actually taken down. This does not leave the server in an unusable state.

  • DOWN !: Causes the down process to execute immediately, ignoring the Down Server Process policy that might be in effect.

EVENTS option

Y

The command has three options:

  • EVENTS LIST: Lists all registered events, including third-party events.

  • EVENTS STATUS: Gives the status of each event.

  • EVENTS FIRE event_ID: Allows you to manually run an event.

EXIT

Y

Closes the current command prompt’s Java software. For example, if given at the Subscriber prompt, the Subscriber’s Java software is closed.

LISTPLUGINS

Y

Lists the current Server Management plug-ins.

PACKAGE option

Y

You can do the following for the software packages installed on the server:

  • PACKAGE LIST: Lists the currently installed software packages. This is useful for knowing which packages to roll back and the order that they should be rolled back, which is the reverse order in which they finished installing, not the order that they started installing.

  • PACKAGE PROCESS full_package_path: Use this to manually install a software package.

  • PACKAGE ROLLBACK: Automatically rolls back (uninstalls) the most recently installed software package. For example, you installed three software packages on a server (Package1, Package2, and Package3), and Package1 was installed first, Package2 second, and Package3 last. If you want to roll back Package2, you need to first roll back Package3. To do so, enter  package rollback at the server console once for Package3, then again for Package2.

    The software package installation order is not guaranteed, because the order is determined by when a package has finished processing. Therefore, the installation order might be Package2, Package1, Package3 when using the Package Rollback command. This order is shown by the Package List command.

POLICY or POLICY LIST

Y

Lists the effective server policies. Each policy listed has a corresponding policy number for reference when using the POLICY ENFORCE command.

POLICY ENFORCE policy_number

Y

Used to manually enforce a specific policy. You can find the policy_number using the POLICY LIST command.

This is useful for enforcing a policy ahead of its schedule. However, you usually use POLICY REFRESH first to ensure you are enforcing the most recent changes.

POLICY ENFORCE ALL

Y

Used to manually enforce all effective policies, such as after doing a POLICY REFRESH.

POLICY EVENTBASED

Y

Lists the event-based policies.

POLICY PLUGINS

Y

Lists the current policy enforcers and the current event handlers.

POLICY REFRESH

Y

Refreshes only the server’s policies and schedules, as required (unlike the REFRESH command, which refreshes policies and undoes any changes made to the prompts).

After using this command, you should do a POLICY ENFORCE.

POLICY REFRESHONLY

Y

Refreshes the server’s policies, but does not schedule effective policies.

POLICY RESCHEDULEONLY

Y

Reschedules all current policies according to their schedules. Does not refresh the effective policies.

POLICY SCHEDULES

Y

Lists all policy schedules that are in effect.

PROMPT

Y

Temporarily resets the current prompt. It reverts back to whatever is specified in the Novell eDirectory™ object for the console prompt when the Java process is exited or restarted, or when the REFRESH command is given.

REFRESH

Y

Manually forces a refresh of a policy, including pending changes to service locations for the current server and temporary changes to ZENworks Server Management prompts.

Used alone, it refreshes only the ZENworks Server Management policy. Use POLICY REFRESH to refresh all policies.

SETCONSOLELEVEL number

Sets the console message level:

0:  No messages

1:  Errors

2:  Successes & level 1 messages

3:  Warnings & level 2 messages

4:  Information & level 3 messages

5:  Trace information & level 4 messages

6:  Developer trace information & level 5 messages

SETFILELEVEL number

Y

Sets the file message level:

0:  No messages

1:  Errors

2:  Successes & level 1 messages

3:  Warnings & level 2 messages

4:  Information & level 3 messages

5:  Trace information & level 4 messages

6:  Developer trace information & level 5 messages

SHOWSCHEDULE

Y

Lists the current schedules.

SHOWVARS

Y

Lists the predefined variables and their values. These variables can be used in Server Software Packages.

STATUS

Y

Lists the current status of Policy and Distribution Services, including:

  • Base Path
  • Plug-ins Loaded
  • Events Registered
  • Scheduled Items
  • Console Level

TIME

Y

Y

Returns the current date and time that the server is set to.

VERSION

Y

Y

Returns the Server Management version for the ZENworks Server Management prompt, and the NetWare version for the console’s main prompt.