Instant ASP Logo


Remote Console Applet: Admin Preferences

You can perform the following administration functions using the Remote Console Applet Admin Preferences settings:

Configuring Proxy Service Settings

Click the + symbol adjacent Proxy Service Settings to expand available proxy service options. The Proxy Service Settings branch contains the following configurable settings:

NOTE: Proxy service properties are only set for proxy service by using Halcyon's iASP servlet interface. All these proxy service settings  are invalid for any 3rd party servlet interface (such as Zeus, Sun WebServer, Apache JServ etc).

 

Starting and Stopping Proxy Services
  1. To start and stop the proxy services, select the Start/Stop node under the Proxy Service Settings branch (figure 1):

    figure 1
    proxy.gif (6563 bytes)
  2. In the right-hand pane, you will see the following controls (figure 2):

    figure 2

    proxy01.gif (839 bytes)
  3. Click the Start button to start the proxy services (necessary after making other certain setting changes); click the Stop button to stop the proxy services.
Changing the Proxy Service Port Number

The proxy service port number can be any number between 1 and 65535, but it is typically a random number greater than 1024. For security reasons, you should consider changing the port number regularly.

  1. To change the proxy service port number, select the Port node under the Proxy Service Settings branch. The following controls will be displayed in the right-hand pane (figure 3):

    figure 3
    console1c.gif (1934 bytes)

  2. Once you have chosen a new port number, click the Save button to save the change or the Revert button to revert to the last setting.

NOTE: You must restart the web server and proxy service in order for the change to take effect.

Configuring  the Proxy Service Session Tracking
  1. To change the proxy service session tracking, select the Session Tracking node under the Proxy Service Settings branch. The following controls will be displayed in the right-hand pane (figure 3):

    figure
    4
    console1f.gif (2080 bytes)
  2. To enable session tracking, click the Enabled radio button. To disable session tracking, click the Disabled radio button.
  3. You can set the duration of the session timeout in minutes and you can also set the maximum number of sessions by entering numeric values into the Session Timeout and Maximum sessions edit boxes, respectively.
  4. When you have finished, click the Save button to save the changes or the Revert button to revert to the last settings.

NOTE: You must restart the proxy service in order for the changes to take effect.

Settings

Description

Session Tracking Session Tracking is a mechanism for building a sophisticated, stateful model on top of the web's stateless protocol. With Session Tracking, session state is maintained by the server.
Session Timeout Sets the number of milliseconds before dropping an idle connection. The default is 1200000 milliseconds.
Maximum sessions The default is 512.
Configuring the Proxy Service Pool Handler
  1. To change the proxy service pool handler, select the Pool Handler node under the Proxy Service Settings branch. The following controls will be displayed in the right-hand pane (figure 5):

    figure 5
    console1g.gif (1832 bytes)

    You can configure the Initial Pool Size, the Maximum Pool Size and the Pool Timeout by entering numeric values into their respective edit boxes.
  2. When you have finished, click the Save button to save the changes or the Revert button to revert to the last settings.

NOTE: You must restart the web server in order for the changes to take effect.

Settings

Description

Pool Size Specify the number of ASP applications which will be stored in server after running properly.
Initial Pool Size The default is 1.
Maximum The default is 256.
Pool Timeout Sets the expiration timeout for an idle handler thread. The default is 300 seconds.
Configuring the Proxy Service Tuning
  1. To change the proxy service tuning, select the Tuning node under the Proxy Service Settings branch. The following controls will be displayed in the right-hand pane (figure 6):

    figure 6
    proxy4.gif (1901 bytes)

    You can set the right buffer size to get the fastest throughout, configure the minimum and maximum number of handler threads by entering numeric values into the Proxy Service Minimum/Maximum Handler Threads edit boxes. You can also specify the maximum length for an incoming connection by entering a numeric value into the Proxy Service Backlog edit box.

  2. When you have finished, click the Save button to save the changes or the Revert button to revert to the last settings.

NOTE: You must restart the proxy service in order for the changes to take effect.

Settings

Description

Proxy Service Minimum Handler Threads Sets the minimum number of threads the service maintains in its handler pool to service incoming requests. Because thread creation adds overhead to the service's response time, it's recommended that you set this property to a non-zero value. The default is 5 threads.
Maximum Handler Threads Sets the maximum number of threads the service maintains in its handler pool to service incoming requests. The default is 100 threads.
Proxy Service Backlog The maximum queue length for incoming connection indications (a request to connect) is set to the count parameter. If a connection indication arrives when the queue is full, the connection is refused.

NOTE:

Proxy Service:
Allows the addition of a proxy for improved caching and faster performance. It listens on the default port 9098.

Service Tuning:
The Service Tuning page allows you to set or adjust properties that affect service performance.

