Building Distributed
Applications
Using the Progress AppServer


Configuring an AppServer Using the Progress Explorer

Follow these steps to define and configure an AppServer instance:

  1. Make sure that the Progress AdminServer is running on the host where you want to configure the AppServer (see the "Using the Progress Explorer to Configure an AppServer Instance" section).
  2. Open the Progress Explorer.
  3. Connect to the AdminServer on your AppServer host (see the Progress Installation and Configuration Guide Version 9 for Windows).
  4. Do one of the following:
    • To define a new AppServer, select the AppServer folder in the Progress Explorer’s tree view and open the New dialog box. Enter a unique name for the AppServer. Choose OK. The Preferences Dialog box appears. Set any global preferences that you require (see the online help), and choose OK. The AppServer instance property editor appears.
    • To modify an existing AppServer configuration, expand the AppServer folder in the tree view, select the AppServer instance you want to modify, and open the AppServer property editor.
    • The AppServer instance property editor shows a tree view of property categories on the left and the properties for the selected category on the right.

  5. Select a property category and set the properties as required. You can accept the default values, if they are appropriate for your application. You probably want to specify the properties under each category, as follows:
    • Broker—This category specifies properties of the Application Broker. Expanding this category shows the following property subcategories:
    • General—You must specify an Operating mode, and you probably want to specify a non-default value for the TCP/IP port number where the Application Broker listens for requests.

      You must also select a controlling NameServer from the list of NameServer instances that you have already configured.

      If you want the AppServer to start whenever you start the AdminServer, select the Auto start check box, and if you want to use a different working directory from the one specified during AppServer product installation, you can also change it here.

      Owner Information—You can optionally provide Username and Password information for the user who owns the AppServer instance.

      AppService Name List—You can either enter any names for the Application Services supported by this AppServer, or you can select the Supports default service check box if you want this AppServer to support the default service for all client connections that do not specify an Application Service name. If you choose to use Application Service names, the default Application Service name is the name of the AppServer instance.

      Logging Setting—You can specify a different pathname from the default for the broker log file, specify the level of logging detail, and whether the logging for a session appends to or overwrites the previous broker log file.

      Advanced Features—You can specify the maximum number of client connections (Maximum client instances) that the AppServer can support at one time, the AppServer weight factor (Priority weight) for load balancing, the time between retries to register the AppServer with the controlling NameServer, the timeout period for starting the AppServer, the timeout period for an AppServer to accept a client request, and the timeout period for the Application Broker to trim its quota of Application Server processes between the maximum and minimum setting (see the Server category). For more information on these options, see the Progress Explorer online help.

    • Server—This category specifies properties of the Application Server processes. Expanding this category show the following property subcategories:
    • General—You can specify a pathname of the Application Server process executable (Server executable file). You generally only need to specify a different value than the default if you build a new Application Server process executable using the PROBUILD utility. For more information, see the "Customizing the Application Server Process Executable" section.

      Specify the Progress startup parameters for the Application Server process (Server startup parameters). These are the standard Progress client startup parameters, and can include any parameters that you require for each AppServer session, including (but not limited to) all of the standard database, code-page, and process management parameters. For more information, see the Progress Startup Command and Parameter Reference.

      The AppServer can run with a different code page than the client application. For more information, see the "Managing Code Pages" section.

      For PROPATH, specify the semicolon-separated list of directories where the AppServer can locate 4GL procedures to execute. This setting overrides any PROPATH environment variable settings on the AppServer host when it starts up. Make sure that all of the 4GL procedures (r-code or source) that you want the AppServer to execute are located in one of these PROPATH directories. Otherwise, the procedure must be executed using its fully-qualified pathname.

      Specify the minimum and maximum TCP/IP port numbers that the Application Broker can assign to Application Server processes that it starts up. (Check with your system administrator for appropriate ranges.)

      Logging Setting—You can specify a different pathname from the default for the server log file, specify the level of logging detail, and specify whether the logging for a session appends to or overwrites the previous broker log file.

      Pool Range—These settings determine the number of Application Server processes that the Application Broker can startup and maintain for the AppServer. For more information on setting these values, see the "Specifying the Server Pool Parameters" section.

      Advanced Features—To allow the 4GL debugger to run in the AppServer session, select the 4GL debugger enabled check box. For more information, see Debugging." Specify the names of any AppServer configuration procedures that you want the AppServer to execute, and any parameters for the Startup procedure. For more information on AppServer configuration procedures, see Programming the AppServer."

    • Environment Variables—If you want to specify environment variables for AppServer execution, select this category. It allows you to enter name-value pairs for environment variable settings. Any values you set here override prior values set for the same environment variables in the operating system. For more information, see the "Environment Variable Settings" section. (NOTE: Do not set the PROPATH variable using this category. Use the Server General category, instead.)
  6. Choose the OK button to save the configuration.

Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095