Confluence Docs 3.0 : Troubleshooting Problems & Requesting Technical Support This page last changed on Oct 11, 2009 by mryall. This document tells you how to troubleshoot problems and obtain technical support. On this page: Troubleshooting a Problem Raising a Support Request Raising a Support Ticket via the Confluence Support Request Form Raising a Support Ticket via the Internet Logging a Bug Report STEP 1. Check your Bug is Undiscovered STEP 2. Confirm the Bug ## Troubleshooting a Problem If you have a problem with Confluence, please follow these steps: If you are not a Confluence administrator, report your problem to the person in charge of your Confluence site and ask them to follow up on the issue. Check our Frequently Asked Questions and our Knowledge Base for a solution to your problem. Check the appropriate Confluence component in JIRA for known bugs. If you are having problems configuring a feature, please take a look at the appropriate guides: Confluence Installation Guide Confluence Setup Guide Administrators Guide Configuration Guide Database Configuration If your issue is related to your database server, please refer to the documentation within the Known Issues For Supported Databases section. If your issue is related to your application server, please refer to the documentation within the Installing the Confluence EAR-WAR Distribution section. If your problem may be related to a plugin, you can enter Plugin Support Mode by briefly disabling the third party plugins. If the above documentation does not solve your problem, you should create a support request. If you believe you are experiencing a bug, you may wish to create a bug report instead. Instructions for both are given below. ## Raising a Support Request
| Please check the plugin support If you have a plugin-related issue, please check whether the plugin is supported by Atlassian. Visit the plugin's home page in the Extension space, and check for the 'Atlassian Supported' logo. If the plugin is not supported by Atlassian, you will need to contact the author directly.
There are two ways to raise a support request with Atlassian: Complete the support request form via your Confluence Administration Console. The advantage of this method is that Confluence will create the support ticket and attach the relevant system information and logs for you. Raise a support ticket directly via our support site on the internet. Both methods are described below. #### Raising a Support Ticket via the Confluence Support Request Form This method is recommended, provided that SMTP email is set up on your Confluence instance. The advantage of this method is that Confluence will create the support ticket and attach the relevant system information and logs for you. You can also use this method to append system information to an existing support ticket. Log in as a user with System Administrator or Confluence Administrator access. Go to the Administration Console and click 'Support Request' under 'Administration' in the left-hand panel. The 'Raise Support Request' form will appear. Part of the form is shown below: Please provide as much information as possible, following these guidelines: 'To' — This is an email address, named the Site Support Address and configured on the 'General Configuration' screen of your Confluence instance. It points to a JIRA instance (usually the Atlassian Support System) which is configured to receive and handle support requests by email. 'CC' — Any email address(es) entered here will receive a copy of the support request, including all system information. You can enter more than one email address, separated by commas (e.g. `joe@mycompany.com, sally@mycompany.com, jane@myothercompany.com`). 'Subject' — Enter a short and meaningful description of the problem. 'Description' — Please enter as much information as possible, including any error messages that are appearing and any steps the support team can take to reproduce the problem. 'Existing Support Request' — If you have previously raised a support request for the problem, please type the issue key here (e.g. CSP-12345). The information on this form will be appended to the existing support ticket. 'Contact Name' — This will default to the name of the logged-in user. 'Contact Email' — This will default to the email address of the logged-in user. Note: This email address will be used to find your support account on the Atlassian Support System. If no matching account is found, a new account will be created. Confluence will also send all further notifications and updates to this address. 'Contact Phone Number' — Please enter a telephone number where our support staff can reach you. Include international and city codes. Click the 'Send' button. Confluence will submit your request via email to the JIRA instance referenced by the 'To' email address on the form. If you do not already have a support account, Confluence will automatically request one for you. The submitted request will include all the system and environment information which you see on the support request form. It will also include a zipped copy of your Confluence log file. Refer to Working with Confluence Logs for information about the log files. JIRA will create a support ticket including the submitted information. Log files can be very big — it is possible that your email server may bounce the message if too large. With the default log4j configuration, the log file could be up to 20Mb in size. If you have customised the log settings, the maximum size could be much larger still. Please check whether the email message has been successfully sent, and consult your email administrator if you need special provisions for this email message. Once you have submitted your support request, you will receive email updates about its progress. These emails will give you the support ticket number. You can view the status of your support request and add any additional information required by visiting the Atlassian Support System at any time. #### Raising a Support Ticket via the Internet If your Confluence instance is not configured with SMTP mail or your Confluence instance is not running, you can raise a support ticket via the Atlassian Support System: Create a zip of your Confluence logs to attach to the ticket. Refer to Working with Confluence Logs for information about the log files. If your problem concerns user management or performance, please take a look at the additional requirements in Requesting External User Management Support or Requesting Performance Support. If you do not already have a free Atlassian support account, create one here. Log in to https://support.atlassian.com and select 'Create New Issue'. Lodge a detailed description of your problem in the new support ticket. Fill in all applicable information about your system, such as application server, database, etc. If Confluence is running, go to the 'System Information' screen in your Administration Console and copy the text of your system information into the ticket. Once your ticket is lodged, wait to be notified by email of updates. If your production instance of Confluence is experiencing a critical problem, jump on Live Support and ask to have your issue reviewed immediately. ## Logging a Bug Report If you have found a bug, the easiest way to report it is to: Create numbered instructions on how to reproduce the bug. Log them as a support request. The Atlassian support team will confirm your bug and lodge a bug report. Alternatively, you can log a bug report directly by confirming it according to these instructions: #### STEP 1. Check your Bug is Undiscovered Visit the Confluence bug tracker. On the left under 'Text Search', type keywords for your problem into the Query field. Click View and browse the summaries of the unresolved bugs. If any summary appears to describe your problem, check that the bug is not a match. If it is the same, you may wish to set a watch to be notified of updates or apply your vote towards having it resolved. If the problem does not already appear to have been logged, the next step is to confirm that the problem is a bug. #### STEP 2. Confirm the Bug Check the headings below. If one of the headings matches your problem, follow the instructions. If the problem does not fall under any category, follow the general instructions instead. ##### Bug Affects Page Rendering or Content If you are having issues with Wiki Markup or page content not being shown as expected: Create a new page in the Confluence Sandbox and try to duplicate the issue there. If the problem recurs, log the new bug here. Paste the web address (URL) of the Sandbox page along with the process you used to duplicate the problem. If the issue does not occur, this is may not be a bug and you should log the problem as a support request instead. ##### Bug Prevents Confluence from Starting Please lodge a support request with your configuration information and numbered instructions on how to reproduce the issue. ##### Bug in External User Management Please lodge a support request with your user management configuration and numbered instructions on how to reproduce the bug. ##### General Bug Confirmation If Confluence will not run, please log the problem as a support request instead. Attempt to replicate the bug: Download the latest version of Confluence Standalone. Install the Standalone with the appropriate database and the demonstration site. Try to duplicate your problem on the default setup with the demonstration data. If the issue does not occur, you should open a support ticket. If the issue does occur, log the new bug here along with the information you used to duplicate it. Once your issue is lodged, wait to be notified by email of updates. If your production instance of Confluence is experiencing a critical problem, jump on Live Support and ask to have your issue reviewed immediately. ##### 500 page Sometimes it may be useful to include the result of the `500page.jsp`
    https://<domain><host>:<port>/500page.jsp
##### RELATED TOPICS General Support Enquiries Requesting External User Management Support Requesting Performance Support Feature Requests Configuring the Site Support Address Site Configuration Attachments: SupportRequestForm.png (image/png)

Document generated by Confluence on Nov 05, 2009 23:36