!++ ! ! HELP FILE for WEBES Director ! !Copyright 1999-2004 Hewlett-Packard Company ! !Confidential computer software. Valid license from !Hewlett-Packard required for possession, use or copying. !Consistent with FAR 12.211 and 12.212, Commercial Computer !Software, Computer Software Documentation, and Technical !Data for Commercial Items are licensed to the U.S. Government !under vendor's standard commercial license. ! !-- 1 DESTA $ DESTA The Distributed Enterprise Service Tools Architecture (desta) Director is part of Web-Based Enterprise Services (WEBES). It contains services for System Event Analyzer (SEA) and Computer Crash Analysis Tool (CCAT). If SEA is installed, the Director monitors system log files for new system events, selecting events for translation and analysis, and responds to manual event log analysis commands. If CCAT is installed, the Director scans for system crash dump files and processes them when the system boots; in addtion, it responds to manual crash dump analysis commands. The Director communicates with other Director processes on other host systems and with WEBES user interfaces on the local host (such as command line interfaces, the SEA web interface, and the CCAT GUI). The DESTA process logs error messages to SVCTOOLS_HOME:[SPECIFIC.WEBES.LOGS]DESTA_DIR.LOG. Commands are formed using the DESTA prefix followed by one of the valid command verbs. Additional information can be found on the Service Tools web site at the following URL: http://h18000.www1.hp.com/support/svctools/ 2 HELP Displays online help for the Director. $ DESTA HELP 3 Examples $ DESTA HELP Shows the DESTA general help. 2 ISEE Turns Instant Support Enterprise Edition (ISEE) automatic notifications to Hewlett-Packard on or off if the ISEE Client is installed on the system. $ DESTA ISEE [ON | OFF] 3 ON Enables ISEE automatic notifications. 3 OFF Disables ISEE automatic notifications. 3 Examples $ DESTA ISEE ON Turns on ISEE notifications. $ DESTA ISEE OFF Turns off ISEE notifications. 2 MSG Allows you to change the TCP/IP socket port used by the Director to communicate with other processes on the same machine or other machines on the network. The Director processes can only communicate with other machines that use the same TCP/IP socket port. $ DESTA MSG -CHGPORT port_number: o The port number you want to assign as the TCP/IP socket port. After changing the port, the WEBES Director shuts down, which impacts all WEBES users connected to the system. Use DESTA START to restart the Director on the new port. 3 Examples $ DESTA MSG -CHGPORT 7930 Changes the TCP/IP socket port to 7930. 2 PRIORITY Changes the priority of the Director process. Possible priorities are normal (compete with other processes) and low (allow normal processes to use more CPU than the Director). The default is low. $ DESTA PRIORITY [COMPETE | LOW] 3 COMPETE Sets the priority to normal. 3 LOW Sets the priority to low. 3 Examples $ DESTA PRIORITY COMPETE Sets the priority of the Director process to normal. 2 QSAP Turns Proactive Remote Service (PRS) automatic notifications to Hewlett-Packard on or off if the system communicates with a PRS customer service gateway or CSG (formerly QSAP). $ DESTA QSAP [ON | OFF] 3 ON Enables PRS automatic notifications. 3 OFF Disables PRS automatic notifications. 3 Examples $ DESTA QSAP ON Turns on PRS notifications. $ DESTA QSAP OFF Turns off PRS notifications. 2 SERVOB A Service Obligation lists your service provider, service agreement information and the duration of your agreement. If your service obligation has expired, you will not be able to use SEA. The SERVOB command shows the service obligation. $ DESTA SERVOB SHOW 3 SHOW Displays the current service obligation. 3 Examples $ DESTA SERVOB SHOW Shows the service obligation for the machine. 2 SICL Turns System Initiated Call Logging (SICL) automatic notifications to Hewlett-Packard on or off if DSNLink is installed on the system. $ DESTA SICL [ON | OFF] 3 ON Enables DSNLink-based automatic SICL notifications. 3 OFF Disables DSNLink-based automatic SICL notifications. 3 Examples $ DESTA SICL ON Turns on DSNLink-based SICL notifications. $ DESTA SICL OFF Turns off DSNLink-based SICL notifications. 2 START Starts the Director on the local machine. Normally, this is not necessary, since the Director starts automatically with the machine. The user who starts the Director should have all permissions set; otherwise the Director will be unable to read the system event log. $ DESTA START 3 Examples $ DESTA START Starts the Director. 2 STATUS Shows the current status of the director. The result of this command will indicate if the Director is currently running, stopped, starting up, or shutting down. $ DESTA STATUS Possible return values are: o Unknown state o Director is not running o Director status file indicates that it is running, but the process ID was not found o Director is running o Director is starting up o Director is shutting down 3 Examples $ DESTA STATUS Returns the Director's current state. 2 STOP Stops the Director on the local machine. Any user can stop the director; however, be aware that stopping the Director will impact everyone using WEBES on the machine. $ DESTA STOP 3 Examples $ DESTA STOP Stops the Director.