Threads:
One thread is required per connection. Adding threads consumes more memory, but can yield better response time for your clients on a server that concurrently serves multiple connections that are either high latency or involve access to some high-latency resource.

Configuring the Proxy Service Class Path
  1. To change the proxy service class path, select the Classpath node under the Proxy Service Settings branch. The following controls will be displayed in the right-hand pane (figure 7):

    figure 7

    proxy5.gif (1389 bytes)

    You can also change the class path of proxy service by specifying a new class in the text field.
  2. When you have finished, click the Save button to save the change or the Revert button to revert to the last setting.
Configuring the Proxy Service Heap Size
  1. To change the proxy service heapsize, select the Heapsize node under the Proxy Service Settings branch. The following controls will be displayed in the right-hand pane (figure 8):

    figure 8

    proxy6.gif (1112 bytes)

    Enter the size you prefer in the Maximum heap Size edit box according to the instructions above the it.

    Note: The maximum heap size must be greater than or equal to 16 megabytes (because the default is 16 megabytes).

  2. When you have finished, click the Save button to save the changes or the Revert button to revert to the last settings.
Configuring the Proxy Service Load Balancing

The Load Balancing is used to optimize the performance on your web site by controlling the distribution of hits to two or more web servers based on server capacity. When your web site becomes busy, this is a very important feature which provides you the benefits:

The following instructions show you how to configure the Load Balancing feature:

  1. To change the proxy service load balancing, select the Load Balancing node under the Proxy Service Settings branch. The following controls will be displayed in the right-hand pane (figure 9):
  2. When the Enable Load Balancing Check Box is disabled, the primary server handles 100 percent of the task no matter what the last setting was. Enable it if you want to assign the task to secondary servers.
  3. Click the Add Button to add a new secondary server. You are to assign some percent of the task for this server. Re-doing this process adds another secondary server. You are allowed to  add up to 15 secondary servers. Click the Delete button to delete a selected server. If you delete a server, make sure the task percentage it held is made up by other servers. Click the Edit Button to edit a selected server. You need to edit at least one other server to make the summary of task percentages of all servers 100 percent. Click the Save button to save the changes and the Revert button to revert to the last setting. 
    Note 1: All task percentages (of all secondary servers and the primary server) add to 100 percent. Otherwise you won't be able to  save the changes. 
    Note 2: Only when the Enable Load Balancing Check Box is enabled, will the setting underneath take effect. Otherwise the primary server handles 100 percent of the task.

Configuring Console Applet Settings

Click the + symbol adjacent Console Applet Settings to expand available console applet options. The Console Applet Settings branch contains the following configurable settings:

Configuring the Console Applet Port

The console applet port number can be any number between 1 and 65535, but it is typically a random number greater than 1024. For security reasons, you should consider changing the port number regularly.

  1. To change the console applet port number, select the Port node under the Console Applet Settings branch (figure 10).

    figure 10
    console.gif (5061 bytes)

  2. The following controls will be displayed in the right-hand pane (figure 11):

    figure 11
    console1.gif (2867 bytes)

  3. Once you have chosen a new port number, click the Save button to save the change or the Revert button to revert to the last setting.

NOTE: You must restart the proxy service in order for the changes to take effect.

Configuring the Console Applet Tuning
  1. To change the console applet tuning, select the Tuning node under the Console Applet Settings branch. The following controls will be displayed in the right-hand pane (figure 12):

    figure 12
    console2.gif (1808 bytes)

    You can configure the maximum number of handler threads by entering a numeric value into the Remote Console Applet Service Maximum Handler Threads edit box. You can also specify the maximum length for an incoming connection by entering a numeric value into the Remote Console Applet Service Backlog edit box.

  2. When you have finished, click the Save button to save the changes or the Revert button to revert to the last settings.

NOTE: You must restart the proxy service in order for the changes to take effect.  

Configuring Load Balancing Settings

You can use Instant ASP Load Balancing to distribute your web service requests over clustered hosts to avoid transmission congestion and bottlenecks. And this feature is only available to iASP Enterprise version, and your system should have one or more mirrored Web servers all configured with the ability to respond directly to the same requests.

Click the Load Balancing Option, the following image will be displayed in the right-hand pane of the Remote Console Applet (figure 13).

Figure 13

If you have configured a Load Balancing Server and your ASP script uses the application scope variables, please click the Cluster Enable Option and select or add a JDBC driver for iASP, which need to build a database for the Load Balancing System, and iASP stores the application scope variable to the database so that all of iASP Servers can access the application variable from the same database. You needn't configure it if your ASP script doesn't use the application variable. 

NOTE: iASP doesn't support an application variable which its type is object, Please don't use the object type's application variable in the Load Balancing System. when you select or add a dirver to "database information", please insert the database driver into start-admin and start-server script.

Managing Instant ASP License Settings

