History: Tiki on ClearOS

Some messy notes to help make a nice clean page at: http://www.clearfoundation.com/docs/howtos/Tiki_Wiki_CMS_Groupware

Install ClearOS

• Get latest stable version of ClearOS 6.x 64 bits

yum --enablerepo=clearos-updates-testing upgrade

New Beta Tiki installer

Later, Tiki will be in ClearCenter marketplace

Limitations:

• Only one Tiki can be installed per ClearOS instance.
• There is way to upgrade (yet)
• Installed version is not always the latest available

For now:
To get Tiki 12.0 (and soon 12.2)

yum install app-tiki

At one point, this gave Tiki 12.2:

yum --enablerepo=clearos-updates-testing install app-tiki

You need to make sure HTTP and HTTPS ports are open in https://example.org:81/app/incoming_firewall

Go to Server -> Messaging and Collaboration -> Tiki Wiki CMS Groupware in the menu to complete the setup.

It's best to use the main domain or a subdomain, as if you use a subdirectory (ex.: example.org/tiki), you need to update your .htaccess for the RewriteBase setting.

Your Tiki will be installed at: /var/clearos/tiki/webroot/live

Notes 2014-05-21

• .htaccess is not working
• RewriteBase is giving an error in tiki-check.php if Tiki is not at the root

With ClearOS 6.6: yum install app-tiki
http://www.clearfoundation.com/docs/release_info/clearos_community_6.6.0/beta_1_release_information

Notes 2014-05-26 with latest 6.6 Beta1

• .htaccess looks OK when Tiki at the root
• When activating LDAP auth with 12.0: "Fatal error: require_once(): Failed opening required 'Net/LDAP2.php' (include_path='/var/clearos/tiki/webroot/live/vendor/bombayworks/zendframework1/library:/var/clearos/tiki/webroot/live/vendor/bombayworks/zendframework1/extras/library:/var/clearos/tiki/webroot/live/vendor/phpseclib/phpseclib/phpseclib:.:/usr/share/pear:/usr/share/php:/var/clearos/tiki/webroot/live/') in /var/clearos/tiki/webroot/live/lib/auth/ldap.php on line 14 " 12.2 resolves this
• https://developers.google.com/speed/docs/best-practices/payload?csw=1#GzipCompression should be activated, or an option

Notes 2014-06-08 with latest 6.6 Beta1

• I installed Tiki at the root domain. All is good with example.org/tiki-index.php, but if I go to example.org, I get the default page: Congratulations... your web server is running!
  • Deleting or renaming index.html in /var/www/html/ will solve this

Notes 2014-11-27 with latest 6.6 Beta2

• http://tracker.clearfoundation.com/view.php?id=2049
• http://www.clearfoundation.com/docs/release_info/clearos_community_6.6.0/beta_2_release_information

The instructions below are for a manual install

Manual install

See also general Tiki docs and notes

Configure Web Server

1. Install PHP web server and MySQL in ClearCenter marketplace
2. Visit Server -> Web Server and click "Configure Default Site"
3. Todo: If firewall is activated, add a note to the user about adding HTTP & HTTPS traffic at app/incoming_firewall -> http://tracker.clearfoundation.com/view.php?id=1833
4. Pick domain name for your sites
   • If you expect to have more than one Tiki, you may want to use a subdomain like wiki.example.org But normally, you can do it all in one Tiki using Workspaces
5. The default of the other setting are fine
   • However, as of 2014-12 .htaccess doesn't work and depends on http://tracker.clearfoundation.com/view.php?id=2049
6. Start your web server

• Ideally, we'd have PHP 5.5 -> http://www.clearfoundation.com/docs/howtos/upgrading_to_php_5.5.x with OPcache, but it still needs some work

Delete files created by ClearOS

Delete:

• /var/www/html/index.html
• /var/www/html/logo.png

If you don't remove, Tiki won't be visible from the root

Install SVN

http://www.clearfoundation.com/docs/howtos/subversion

Get Tiki code via SVN

cd /var/www/html/

Additional sites live at /var/www/virtual/example.org/

svn checkout https://svn.code.sf.net/p/tikiwiki/code/branches/12.x .

For other versions, see: Get code

Composer

When you visit your domain name (where Tiki is installed), you will get "Your Tiki is not completely installed because Composer" (if Tiki 11.x and up. So just follow instructions).

sh setup.sh

• You can accept all the defaults.
• You can ignore warnings "Ambiguous class resolution"

Tiki automatically adds an alias from _htaccess to .htaccess but ClearOS needs to be told to accept .htaccess -> http://tracker.clearfoundation.com/view.php?id=2049

Dependencies

Visit tiki-check.php to see if any dependencies are missing

If you get warnings from Composer, install them as follows

yum install php-dom
service httpd restart

This is also needed for BigBlueButton and others

yum --enablerepo=clearos-epel install php-pecl-zendopcache
 service httpd restart

yum --enablerepo=clearos-epel install php-mcrypt
 service httpd restart

Other settings

Compress CSS & JS

• Check all PageSpeed and ySlow
  • https://developers.google.com/speed/docs/best-practices/payload#GzipCompression

https://dev.tiki.org/item5502 (see comment)

Activate Apache KeepAlive

nano /etc/httpd/conf/httpd.conf 
service httpd restart

PHP Settings

• display_errors = On
• upload_max_filesize = 12M
• post_max_size = 12M
• memory_limit = 168M
• date.timezone = http://tracker.clearfoundation.com/view.php?id=1684
• default_charset = @Peter: shouldn't this be set to UTF-8?

These will later be overriden in .htaccess but for now, you can edit /etc/php.ini and restart apache ('service httpd restart')

MySQL settings

You may need to edit /etc/my.cnf to add:

max_allowed_packet = 16M

And restart MySQL

Create database

1. Server -> Database -> MySQL Server -> Start
2. Set MySQL root password

Go to phpMyadmin via ClearOS. (https://xxx.xxx.xx.xx:81/mysql/)
Click Users on top menu
Click Add user
Add a new user. Ex.: tiki
Host: localhost
Pick a secure password
And pick "Create database with same name and grant all privileges"

Use this information later in tiki-install.php

Importing data

If you are importing, you can use phpMyAdmin's import from disk feature. Upload your .sql backup file at /var/lib/phpMyAdmin/upload/

Use Tiki installer

Use your browser to visit where the files are and you should see the Tiki installer (tiki-install.php)

Options

Configure LDAP

This is optional. You can let Tiki do self-registration or have an admin manage users manually.

To configure with LDAP, see the Tiki section on: Tiki Suite LDAP

Block access to site

Normally, you can just use Tiki's authentication to protect a sites's data. But if you want to add an additional layer, you can use ClearOS's protection: https://example.org:81 -> Server -> Web Server -> Settings -> Require Authentication ( you need to create group & user separately) (so no need to create an htpasswd file)

Related links

• http://www.clearfoundation.com/docs/howtos/creating_a_clearos_module