Documentation

Emergency Troubleshooting Guide

From time to time you may encounter problems with your ThoughtFarmer intranet that you don't know how to resolve. This guide lists some scenarios that you may encounter, and contains instructions on how to troubleshoot these problems. If you don't find the appropriate solution below, please contact the ThoughtFarmer Helpdesk for assistance.

Scenario 1 - No one is able to access the intranet

For Active Directory users

Step 1: Check the database to see if all users have been set to inactive.
  • If users are inactive, check Active Directory to ensure all users are active. If they are not, set all users to Active.
Step 2: Activate at least one user through the database so they can access the intranet to troubleshoot further.
  • Query to perform this action:
UPDATE [user]
Set isactive = 1
where userid = ''
Step 3: Once the query has been executed, recycle the application pool so the change will take effect.

Step 4: Once a user can access the intranet, proceed to the Administration PanelUsers & Security section > Active Directory page in order to run a sync with Active Directory to activate all other users.

For all users

Step 1: Check the event viewer on the web server under "application logs".

Step 2: Check for messages related to SQL server, eg.
  • Connection to SQL server lost
  • Invalid credentials to connect to SQL server

Scenario 2 - A specific user is unable to access the intranet

For Active Directory Users

If the user receives an "access denied" message or is logged in as a guest member then check the following areas:

If automatic user creation is turned on

Step 1: Check if the affected user is in the Active Directory group that you are syncing with ThoughtFarmer.

Step 2a: If the user is not in the Active Directory group:

  • Add the user to the group and then sync ThoughtFarmer with Active Directory. To sync, go to the Administration PanelUsers & Security section > Active Directory page, select the checkbox Bulk create users and click Synchronize now.
  • Check if the user can log in.
Step 2b: If the user is in the Active Directory group:
  • Check if the user has a profile on ThoughtFarmer. It is possible the user has two profiles due to a name change in Active Directory.
  • If the user has two profiles, delete the new profile and follow the steps to take when a user changes their name.
Step 3: If the user still has problems logging in, it is possible that the correct credentials are not being passed through the system due to multiple accounts being created.
  • Perform a restart of the web server.

If automatic user creation is turned off

Step 1: Ensure that a profile has been created for the specific user before the user attempts to log in.

Scenario 3 - Editing a page gives errors

Step 1: Go to the Administration panelUsers & Security section > Active Directory page.

Step 2: In the Active Directory basic settings section, click change.

Step 3: Ensure no messages appear stating that credentials are invalid. If a message exists stating that the credentials are invalid
:

  • Determine the correct credentials and re-enter them into the basic settings area.
Step 4: Recycle the application pool on the web server if performance is poor.

Scenario 4 - Search / Employee directory is down

Step 1: Rebuild the index for the site:
  • Navigate to the Administration panelSearch section > Search index page and click Rebuild search index.
  • Check the system logs (Administration panelLogs & statistics section > System logs page) for the message stating that the index has been rebuilt. (This will take some time depending on the amount of content you have on your intranet.)
  • Once the index has been rebuilt check the affected Employee directory / Search directory again.
Step 2: Check the index folder on the web server for any temporary folders.
  • If temporary folders exist, delete them.
Step 3: Check if there is virus protection software on the server.
  • If virus software exists, create an exception for the ThoughtFarmer folder that contains the index and resized image folder.
If the issue persists ensure that no temporary folders are being made and that the exception for the virus software was made correctly.

If you need further assistance with the problem you are experiencing, please feel free to contact the ThoughtFarmer Helpdesk.

Useful troubleshooting documentation