youngmon/atlassian-qna huggingface dataset:
how to install confluence 6.3.1 on mac system?
Asked by Varughese Cherian:

Hi,

I have to install and run confluence 6.3.1 on mac book. Do we have step by step installation instructions?

I referred an old install doc and installed the package. Howeevr, running localhost throws the following error:

HTTP Status 500 - java.lang.IllegalStateException: Spring Application context has not been set {#toc-hId-1956777021}
====================================================================================================================

Would be great if I get some information regarding this error .


Answers:
author: Shannon S
body: Hello Varurghese!

Per our [Installing a Confluence Trial](https://confluence.atlassian.com/doc/installing-a-confluence-trial-838416249.html) guide:
> Apple Mac isn't supported for production sites, but if you're comfortable setting up applications on your Mac from scratch, you can download the `tar.gz` file and follow the instructions for [Installing Confluence on Linux from Archive File](https://confluence.atlassian.com/doc/installing-confluence-on-linux-from-archive-file-255362363.html) as the process is similar.

Since Mac OS X is not technically supported for production instances, this is the reason you weren't able to find a more up-to-date version of the documentation you discovered.

Let us know if you have any trouble following the linked process above!

Kind Regards,  
Shannon

comments: author: KSC
body: Is an OS X version planned? To work with a Windows VM is not my wish.


author: Nic Brough -Adaptavist-
body: No, so it's the same answer as Shannon gave - use the Linux download and guides.


author: Shannon S
body: Nic is correct. When running Confluence on Mac OS X you can use the Linux version. This is not officially supported as a production instance, but it will work in the same way. I have been running Confluence Server on my MacBook for years as a test instance, and I haven't run into any issues.

We do not have any plans currently to directly support macOS for Confluence Server, and you can read the reasoning in this feature request:

* [CONFSERVER-26319](https://jira.atlassian.com/browse/CONFSERVER-26319)

Let us know if you have any further questions!

Regards,

Shannon


author: Nic Brough -Adaptavist-
body: Why are you using an old install doc? It's likely to have given you inappropriate instructions and that's what is causing the error.

The most common cause of that error is that you've told it to use the wrong version of java, but it can be file permissions too, and some other things.

Neither of those will go wrong if you download and install 6.3.1 and follow the current installation guide.

comments: author: Varughese Cherian
body: Thanks, Nic. Yes, I used an old install doc. I have 6.3.1 but could not locate the current install guide :-(. Would be great if you can share the link to the latest install guide on Mac.


author: Nic Brough -Adaptavist-
body: When you click "download" on the download section, you're taken to a page with links to all sorts of guides on it, including the installation guide.


Tags: install

mac
What about global and private labels in Confluence?
Asked by Tobias Schramm:

When I try to add a label to a content page, where I can choose the type of label I want to add?

Some labels are marked as global and some are marked as private in different spaces. But where I can see the both options (if global or private) together? Do I have the choice to select a private or a global label only in a private space or on article, that is protected?

Thanks!


Answers:
author: Thomas Schlegel
body: Hi Tobias,

Atlassian deprecated personal labels in Version 4.1:

(<https://confluence.atlassian.com/doc/confluence-4-1-upgrade-notes-264705286.html?_ga=2.214689170.448558304.1501487689-1221546829.1499255503#Confluence4.1UpgradeNotes-Personallabelsdeprecated>)

They are still there, as far as I can see, but hidden and deprecated and can be gone with every new Confluence version, so I wouldn't use that feature anymore.

If you really want, you can still create them and look at your own personal labels as described here:

<https://confluence.atlassian.com/conf56/viewing-personal-labels-658737029.html>

comments: author: Tobias Schramm
body: Many thanks!


author: Nicholas Wade
body: 2022 November.

Confused.com Trying to work out what **Global Labels** refers to in the **Page Information**. The above answer seems to take me to some other kind of label that was deprecated some time ago?

I'm assuming that the current **Global Labels** refers to a label (**+Add label**) that is added to a template and is therefore 'Global'?

Otherwise, is **Global Labels** just a left-over from way back when?


author: John Corwith
body: There are pages in our Confluence 5.9.5 that won't allow me to add labels, the error I get is something about only being able to add private labels. I assume these were ported from 4.1 with some sort of config that needs to be disabled. Any clue?
Confluence API with jquery and json
Asked by Dawid Kowalski:

Hi,

I'm trying to connect with confluence API. My goal is to create page at choosen space using jqery with json and ajax. Here below is my code:

```
<html>

 <head>
 <title>Confuelnce API</title>
 //headers for jqery
 <script type = "text/javascript" src="js/jquery-3.2.1.min.js">
 <script type = "text/javascript">
 $(document).ready(function(){


//json data to push them to confluence
var data = {
 "type": "page",
 "title": "New Page 2",
 "space": {
 "key": "TST2"
 },
 "body": {
 "storage": {
 "value": "<p>This is a new page</p>",
 "representation": "storage"
 }
 }
};
//mylink
var link = 'http://localhost:8090/confluence/rest/api/content/';

$.ajax({
 url: link,
 type: "POST",
 dataType: "json",
 crossDomain: true,
 username: "myusername",
 password: "mypass",
 data: JSON.stringify(data),
 Accept: application/json, 
 contentType: "application/json",
 xhrFields: {
 "withCredentials": true
 },

 
 success: function (result) {
 alert('Data saved!');
 },
 error : function (xhr, status, error) {
 alert(status + ' | ' + error); 
 }
 
 
});
});
 </script> 
 </head>
 
 <body>
 <h1>jqery - confluence connection</h1>
 </body>
 
</html>
```

In browser console (google chrome) I have no errors but in confluence there is no "new page 2" page. Could someone study my code and get a little help to me because I have no idea what I'm doing wrong for now.

Thanks.


Answers:
author: Christo Mastoroudes _Adaptavist_
body: Hi,

I am not 100% sure about the code, but I think the line starting with Accept: should be someline like:

```
accepts: {        text: "application/json"    }
```

I am also wondering if you would need to trigger a re-index.
Confluence user unable to login
Asked by Alain Fontaine:

Hello,

I have a user who has access to both Jira and Confluence according to the user details. He can login and use Jira just fine, but gets this error when trying to use Confluence:

![Zrzut ekranu 2017-08-02 o 12.49.34.png](/t5/image/serverpage/image-id/3947i360E8039A226B9F2/image-dimensions/641x381?v=v2 "Zrzut ekranu 2017-08-02 o 12.49.34.png")

I did my best double-checking the permissions, and all looks well. Other similar users have no issues.

Where shall I look next?

Thanks!


Answers:
author: Nic Brough -Adaptavist-
body: Does the account have "can use confluence" as well as space permissions?

comments: author: Alain Fontaine
body: Hi,

Yes, it does have these - that's why I'm a bit lost. Is there no "audit trail" or similar that would allow to check a users permissions against the policies?


author: Nic Brough -Adaptavist-
body: Probably because Confluence's permissions are really simple - can log in, can do things in a space.

Next debugging questions -

1) Can you find the named person in the "users" list?

2) Is it possible to @mention them in a page?

3) Are you using google accounts, atlassian accounts or a SAML setup with Cloud to provide the users?


author: Alain Fontaine
body: Hello,

1. No, this user is not in the Confluence user listing, although he shows up under "User management".
2. No
3. Atlassian accounts

Thanks!


author: Nic Brough -Adaptavist-
body: Ok, if they're not on the list, and they can't be mentioned then they don't have the "can use confluence" rights.


author: Alain Fontaine
body: I positively confirm that this user is in the **confluence-users** group, and this user also shows up in the "Application access" screen as using one license for Confluence.


author: Alain Fontaine
body: Update : when I use "Login as \<user\>", this works for me - I have access to what this user should have access to. So, problem seems to appear only when this actual user logs in using his credentials.


author: AnnWorley
body: Alain, The Cloud Support team is asking that you open a ticket with them so they can dig into the specific user's account. They will need info you won't want to post here. Please open the case at <https://getsupport.atlassian.com>. Thanks!


author: Alain Fontaine
body: Will do, thanks Ann!
attachments
Asked by s rv:

on a page in confluence, i have added links to the PDF files which are user manuals. When i click open the link for the user manual, it opens up and when i access the TOC of the user manual the links of the TOC does not work?

can any one suggest me as to why this does not happen. is there a work around for this?


Answers:
author: AnnWorley
body: I would like to try it and see if I can reproduce the issue. I checked our bug tracking system and did not find a reported bug for TOC not working in pdf attachments.

Please let me know:

* Are you using Confluence Cloud
* If not Cloud, then what version of Confluence?
* Are you previewing the file or opening it in Adobe?
* If previewing, does it work in Chrome browser?
Gantt chart in Confluence macro - start/end dates & date labels not working
Asked by AmyG:

Using the information here: [https://confluence.atlassian.com/doc/chart-macro-163415075.html](https://confluence.atlassian.com/doc/chart-macro-163415075.html )

I created the attached gnatt chart.

![GnattMacro.JPG](/t5/image/serverpage/image-id/3929i3A19F17E9CFFDA89/image-size/large?v=v2&px=999 "GnattMacro.JPG")  
I keep getting "Requires end \>= start." if the dates are in the same year. A year out it works, but the date headings are nonsense.

* How do I get the dates to work in the same year without being told the end date needs to be greater than or equal to the start date (it is).
* How do I get the date columns at the top to be accurate?
* It would be great if you could give exacts to put in the parameters. I read through the Atlassian documentation, entered dates where I thought it made sense, and got the same results.

Many, many, many thanks in advance.


Answers:
author: ANki
body: Edit the Gantt chart settings Date to reflect capital letters for month - MM/dd/yyyy. This resolved the error for me.


author: Reg Hawkins
body: Check you date format


author: Andrey Khaneev _StiltSoft_
body: As a workatound you can try [Chart from Table](https://docs.stiltsoft.com/display/TableFilter/How+to+use+Chart+from+Table+macro#HowtouseChartfromTablemacro-Ganttchart) Gantt chart if you have [Table Filter and Charts](https://marketplace.atlassian.com/plugins/com.stiltsoft.confluence.plugin.tablefilter.tablefilter/cloud/overview) add-on installed.

comments: author: AmyG
body: I don't have the permissions to download any add-ons and the admis aren't likely to pay for it. Any idea how to get the out-of-the-box gnatt chart macro working as illustrated? Using Atlassian's documenation it doesn't render as expected (unusable). Any input is aprreciated!


Tags: chart

gantt
Export spaces and attachments
Asked by James Brown:

My confluence server has failed and i need to recover all of its content. Because I cant access the server through a browser only by ssh/ftp, is there a way to "export" all of the spaces/pages/attachments/etc" so that I can "import/move" it to a new confluence server?


Answers:
author: AnnWorley
body: We have two approaches available for this situation. Confluence automatically backs up everything except user installed plugins nightly by default in the \<confluence_home\>/backups directory. However, it's not an ideal strategy for a Production backup so it is frequently disabled.

If your database is not accessible to back up then Approach 1 is the best bet. Add-ons will have to be reinstalled after the restore.

Approach 1 is:

1. Retrieve the above mentioned backup file
2. Install the same version of Confluence the backup came from
3. Restore the backup through the UI
4. Install all user installed add-ons

Approach 2 is:

1. backup the elements described in [Production Backup Strategy](https://confluence.atlassian.com/doc/production-backup-strategy-38797389.html), basically the \<confluence_home\> and the database itself
2. install Confluence and point it at the backed up Home and DB as described in detail in [Migrating Confluence Between Servers](https://confluence.atlassian.com/doc/migrating-confluence-between-servers-184150.html)
Do i need a license for users that will only view the Pages
Asked by Gene Gretzer:

I only have a handful of users (9) that will make changes or add content to the pages (spaces). Do I need a Confluence license for all 900+ generic view only users? Each user will login to the PC with his or her own AD account. I can't see spending $18k for a mostly view only site.


Answers:
author: Nic Brough -Adaptavist-
body: If they log in, they need a licence.

But you can make your spaces accessible to "anonymous" - anyone who has not logged in is anonymous.

comments: author: Gene Gretzer
body: How do you make the space accessible to Anonymous?


author: Nic Brough -Adaptavist-
body: Look towards the last section on the "space permissions" settings page.

You'll also need to enable it globally.


author: Gene Gretzer
body: ok that worked. thanks!.. one more question...how can I make one particular space the default opening page?


author: Nic Brough -Adaptavist-
body: You can't quite do it with a space, but in General Configuration, you can change the "home" page from the dashboard to a specific page in a space.


author: Gene Gretzer
body: very cool! that also worked.thanks. .is there a setting to remove the left side pane as well?


author: Nic Brough -Adaptavist-
body: I've not tried to do that for a long time, you may need a "theme" to do it.


author: Shannon S
body: Hi [@Gene Gretzer](/t5/user/viewprofilepage/user-id/1143514)!

One more thing... if you open up Anonymous access be advised this means also that search engines can index your content. If you don't want this, and you're on Confluence Server, you'll want to [set up a robots.txt file](https://confluence.atlassian.com/pages/viewpage.action?_ga=2.85130781.541372882.1501487748-678533352.1500973771&spaceKey=DISC&title=Prevent+Search+Engine+Indexing+Using+Robots.txt).

Kind Regards,  
Shannon


author: Gene Gretzer
body: ok...will look at that..appreciate your help ;-)
Can you change Heading levels in the Table of Contents?
Asked by Shawn Wilson:

Usually, the Heading levels match the way they appear in the Table of Contents: Heading 1 is at the left margin, Heading 2 indented once, and so on.

Is there a way to break this pattern? Can I make a specific Heading 1 appear indented once, and the following Heading 2 indent twice?


Answers:
author: Shannon S
body: Hi Shawn,

In the [Table of Contents Macro](https://confluence.atlassian.com/doc/table-of-contents-macro-182682099.html), you have the ability to include the indent parameter which will allow you to increase the level of indent:
> Sets the indent for a **list** according to CSS quantities. Entering `10px` will successively indent heading groups by 10px. For example, level 1 headings will be indented 10px and level 2 headings will be indented an additional 10px.

Go ahead and give that a try and let us know if that helps you do what you need or if you have any trouble or questions.

Kind Regards,  
Shannon

comments: author: Shawn Wilson
body: This is interesting, but it's not what I'm looking for, because it affects ++all++ the entries. Let me explain better than before.

Right now my ToC looks like this:

* Topic A (Heading 1)
  * SubTopic A1 (Heading 2)
* Topic B (Heading 1)
  * SubTopic B1 (Heading 2)
  * SubTopic B2 (Heading 2)
* Topic C (Heading 1)
  * SubTopic C1 (Heading 2)

I'd like to change it to look like this:

* Topic A (Heading 1)
  * SubTopic A1 (Heading 2)
* Topic B (Heading 1)
  * SubTopic B1 (Heading 2)
  * SubTopic B2 (Heading 2)
  * Topic C (Heading 1)
    * SubTopic C1 (Heading 2)

Note that, in the body of the document, Topic C and SubTopic C1 are still using Heading 1 and 2, respectively.

Right now my workaround is to change the headings in the body, so that the Topic C heading is actually Heading 2, but LOOKS like Heading 1.


Tags: heading

table-of-contents
Find and Replace does not do anything/not working
Asked by Mitch Gann:

I hit Command + F while editing an existing page in Confluence. The 'Find and Replace' toolbar will drop down. I copy the exact bit of text that is on the page about 50 times. I hit 'Next'. Page will jump down but nothing is highlighted. I hit next again and nothing happens at all. Any successive clicks of next, previous, Replace, will do nothing. I dont want to have to restart confluence to get this basic functionality working again.


Answers:
author: Christoph Sch?tz
body: Hey have you ever fixed it by restarting Confluence? Is there anything in the logs? Have you tried different browsers?

Cheers

Christoph
Upgrading Confluence from 5.10.4 to 6.2.1
Asked by Ernie Jennings:

Upgrading Confluence Test server on Windows Server 2012.

I cannot access the site through the web browser. I get a this site can't be reached. Has anyone else had issues while upgrading to from version 5 to version 6?

Also a novice to Confluence, I don't totally understand the "***Upgrading configuration files after upgrading*** " and the ***re-apply any modifications*** . To me it's very vague. The instructions need to be more detailed. It states ***reapply and additions.* Whatadditions?**

If someone could help a struggling Confluence user, I would great appreciate it. Thanks


Answers:
author: Nic Brough -Adaptavist-
body: To answer the second part of the question (because Lars has got the first half spot on already):

\>Also a novice to Confluence, I don't totally understand the "***Upgrading configuration files after upgrading***"

It can't list any hacks you've made to your config, as it's your system. If you have not changed any of the config, you installed Confluence off-the-shelf, then you have nothing to do here. If you have made changes, you will need to validate them all (still needed? Right format for new version, etc) and re-apply the ones you do decide you need. The docs can't guess at what you might do!

(Frankly, most of us change the Tomcat connector to allow for a proxy and fiddle with the memory and logging a bit. Nothing huge)

comments: author: Ernie Jennings
body: Thanks


author: Lars Olav Velle
body: What does the log say?

-Lars
Can I make a page invisible while editing it?
Asked by Angelika Geissler:

I am creating a new page tree in confluence and I woud like to not make it visible while I am creating it. How can I do that? We dont have restrictions in who can see our confluence pages that we use. They are public.


Answers:
author: Nic Brough -Adaptavist-
body: The only way to hide a page is by restricting it. That would be onerous to do for every edit, and also unnerving for users, as their pages might vanish and re-appear apparently at random.

It does make sense to hide a set of pages when you are first creating them. The best way to do that is simple - have a "new stuff" page at the top of your space, and restrict it to yourself. Create everything you need underneath it, the top-level restriction will mean only you can see these pages. Get them ready, then simply move the whole lot to the right place in the public areas of your Space.

comments: author: John Corwith
body: If you restrict view/edit to yourself, why not just create it in the destination location?
HTML macro
Asked by Darrold Condino:

Hi Guys,

Need help - My admin already enabled the HTML for our confluence but still I can't find any HTML Macro in my confluence page.

Thanks for the support in advance.

-Darrold


Answers:
author: Shannon S
body: Hi Darrold,

If your admin has specifically enabled the **html (html-xhtml)** module found by expanding [Confluence HTML Macro](https://confluence.atlassian.com/doc/html-macro-38273085.html) under Add-ons, then besides selecting **Insert \> Other Macros** you can also try finding it by typing the following:

![Screen Shot 2017-08-02 at 11.27.32 AM.jpg](https://community.atlassian.com/t5/image/serverpage/image-id/3943iA27E0FB65634AF8D/image-dimensions/446x227?v=v2 "Screen Shot 2017-08-02 at 11.27.32 AM.jpg")

Can you let us know what happens when you try that?

Kind Regards,  
Shannon
Finer control of Confluence Roadmap Macro . . . ?
Asked by Troy S:

I would like to show a short term roadmap and the Confluence Roadmap macro looked like a good option to show the timeline of events.

We have some awareness training required by all staff to take. I want to visually show the start and end dates, dates that email reminders will be sent out to all staff. The training will take two months to complete.

I tried to add a marker for the start date and end date, but I cannot seem to control or determine what date marker is set.

I see that I can set the view to Weeks and Months. I would actually like to set this field to days.

If the RoadMap macro is not the correct widget to use, is there something else I should be using?

Thanks,


Answers:
author: Daniel Eads {unmonitored account}
body: Hi Troy,

There's an [open feature request for the Roadmap macro to get as granular as days](https://jira.atlassian.com/browse/CONFSERVER-40412). Watch/vote on that issue if you'd like to see Atlassian develop it!

As for moving markers around - if you hover over the marker itself or the label for it, the cursor changes to a mover/hand and lets you "click and hold" to drag the marker to where you'd like it to go.

![image.png](https://community.atlassian.com/t5/image/serverpage/image-id/3892iD28F5A31D0E81D3F/image-size/large?v=v2&px=999 "image.png")

If you need significantly more detail in a tighter space, something like Gliffy, draw.io, or LucidCharts (a swimlane diagram) might be necessary. It's more complicated to do something like this as an actual diagram, but will give you additional flexibility if you find week view is too "small" with the Roadmap Planner macro.


Tags: roadmap
Why am I receiving duplicate email notifications from Confluence for a single update
Asked by Sheng Tan:

I'm using MS Outlook as my email and the duplicate email comes in a minute or 2 later. I saw something about a "test email" you guys have. How do I use that?

Thanks!


Answers:
author: Christoph Sch?tz
body: Hey - should be in the general configuration under mail server - there you should find a button to send a test email.

Cheers

Christoph