Atlassian Confluence Sitemap Generator Add-On

Transcription

1 Atlassian Confluence Sitemap Generator Add-On Installation and Configuration Version 2017 Summer Release Status: March 27, 2017

2 Copyright Mindbreeze GmbH, A-4020 Linz, All rights reserved. All hardware and software names used are registered trade names and/or registered trademarks of the respective manufacturers. These documents are highly confidential. No rights to our software or our professional services, or results of our professional services, or other protected rights can be based on the handing over and presentation of these documents. Distribution, publication or duplication is not permitted. The term user is used in a gender-neutral sense throughout the document. Atlassian Confluence Sitemap Generator Add-On 2

3 Contents 1 Introduction 4 2 Preparation 4 3 Installation 5 4 Configuration 6 5 Generating & Retrieving the Sitemap Generating the sitemap Retrieving the sitemap 9 6 Logfiles and Troubleshooting 9 Atlassian Confluence Sitemap Generator Add-On 3

4 1 Introduction The Mindbreeze Sitemap Generator add-on generates a sitemap of the Atlassian Confluence pages. The pages contained are restricted by rights of the user generating the sitemap. Additionally you can exclude pages using regular expressions. 2 Preparation The Remote API-Interface of Atlassian Confluence has to be enabled in order for the Mindbreeze Sitemap Generator add-on to work. Activate at: Further Configuration > Remote API (XML-RPX & SOAP) Atlassian Confluence Sitemap Generator Add-On 4

5 3 Installation Install the add-on using Manage add-ons and Upload add-on : Important: There are different Plugin versions available (for Confluence 5.1, for Confluence 5.6 or higher). Please make sure to use the Plugin Version corresponding to your Confluence Version. Choose the file sitemap-generator-<version number>.jar in the Plugin folder of the Web Connector and submit using the Upload button: The add-on installation is finished: Atlassian Confluence Sitemap Generator Add-On 5

6 4 Configuration Use the Configure button to change the settings of the Mindbreeze Sitemap Generator add-on: Atlassian Confluence Sitemap Generator Add-On 6

7 Sitemap Generating User: Atlassian Confluence user, used to generate the sitemap. Default: admin Sitemap Downloader Group: Only members of the given Atlassian Confluence group are allowed to download the sitemap. Default: confluence-users ACL Encryption Password: A password used for encrypting the ACL elements. If this parameter is left empty, the ACL elements will not be encrypted. Confluence Base URL: the base URL that should be used for generating the links in the sitemap. Sitemap Cache Directory: A directory where the generated sitemap.xml is stored on the Atlassian Confluence Server. Use ACL Size Optimization: Optimizes the ACL-Size in the Sitemap. ACL Exempt Group Name (ex. confluence-administrators): Group that has read-access to all Confluence Content regardless of the explicit rights. Inspect Space with ID: Restrict trace level logging to a given space. For debugging/diagnose purposes only. 5 Generating & Retrieving the Sitemap 5.1 Generating the sitemap After a successful installation of the Atlassian Confludence Sitemap Generator Add-on, the sitemap can be generated with a scheduled job. To set up the sitemap generator job navigate to the Confluence Admin interface to the section Scheduled Jobs Atlassian Confluence Sitemap Generator Add-On 7

8 The sitemap generator job can be started automatically according to a given schedule. This schedule can be specified using standard cron expressions by clicking on the Edit action of the scheduledjob.desc.mindbreezegeneratesitemapjob. Atlassian Confluence Sitemap Generator Add-On 8

9 The sitemap generator job can also be started manually by clicking on the Run action. 5.2 Retrieving the sitemap After the sitemap generator job has completed the sitemap is available using the following URL: <confluence_url>/plugins/servlet/sitemapservlet?jobbased=true. Here <sitemap_url> is the base URL of the Atlassian Confluence server. 6 Logfiles and Troubleshooting You can configure the log-level for the Atlassian Confluence Sitemap Generator Add-On at Administration -> Logging and Profiling. Create a new Entry for the Class/Packet name: com.mindbreeze.enterprisesearch.connectors and select the log-level. Atlassian Confluence Sitemap Generator Add-On 9

10 The logfiles are available at the folloging path: <Confluence Home>/logs/atlassian-confluence.log Atlassian Confluence Sitemap Generator Add-On 10