
CREATING MONITOR SERVER

To define the attributes for a new Monitor Server:

1. Accept the default values provided or modify the default values to
   suit the system needs at your site.
2. Provide values for all required attributes (those marked with an * ).
3. Provide values for additional functionality (optional).
4. Click Build Server! or click OK to create the new Monitor Server.


MONITOR SERVER ATTRIBUTES

Related Adaptive Server Name  (Required)
----------------------------
Provide the name of the Adaptive Server that Monitor Server 
will be monitoring.

This field does not appear if the related Adaptive Server
is created in the same srvbuild session as Monitor Server.
The Adaptive Server you are creating is used as the related
Adaptive Server. 


Adaptive Server SA User Name  (Required) 
----------------------------
Specifies the user name of the Monitor Server superuser name. 
This name, along with the SA password, must be a valid login 
account for the Adaptive Server being monitored. For production
systems, it is recommended that you use the "sa" or "sybase" user
account as the Monitor Server superuser. 

This field does not appear if the related Adaptive Server
is created in the same srvbuild session as Monitor Server. 

Monitor Server uses the superuser account to connect to Adaptive Server 
to run the mon_rpc_attach stored procedure. The superuser account must 
have permission to execute this procedure. 
Monitor Server also uses the superuser account to verify shutdown 
requests. 

This option is required unless the $USER environment variable is set. 


Adaptive Server SA Password
---------------------------
Specifies the password of the user account specified in the 
Adaptive Server SA User Name option. 

This field does not appear if the related Adaptive Server
is created in the same srvbuild session as Monitor Server. 

If this parameter is omitted, Monitor Server prompts for a password 
during start-up. 


Maximum Number of Connections
-----------------------------
Specifies the maximum number of Open Client connections allowed 
to Monitor Server. 

Valid values are 1 - 20. The default is 5. (The default is not displayed on 
the screen.)  

An Open Client connection to Monitor Server can be any of the following: 
   - A Monitor Viewer window 
   - An active Historical Server recording session currently 
     collecting data, regardless of when or how it was initiated 
   - A Historical Server recording session that has been defined 
     but has not reached its start time yet 
   - A connection to Monitor Server from a Monitor Client Library 
     application.

For example, if a Monitor Viewer user starts a Historical Server 
recording session, and then opens the Monitor Viewer Performance 
Summary and Cache Statistics windows, that user has three Open Client 
connections to Monitor Server. If the default configuration of five 
connections is in effect, two additional connections to Monitor Server 
are available for that user or other users.


Error Log Path   (Required) 
--------------
Specifies the path name of the log file in which informational and 
error messages are logged. 

The default is $SYBASE/install/servername.mon.log.
   

Configuration File Path
-----------------------
Specifies the name of the Monitor Server configuration file. 

If specified, the values in the file override the default runtime 
parameters otherwise used by Monitor Server. 

For more information about the configuration file and Monitor Server 
runtime parameters, see the Monitor Server documentation.


Shared Memory Directory
-----------------------
Specifies the name of the directory where the Adaptive Server 
adaptiveservername.krg shared memory file is located. 

If this entry is omitted, Monitor Server looks for the shared 
memory file in the $SYBASE directory. 

The same shared memory file name must be specified or implied when 
you start Adaptive Server and Monitor Server. 


Additional Command Line Parameters
----------------------------------
The additional command line options are used every time when this instance
of Monitor Server is executed. It will set parameters that can not otherwise
be configured from this program.

Separate multiple parameters with a space. The parameters you specify
override the default values for your Sybase Monitor Server.


Interfaces File Entry  (Required)
------------------------
The interfaces file is an "address book" containing
the network location for each server and client application. If the
network location is not in the interfaces file, servers and clients
cannot communicate with each other.

The default location for the interfaces file is $SYBASE/interfaces.
An interfaces file entry contains:

    * Transport type
      The transport type, in conjunction with the port number, tells 
      Monitor Server where to listen for clients or other servers. 
      It also tells clients where to go to query a particular server.

      The drop-down list contains the network protocols supported by 
      Sybase on this platform.  The default is TCP.
        
    * Host name
      The host name is the name of the machine where you installed 
      Monitor Server.
    
    * Port number 
      If you did not change the default protocol, the port number displayed 
      is the first available port address.

      If you select a protocol other than the default, the first available
      port number may or may not be supplied.
     
     
NOTES: 

     - The port number you specify cannot be used for any other purpose 
       on the machine where Monitor Server is installed. 

     - Add the port number that you selected for Monitor Server to the 
       /etc/services file and label the entry "Sybase specific services." 
       (You must log in as "root" to modify /etc/services.)
       Making this entry is not required for the operating system to function 
       properly, but it may prevent others from using the port number.  



