Casebox has some prerequisites that usually are installed under root privileges on a Linux server (we use CentOS)
Make sure this software is installed and running. Notice: we advise using the latest versions available for all software below
Optionally, you can install:
We recommend to use Git instead of downloading Casebox from GitHub. It will allow you to easily update Casebox when new versions are released
We use /var/www/casebox/.
The /CB/ notation is used to denote the folder where Casebox is extracted. In our example /CB/install/ translates to /var/www/casebox/install/
CB folder should have correct user/group. Usually it's the webserver user/group. The default for Apache HTTPD server is apache/apache. Chown the folder recursively, in our example the webserver runs under apache user/group:
Run /CB/bin/install.php script. Assuming we're in /CB/ folder:
The script will ask you for the MySql user/pass, prefix for mysql&solr databases, admin email. It will create a global /CB/httpsdocs/config.ini for all CB cores.Casebox is designed for SAAS deployment model, one physical instance on the server can serve many separate cores. A core is represented by a MySql database, SOLR core and a separate folder on the server for file storage. CB configuration will use two MySql users:
The install script will ask you the URL of the website, you can use https://127.0.0.1/, real server IP or a domain name.
At the end of CB instalation, you can create a core using the empty CB core that comes with CB (it has only the most important content types like folder/file/task).Now you need to enable CB virtualhost in Apache config.
Use /CB/install/httpd/ssl_casebox.conf as an example how to add Casebox virtualhost. ssl_casebox.conf includes SSL certificates. Casebox comes with self-generated certificates at /CB/install/httpd/ssl/. You may also run Casebox under normal HTTP if you wish.
Make sure apache module mod_rewrite is enabled.
Restart apache server and try to access the URL of your CB core. Example: https://127.0.0.1/test/
Casebox uses LibreOffice to generate .doc, .odt, .ppt file previews (it converts them into HTML). If you need Office file preview feature, you should install LibreOffice. On Windows, download&install LibreOffice.
On Linux, use this guideline. to install the latest stable LibreOffice from RPMs
Launch unoconv from /CB/httpsdocs/libx/:
Notifications by email of task creating/completion, converting .DOC to text, fulltext indexing: these processes are done by cronjobs.
See /CB/install/cron/readme.txt for instructions: you need to edit the crontab of httpd user/group and add the following scrips:
In future versions of CB, the install script will take care of this.