You can use Instant ASP license management to edit license file remotely within the Remote Console Applet interface and need not use other editors to telnet in and manually modify license file. This way, you can just cut and paste the license key and save it in the license file directly.

Click the + symbol adjacent License Management to expand available license management options. The license management branch contains the following settings (figure 16):

figure 16
license.gif (5587 bytes)

 

Getting Information

Click Information, the following image will be displayed in the right-hand pane of the Remote Console Applet (figure 17).

figure 17
license1.gif (3793 bytes)

You can see whether the product ( iASP ) is licensed and what components are licensed.

Managing file

Click Managing file, the following image will be displayed in the right-hand pane of the Remote Console Applet (figure 18).

figure 18
license2.gif (7412 bytes)

This allows you to modify the iASP license file in the text field above. click the Save button to save the changes or the Revert button to revert to the last settings.

NOTE: Do not modify the file rashly, otherwise you may encounter problems later.

Managing Instant ASP Log Settings

You can use Instant ASP server log files to monitor your server and troubleshoot any problems you may be experiencing.

NOTE: Instant ASP creates its server log files in the Common Log File Format. All these Log Settings are invalid for any 3rd party servlet interface (such as Zeus, Sun WebServer, Apache JServ etc).

Click the + symbol adjacent Log Management to expand available log management options. The log management branch contains the following configurable settings:

 

Configuring Log Options
  1. To modify Instant ASP log options, select the Log Options node under the Log Management branch (figure 19).

    figure 19

  2. The following controls will be displayed in the right-hand pane (figure 20):

    figure 20


    You can enable three types of logs:

    Access Log: This log, located in the server root directory, records information about the server requests and responses returned from the server.

    Proxy Service Error Log: This log, located in the server root directory, lists all errors the proxy service has encountered, and can be quite useful for troubleshooting.

    Script Error Log: This log, located in the server root directory, lists all errors encountered when running ASP scripts and can be useful for script debugging.

    Settings

    Description

    Log to Rolling File A rolling file collects log data until it reaches the size set in the Rollover File Size setting. It will keep the old and generate a new file to save the log message without affecting the running service.
    Single File A file that collects log data until it reaches the maximum size allowed. This size is variable, and can be defined by the disk space allotted to the log directory. When it reaches the maximum size, it goes back to the beginning of the file and overwrites the previous entries.
    File Size Type Unlimited If selecting this option, the FileSize (range:100-100000) text box will not be popped up.
    Limited Chooses this option, you can specify the file size within the range from 100 to 100000.

    For each log type, you can either enable or disable logging by selecting or clearing the Enable log check box. You can also choose a filename for each log by entering a fully qualified path in the File Name edit box (be absolute path). You can choose Rolling File or Single File in the Log To drop-down list box, and you can select the type of file size from the File Size Type drop-down list box.

  3. Once you have finished, click the Save button to save the changes or the Revert button to revert to the last settings. You do not have to restart the web server for these changes to take effect.
Viewing an Access Log File
  1. To view an access log, select the node of the particular log you would like to view (View Access Log, View Service Error Log, View Script Error Log) under the Log Management branch. The following controls will be displayed in the right-hand pane (figure 21):

    Figure 21

  2. You can specify the number of entries to view by entering a numeric value in the Number of entries to view edit box.
  3. You can also filter the entries in an access log by entering a word in the Only show entries with edit box. For instance, if you only wish to display entries that contain the word "POST", enter "POST" in this field.

    NOTE: Information entered into the Only show entries with edit box is case sensitive.
  4. When you have finished, click the Ok button to apply your changes or the Reset button to revert to the last settings.

    The following is a sample of an access log in the Common Log file Format:
    192.9.200.207 -- [Thu Dec 17 09:44:31 CST 1999] "GET /iisproxy/vbscript/general/helloworld/helloworld.asp HTTP/1.1"
    192.9.200.207 -- [Thu Dec 17 09:44:36 CST 1999] "GET /iisproxy/vbscript/general/form/form.asp HTTP/1.1"
    192.9.200.207 -- [Thu Dec 17 09:44:40 CST 1999] "POST /iisproxy/vbscript/general/form/form.asp HTTP/1.1"


    Each line of the access log can have several fields each of which is defined in the table below:

    Access Log Field

    Example

    Hostname or IP address of client user.mozilla.com. In this case, the hostname is shown because the server is using DNS lookups; if a DNS server cannot resolve the name or if DNS lookups are disabled, the client's IP address appears here. 
    Username john (a username entered by the client during authentication) 
    Date/time of the request 29/Mar/1999:4:36:53 -0800
    Request GET /help 
    Protocol HTTP/1.0 
    Status code 401


If you encounter any problems or errors, please contact support@halcyonsoft.com
.


Copyright © 1998-2000, Halcyon Software Inc. All rights reserved.