Emergency Troubleshooting Tips
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 submit a support request on our Helpdesk.
Scenario 1: A 404 or 503 service unavailable message is seen
When this message appears it will mean that either your IIS site or application pool is turned off. You can rectify with the following steps
- Access the server that runs your ThoughtFarmer intranet, or contact someone who can.
- Proceed to IIS. This will be listed under the administrative tools.
- Check that the IIS site is turned on. If its off you will see a little stop symbol over the site name.
- Click on application pools in IIS and check that the application pool for the site is on. If its off you will see the little stopped symbol over the application pool name.
Once you have confirmed that both of these are started try and access the site again
Scenario 2: No one is able to access the intranet
For Active Directory users
- 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.
- This can be done by querying the database with 'select * from [user] where isactive = 1'. This will search for all inactive users
- Activate at least one user through the database so they can access the intranet to troubleshoot further.
where userid = [place userid you want to activate here, excluding brackets]
- Once the query has been executed, recycle the application pool so the change will take effect.
- Once a user can access the intranet, proceed to the Administration Panel: Users & Security section > Employee Directory Connector page in order to run a sync with Active Directory to activate all other users.
For all users
- Check the event viewer on the web server under "application logs".
- Check for messages related to SQL server, eg.
- Connection to SQL server lost
- Invalid credentials to connect to SQL server.
Scenario 3: 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
- Check if the affected user is in the Active Directory group that you are syncing with ThoughtFarmer. The sync group is listed on the Administration panel: Users & security section > Employee Directory Connector page for the Active Directory.
- 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 Panel: Users & Security section > Employee Directory connector page, and click on the appropriate Active Directory. At the bottom of the page are the On-Demand synchronization options. Run the Refresh user lookup list and Bulk create users synchronizations.
- Check if the user can log in.
- 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.
- 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
- 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
- Go to the Administration panel: Authentication section > Active Directory page and click on the appropriate Active Directory.
- In the Active Directory settings section, click change.
- 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 settings area.
- Recycle the application pool on the web server if performance is poor.
Scenario 4: Search / Employee directory is down
- Rebuild the index for the site:
Navigate to the Administration panel: Search section > Search settings page and click Rebuild index -> Rebuild index now -> Delete index before rebuild
Check the system logs (Administration panel: Logs & 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.). You will also be able to see the status from the search index settings screen.
Once the index has been rebuilt check the affected Employee directory / Search directory again.
- 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 the exception for the virus software was made correctly.
Please sign in to leave a comment.