Chapter 4 Configuring Web Servers and Web sites

Changing Dynamo configuration settings

The Dynamo configuration settings govern some aspects of Dynamo server behavior.

To change the settings for your Dynamo server:

1. In the left pane of Sybase Central, open the Utilities folder.
2. In the right pane of Sybase Central, open the Configuration folder.
3. Open one of these folders:

• Default CGI Settings
  
  
  • Maximum number of CGI clients Sets the maximum number of CGI clients that are allowed to connect at one time.
• Default General Settings
  
  
  • Application to launch when debugging The application you would like to use when debugging.
  • Cookie timeout When information is exchanged between a browser and a Web server, such as when a sequence of forms is filled out at a browser, Dynamo uses a cookie to maintain information about the session. After the specified timeout period, this information is discarded. The default setting is five minutes.
  • Java VM Specifies the Java VM to use. You can choose JDK 1.2 or JDK 1.1 as the Java engine used by Dynamo. You must configure the JDK properties, described below, using Sybase Central before starting PowerDynamo, and configure the environment variables required by the JDK and PowerDynamo:
    
    Before starting Dynamo or the Personal Web Server, you must configure the environment variables required by your JDK. For example, you can create a Windows batch file that configures the environment and runs the Personal Web Server with these commands:
    
    c:\set jdk=c:\jdk122
    c:\set path=%jdk%\bin;%jdk%\jre\bin;%jdk%\jre\bin\classic;%path%
    c:\set classpath=<put any classes you need for your Dynamo application>
    c:\powerdynamo\win32\dypws03

       EAServer and PowerDynamo must use the same Java VM When running Web sites in EAServer, make sure the PowerDynamo Java VM matches the JDK version used by the EAServer.

  • Classpath The CLASSPATH for the Java VM.
  • Verbose Specifies whether the Java VM operates in verbose mode, logging information about each Java class that is loaded.
  • Verbose GC Specifies whether the Java VM garbage collector thread operates in verbose mode, logging information about each Java class that is removed from memory.
  • Connection timeout This default value causes connections in the connection pool to expire or be disconnected, once the specified amount of time of inactivity has elapsed. A value of 0 indicates that connections within the pool should not be expired. For more information, see "The connection pool".
  • Maximum number of Dynamo connections per mapping This sets the maximum number of Dynamo connections to be stored in the database connection pool.
  • Maximum number of user connections per connection type Specifies the maximum number of user connections per connection type to be stored in the connection pool.
  • Minimum number of Dynamo connections per mapping Sets the minimum number of Dynamo connections to be stored in the connection pool.
  • Minimum number of user connections per connection type Sets the minimum number of User connections per connect type to be stored in the connection pool. This number of connections will never expire.
  • Default response page size The size, in bytes, of the page buffer preallocated the first time a request is executed. For more information see "Response page sizing".
  • Response page size strategy Specifies the strategy for preallocating the initial response buffer after a request has executed one or more times. For more information see "Response page sizing"
  • SMTP host Specifies the SMTP host to be used for outgoing mail. The smtpHost property of the outgoing MailPiece object takes precedence over this setting. A SMTP host must be set from this field or the smtpHost property for the mail to be sent.
  • Trace The trace option, when set to yes, creates a dynamo.log file in the Dynamo installation directory that captures logging and error information that may be useful for debugging. If you configure the Java VM to run in verbose mode, the log will contain trace information from the Java class loader.
    
    An extra log file for Java VM output is called dynjava.log. This log file is used when the tracing feature is turned on, and Dynamo is running outside of EAServer. All System.out and System.err messages are sent to dynjava.log.
    
    If Dynamo is running within EAServer, then all System.out and System.err messages are trapped by EAServer and sent to the EAServer log file. All other Dynamo messages still go to dynamo.log. Dynamo redirects System.out and System.err messages based on whether the JAGUAR environment variable is set.
  • URL arguments case sensitive Indicates whether case sensitivity is used for your URLs.
• Default ISAPI Settings The default settings for ISAPI Web servers.
  
  
  • ISAPI filter directory alias Location of the ISAPI filter.
  • Maximum number of pending requests Maximum number of URL requests that can be maintained in the queue for future processing.
  • Maximum number of worker threads Maximum number of worker threads in the pool. Each worker thread can process one task URL request at a time. Once a task has been completed by a worker thread it is released. If there are other tasks waiting to be processed by a worker thread the next is selected for processing.
• Default Jaguar Settings The default settings for working with EAServer. Settings that you specify here apply to Jaguar Managers that have not been specifically set up in the Manager Settings folder.
  
  
  • Orb Class The ORB class that represents the Java object.
  • Proxy Host Specifies the machine name or the IP address of an SSL proxy
  • Proxy Port Specifies the port number of the SSL proxy.
  • Retry Count The number of times that connecting to the server should be attempted.
  • Retry Delay The number of milliseconds to wait between attempts to connect to the server.
  • Manager Settings The configuration settings for specific Jaguar Managers. Each setting allows you to set the same properties as are found in the Default Jaguar settings. If for some reason you cannot make a connection with the settings from here, the defaults specified in the Default Jaguar Settings folder are used. For more information, see the EAServer documentation.
• Default PWS Settings The default settings for the PowerDynamo Personal Web Server.
  
  
  
  
  • Default document for static file sites When a URL without an explicit document name is supplied, the default document for the site is returned to the Web client. For the sample Web site, the default document is contents.html.

       The extension of the default document (contents.html) must be registered to Dynamo as a known MIME type, if not, the content type will be returned as "octet/stream" (binary) and be unreadable.

  • Port number Each Internet service is assigned to a logical port number. The usual port number for HTTP servers such as the Dynamo Personal Web Server is 80. You need change this value only if some other service on your machine is already using port number 80. Port numbers are ignored on UNIX machines.

To modify any of these entries, double-click on the entry, make the appropriate changes and click OK to save.

You must restart the server for changes made to the Configuration folder to take effect.

Copyright © 2001 Sybase, Inc. All rights reserved.