Atlassian/Confluence
Atlassian Confluence
Enterprise Collaboration and Wiki Software - Confluence - http://www.atlassian.com/software/confluence/
- Less Email. Fewer Meetings. Better Results.
- One place for technical teams to collaborate—create, share, and discuss your ideas, files, minutes, specs, mockups, diagrams, and projects.
- A rich editor, deep Office and JIRA integration, and powerful plugins help teams collaboratively develop technical docs, intranets, and knowledge bases.
Wiki Codes
Color
{color:red}RED COLOR{color}
User Name
[~someuser]
Typing @some.. will convert it to [~someuser]
Heading Levels
h1. Level 1 Large ... h3. Level 3 h4. Level 4 Small
Symbols
(!) = yellow warning (/) = green check (x) = red x
Page Tree
{pagetree} # from root {pagetree:root=@self} # from self {pagetree:startDepth=5|root=@self} # open up 5 levels to start with
No Format
{noformat}...{noformat}
Quote
{quote}...{quote}
Table
||Server||ESX Version|| |x3850x5-02|ESXi 5.0 UPDATE 1| |10.30.5.67|ESXi 5.0 UPDATE 1| |10.30.5.69|ESXi 5.0 UPDATE 1|
Panel
{panel} Some text {panel}
{panel:title=Some Title} Some text {panel}
{panel:title=Some Title|bgColor=#FFFFCE} Some text {panel}
Standalone Installation
4.0.3
- Confluence Installation Guide - http://confluence.atlassian.com/display/DOC/Confluence+Installation+Guide
- Installing Confluence on Linux - http://confluence.atlassian.com/display/DOC/Installing+Confluence+on+Linux
Perform as root:
sudo su -
Install dependencies:
yum install mysql mysql-server
Install Java:
cd /opt wget ???/jdk-6u23-linux-i586.rpm rpm -Uvh jdk-6u23-linux-i586.rpm ln -s /usr/java/jdk1.6.0_23 java
Install Confluence:
cd /opt/ wget http://www.atlassian.com/software/confluence/downloads/binary/atlassian-confluence-4.0.3.tar.gz tar -zvxf atlassian-confluence-4.0.3.tar.gz ln -s atlassian-confluence-4.0.3 wiki
Confluence Data:
cd /opt/ mkdir wiki-data
Edit /opt/wiki/confluence/WEB-INF/classes/confluence-init.properties
dos2unix /opt/wiki/confluence/WEB-INF/classes/confluence-init.properties cat >> /opt/wiki/confluence/WEB-INF/classes/confluence-init.properties <<"EOF" confluence.home=/opt/wiki-data EOF
Change listening port: /opt/wiki/conf/server.xml (modify both ports 8000 and 8090) - OPTIONAL
<Server port="8000" shutdown="SHUTDOWN" debug="0"> ... <Connector className="org.apache.coyote.tomcat4.CoyoteConnector" port="8090" minProcessors="5"
<Server port="8101" shutdown="SHUTDOWN" debug="0"> ... <Connector className="org.apache.coyote.tomcat4.CoyoteConnector" port="8001" minProcessors="5"
Fix Java location:
cat >> /opt/wiki/bin/setenv.sh <<"EOF" export JAVA_HOME=/opt/java EOF
Startup:
cd /opt/wiki/bin ./start-confluence.sh
Wait for this message in logs/catalina.out:
******************************************************* ... You can now access Confluence through your web browser. *******************************************************
Shutdown:
cd /opt/wiki/bin ./stop-confluence.sh
3.5.9 installation
- Confluence Installation Guide - Confluence 3.5 - Atlassian Documentation - Confluence - http://confluence.atlassian.com/display/DOC/Confluence+Installation+Guide
- Installing Confluence Standalone - Confluence 3.5 - Atlassian Documentation - Confluence - http://confluence.atlassian.com/display/DOC/Installing+Confluence+Standalone
CONFLUENCE=confluence-3.5.9-std cd /opt/ wget http://www.atlassian.com/software/confluence/downloads/binary/$CONFLUENCE.tar.gz tar -zvxf $CONFLUENCE.tar.gz ln -s $CONFLUENCE confluence ln -s $CONFLUENCE wiki
Java:
wget http://???/jre-6u26-linux-i586.rpm rpm -Uvh jre-6u26-linux-i586.rpm
Home directories: (facilitate upgrades)
cd /opt/ mkdir confluence-data
/opt/confluence/confluence/WEB-INF/classes/confluence-init.properties:
confluence.home=/opt/confluence-data
cat >> /opt/confluence/confluence/WEB-INF/classes/confluence-init.properties <<"EOF" confluence.home=/opt/confluence-data EOF dos2unix /opt/confluence/confluence/WEB-INF/classes/confluence-init.properties
Change listening port: conf/server.xml (modify both ports 8000 and 8080)
<Server port="8000" shutdown="SHUTDOWN" debug="0"> <Connector className="org.apache.coyote.tomcat4.CoyoteConnector" port="8080" minProcessors="5" # to... <Server port="8102" shutdown="SHUTDOWN" debug="0"> <Connector className="org.apache.coyote.tomcat4.CoyoteConnector" port="8002" minProcessors="5"
Startup:
cd bin ./startup.sh
Apache /etc/httpd/conf.d/virtual.conf:
NameVirtualHost *:80 <VirtualHost *:80> ServerName wiki.oeey.com ServerAlias confluence.oeey.com ProxyRequests Off ProxyPreserveHost On ProxyPass / http://localhost:8002/ ProxyPassReverse / http://localhost:8002/ ServerAdmin website@oeey.com ErrorLog logs/wiki-error_log CustomLog logs/wiki-access_log common </VirtualHost>
Configure:
http://localhost:8080/ (Use for first time database setup, to avoid proxy error) http://wiki.oeey.com
Browse -> Confluence Admin -> General Configuration ->Server Base Url
WAR Installation
Installing the Confluence EAR-WAR Edition - Confluence 4.2 - Atlassian Documentation - Confluence - https://confluence.atlassian.com/display/DOC/Installing+the+Confluence+EAR-WAR+Edition
Database
WC Config
[mysqld] # ... ## CONFLUENCE # performance tuning: #query_cache_size=16777216 query_cache_size = 16M query_cache_type = 1 #query_cache_limit=1048576 query_cache_limit = 1M max_allowed_packet = 100M default-storage_engine = INNODB # character sets default-collation=utf8_bin character-set-server=utf8 collation-server=utf8_bin default-character-set=utf8 ## CONFLUENCE
4.x
Configured through GUI.
Set database to InnoDB and Character-set to utf8;
/etc/my.cnf:
[mysqld] ### InnoDB Settings # performance tuning: #query_cache_size=16777216 query_cache_size = 16M query_cache_type = 1 #query_cache_limit=1048576 query_cache_limit = 1M max_allowed_packet = 100M default-storage_engine = INNODB # character sets default-collation=utf8_bin character-set-server=utf8 collation-server=utf8_bin default-character-set=utf8
Restart mysql:
service mysqld restart
Create database:
mysql> CREATE DATABASE confluence; GRANT ALL PRIVILEGES ON confluence.* TO 'confluence'@'localhost' IDENTIFIED BY 'confluence'; flush privileges;
JDBC Datasource:
Driver Class Name: com.mysql.jdbc.Driver Database URL: jdbc:mysql://localhost/wiki?autoReconnect=true&sessionVariables=storage_engine%3DInnoDB
3.5
Database Setup For MySQL - Confluence 3.5 - Atlassian Documentation - Confluence - http://confluence.atlassian.com/display/DOC/Database+Setup+For+MySQL
Written during installation:
[CONFLUENCE_DATA]/confluence.cfg.xml:
<property name="hibernate.c3p0.acquire_increment">1</property> <property name="hibernate.c3p0.idle_test_period">100</property> <property name="hibernate.c3p0.max_size">30</property> <property name="hibernate.c3p0.max_statements">0</property> <property name="hibernate.c3p0.min_size">0</property> <property name="hibernate.c3p0.timeout">30</property> <property name="hibernate.connection.driver_class">com.mysql.jdbc.Driver</property> <property name="hibernate.connection.isolation">2</property> <property name="hibernate.connection.password">confluence</property> <property name="hibernate.connection.url">jdbc:mysql://localhost/confluence?autoReconnect=true&sessionVariables=storage_engine%3DInnoDB</property> <property name="hibernate.connection.username">confluence</property> <property name="hibernate.database.lower_non_ascii_supported">true</property> <property name="hibernate.dialect">com.atlassian.hibernate.dialect.MySQLDialect</property> <property name="hibernate.setup">true</property>
Post Installation
Server Base Url
- Browse - Confluence Admin - General Configuration - Server Base Url
http://wiki.oeey.com
Change Welcome Message
- Browse - Confluence Admin - General Configuration - Site Welcome Message
h2. Welcome to Confluence Confluence combines powerful online authoring capabilities, deep Office integration and an extensive plugin catalogue to help people work better together and share information effortlessly. Get started by [adding a new space|http://docs.atlassian.com/confluence/docs-35/Setting+up+a+New+Global+Space] to create content in. [Add a few users|http://docs.atlassian.com/confluence/docs-35/Adding+a+New+User] to try out Confluence with you. If you want to display a different message here, you can easily [change the welcome message|http://docs.atlassian.com/confluence/docs-35/Editing+the+Site+Welcome+Message].
not configured a mail server
"You have not configured a mail server. Mail notifications will not work properly."
- "Warning: Your Confluence installation is currently configured to run automatic backups. We do not recommend the automatic backup procedure for production installations, as it may require a large amount of memory, CPU and disk space.
- Instead, we recommend that you perform a manual backup of your Confluence database, home directory and attachments. For more information, please refer to our online documentation.
- Once you have set up a daily manual backup procedure, you should disable Confluence's automatic backup by going to Administration > Scheduled Jobs and disabling the Back Up Confluence job."
- Change Welcome message - http://docs.atlassian.com/confluence/docs-35/Editing+the+Site+Welcome+Message
- Setting up a New Global Space - http://confluence.atlassian.com/display/DOC/Setting+up+a+New+Global+Space
- Browse - Confluence Admin - General Configuration - Server Base Url
User Count
- "Number of users and your license. The Confluence 'License Details' screen tells you how many users your Confluence instance is licensed to support, and how many are currently registered. The number of registered users includes only users who have the 'Can Use' global permission. Deactivated users, as described above, are not included." [1] [2]
Wiki Markup Editor Removed
Why We Removed the Wiki Markup Editor in Confluence 4.0 | Atlassian Blogs - http://blogs.atlassian.com/2011/11/why-we-removed-wiki-markup-editor-in-confluence-4/
"Atlassian’s decision to remove Wiki Markup in Confluence 4.0"
Issues
decorator root
When adding spaces:
java.lang.RuntimeException: Error rendering template for decorator root at com.atlassian.confluence.setup.velocity.ApplyDecoratorDirective.render(ApplyDecoratorDirective.java:205)
Solution:
- Restart Confluence
- http://confluence.atlassian.com/display/CONFKB/%27java.lang.RuntimeException+-+Error+rendering+template+for+decorator+root%27+when+Accessing+a+Page+Due+to+Null+Page+Titles
- update CONTENT set title = 'no title' where title is null AND contenttype = 'PAGE';
- http://confluence.atlassian.com/display/DOC/Content+Index+Administration#ContentIndexAdministration-RebuildingtheContentIndexes
ordered list start number
There's a rather awkward workaround for continuing a numbered lists.
- Create as many fake list items as you need to get to the number you want next.
- Open the page in the Source Editor.
- Set style="visibility: hidden;line-height: 0.0px;font-size: 0.0px;" on those fake list items.
References:
- [CONF-1208] Add ability to start a numbered list at a specific starting value - Atlassian JIRA - https://jira.atlassian.com/browse/CONF-1208
- [SOURCE-84] OL start attribute is ignored - Atlassian JIRA - https://jira.atlassian.com/browse/SOURCE-84