KnowNow Event Router Configuration Utility

Overview

The Event Router Configuration Utility allows a server administrator/developer to configure the Router.

Installation

The Config Tool comes pre-packaged with the Router. No further installation is necessary.

Starting the Config Tool

To start the Config Tool, use the following process:

  1. Navigate to the URL where the tool is located The URL can be found on the Router Utilities startup page.
  2. An .htaccess login prompt appears.
  3. Login with root privileges.
  4. If the login is successful, the main configuration screen appears. See The Configuration Tool Screen.

The Config Tool Screen

The Configuration Tool Screen

 

On Windows platform, the Config Utility will re-start by itself only if the Router is running as a service.

The Config Tool screen is divided into the following three frames:

Config Editor

The Config Editor screen display the following information in editable form:

You can edit this information but the changes are not saved until you click the Save Changes button.

The Config Tool screen comprises of the following buttons:

Button

Description

Add a Constant

Allows you to add a constant.

Add a Parameter

Allows you to add a parameter to a section.

Add a Section

Allows you to add a new section.

Delete a Constant

Allows you to delete a constant.

Delete a Parameter

Allows you to delete a parameter.

Delete a section

Allows you to delete a section.

Save Changes

Prompts you with an alert that tells you that it will save the changes and restart the Router. You have the option to cancel the action.

Reset to Original Values

Returns all editable fields on the screen to their original values.

For more information on using these fields, refer to Using the Config Editor".

Router Data

The Router Data section of the Configuration screen provides the following information:

The Router Data information comes out of kn_statistics and is updated to an interval specified in the conf file. The default interval is 10 seconds. Discarding the Router persistence files and restarting the Router resets these values to zero.

 

Using the Config Editor

The Config Editor can be used to edit, add, or delete a constant, to edit, add, or delete a parameter, and to add or delete a section.

 

Config Utility cannot be used through a load balance interface in a cluster configuration. The recommended approach is that you get one version of the .conf, perm, passwd, and group files just the way you want it, copy these files to each of the cluster machines, and then restart the cluster machines.
Editing a constant

To edit a constant, do the following:

  1. Click inside the text box that contains the constant value you want to edit.
  2. Using your keyboard, change the value inside the text box.
  3. Click Save Changes to make sure the changes take effect.
Adding a new constant

To add a new constant, do the following:

  1. Click the Add Constant button at the bottom of the Constants section.
  2. At the prompt, enter the name of the new constant.
  3. Click OK.
  4. At the next prompt, enter the value of the new constant. The default is an empty string.
  5. Click OK.
Deleting a constant

To delete a constant, do the following:

  1. Click the trashcan icon next to the constant you wish to delete.
  2. To confirm deletion, click OK at the prompt. To cancel deletion, click Cancel.
Editing A parameter

To edit a parameter, do the following:

  1. Click inside the text box that contains the parameter value you want to edit.
  2. Using the keyboard, change the value inside the text box.
Adding a new parameter

To add a new parameter, do the following:

  1. At the bottom of the appropriate section, click the Add Parameter button.
  2. At the prompt, enter the name of the new parameter.
  3. Click OK.
  4. At the next prompt, enter the value of the new parameter.Click OK.
Deleting a parameter

To delete an existing parameter, do the following:

  1. Click the trashcan icon next to the parameter you wish to delete.
  2. To confirm deletion, click OK. To cancel deletion, click Cancel.
Adding a section

To add a new section to the Config Editor frame, do the following:

  1. Scroll to the bottom of the Config Editor frame and click the Add Section button.
  2. At the prompt, enter the name of the new section.
  3. Click OK.
  4. The new section appears at the bottom of the Config Editor frame.
  5. To add parameters to the new section, follow the steps for adding parameters above.
Deleting a section

To delete an existing section from the Config Editor frame, do the following:

  1. At the bottom of the section that you want to delete, locate and click the Delete Section button.
  2. Deleting a section also deletes all parameters associated with it. To confirm deletion, click OK at the prompt. To cancel, click Cancel.
Saving the Edited Config Data

When you finish editing the config data, you must save your changes and send them back to the Router. The Router will attempt to restart with the new settings.

  1. Scroll to the bottom of the Config Editor frame and click the Save Changes button.
  2. The changed config data is sent to the Router. The Router then attempts to restart with the new settings.
  3. If the attempt is successful, you get a notice saying that the Router has restarted. Click Edit Configuration if you need to edit the config data again.
  4. If the restart fails, you get an error message. Contact the system administrator for help.
Restoring the Config Data

You can restore configuration changes only if the Save Change button has not been clicked. To restore the config data to its last saved state:

  1. Scroll to the bottom of the Config Editor frame, and click Revert to Saved button.
  2. The Config Editor reloads the last saved configuration data from the Router. All unsaved changes you made to the config data are lost.

Exiting the Config Tool

There is no logout process to exit the tool. Simply navigate to another URL.

 
All brand names and product names used in this document are trade names, service marks, trademarks or registered trademarks of their respective owners.
Copyright © KnowNow, Inc. All rights reserved.
Printed in the U.S.A.
Last updated: January 15, 2002