Modifying the Session Timeout Value for the KB Admin Control Panel in IIS6

The following Instructions describe changing the session timeout for the Knowledgebase Admin Control Panel from the default 20 minutes to 60 minutes

Important Note: The design of Knowledgebase utilizes Microsoft IIS for application session management. Feature development and testing assume that default IIS session timeout values, as well as the default session values of the Knowledgebase are used for all customer deployments. While it is possible to adjust IIS and Knowledgebase session timeouts, it is not recommended. Support of systems that have non-default session timeout values will be on a best effort basis only.

The primary function of a session time out value is to recycle stale connections in order to free up resources (memory, processing power, Database connections, etc). The time out period is configured within Microsoft Internet Information Services (IIS) and within the Knowledgebase application, so there is no way to completely eliminate it, but you can extend the time out value by following the steps below.

Be aware that there is a drawback: Since the sessions will not be refreshing at the normal rate (the default in IIS and the Knowledgebase is 20 minutes), it is possible to see performance slowdowns and possibly even crashes due to dwindling resources caused by several active sessions running for extended periods of time. If you experience decreased performance due to the longer session refresh rate you should adjust the settings back to the default.

Step 1 - Modify the login.aspx file

1. Log on to the Knowledgebase Application Server.
2. In Windows explorer navigate to drive:\Program Files\Knowledgebase.Net\knowledgebase\applicationprogram\ui\http\ClientPortal (where drive is the drive that Knowledgebase is installed.)
3. Select file login.asp or login.aspx depending on the version of KB.
4. Save a copy of the file in case changes need to be reverted.
5. Edit the original file in notepad.
6. Scroll down to the ============= Set app sessions ============== section of the file.
7. Change the session.TimeOut line to read session.TimeOut = 60 '1 hours
8. After you have made the change save the file with exactly the same name and parameters.
   

   

Step 2 - Change web.config file

1. Within the same directory as Step 1 select the web.config file.
2. Save a copy of the file in case changes need to be reverted.
3. Edit the original file in notepad.
4. Scroll down to the sessionState section of the file.
5. Update the timeout value to read timeout="60". Note: As documented by Microsoft, the timeout value in web.config should be in minutes. Some older versions of the web.config file may have the timeout value set in seconds.
6. After you have made the change save the file with exactly the same name and parameters.
   

   

Step 3 - Change Web Site properties in IIS

1. Right-click My Computer and choose Manage.
2. Expand Services and Applications.
3. Expand Internet Information Services.
4. Select Web Sites.
5. Right-click the ClientPortal web site and choose Properties.
6. The ClientPortal Properties window should open up to the Web Site tab
7. Update the Connection timeout value to 3600 seconds
8. Verify that Enable HTTP Keep-Alives is checked
9. Click the Apply button

   
   

10. Click the Home Directory tab then click the Configuration button and select the Options tab.
11. Set Session timeout to 60 minutes and Click the OK button.
12. Click OK on the ClientPortal Properties window.
    

    

Step 4 - Change Application Pool settings in IIS

1. In the Computer Management window click Application Pools.
2. Right-click the Application Pool used by the ClientPortal and choose Properties.
3. Click the Performance tab.
4. Set the Shutdown worker process after being idle for (time in minutes): to 60.
5. Click the OK button to close the Computer Management window.
   

   

Step 5 - Reset IIS

After changing properties IIS needs to be reset to force the update.

1. Click the START button and click Run.
2. Type cmd and press [ENTER].
3. In the window that opens type iisreset and press [ENTER].
4. Once the window says Internet services successfully restarted close the window.
   

   

Now you have changed the session timeout value to 60 minutes from the default 20 for users accessing the KbAdmin Control Panel.

Administrators who wish to change the session timeout value for the KB Admin Control Panel.

After increasing the session timeout value it is important that users log out of the KB Admin Control Panel.  Ending the session by closing the browser window is not sufficient. 

If users do not log out, unused sessions will build up causing CPU resources to be wasted.  This may lead to poor performance and a possible Knowledgebase server crash.

This article applies to non-hosted Knowledgebase installations only.  For assistance with Knowledgebase installations which are hosted by Moxie Software please contact Moxie Software Product Support via the escalations procedure listed below.

If you have additional questions, please contact our Support team at 877-373-7848 (option 2) or via email at Support@gomoxie.com.