Atlassian/Confluence

From Omnia
Jump to navigation Jump to search

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

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=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."




  • 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:

ordered list start number

There's a rather awkward workaround for continuing a numbered lists.

  1. Create as many fake list items as you need to get to the number you want next.
  2. Open the page in the Source Editor.
  3. Set style="visibility: hidden;line-height: 0.0px;font-size: 0.0px;" on those fake list items.


References:

Keywords