modified on 7 May 2009 at 10:44 ••• 2,823 views

OpenCATS Installation

From OpenCATS

Jump to: navigation, search

Installation Instructions


OpenCATS Installation Procedure Last Revised: --CATSAdmin 09:27, 6 May 2009 (UTC)

Contents

Requirements

  • Linux, FreeBSD or Windows NT-based (2000, XP, 2003, Vista) Operating System
  • A working LAMP environment
  • The Antiword, PdfToText, html2text, and UnRTF document indexing tools

Instructions on configuring a LAMP environment and setting up the document indexing packages are included under the sections "C) New Installation (Unix/Linux)" and "E) New Installation (Windows)".


New Installation (Unix/Linux) - Quick

This "quick install" section is only intended for advanced users and users that have installed CATS before and just need a quick overview. New users and non-advanced users are advised to read the in depth install instructions in part C) New Installation - In Depth instead of this section.

1) Unpack the tarball into the web directory (/var/www/html, /usr/local/apache2/htdocs, or similar). Make a symlink to cats-0.9.1/ or rename the cats-0.9.1/ directory to cats/. 2) Start MySQL as the root user and create a new database and username. 

mysql> CREATE DATABASE cats;
mysql> GRANT ALL PRIVILEGES ON `cats`.* TO 'cats'@'localhost' IDENTIFIED BY 'password';

3) Make sure that the web server has permission to write to the attachments directory. 

chown apache:apache cats
chown -R apache:apache cats-x.x.x/
chmod 770 cats/attachments

4) Visit installwizard.php from a browser to invoke the installer. * 5) Follow the on-screen instructions.

  • Tip: If the installer does not load, check to see if there is a file called 'INSTALL_BLOCK' in the CATS directory. Delete it to allow the installer to be executed.


New Installation (Unix/Linux) - In Depth

THESE INSTRUCTIONS ARE FOR USERS OF A LINUX OR UNIX OPERATING SYSTEM. For installation instructions for Windows, read part E) Installation Instructions (Windows)

Prerequisites:

To install GD2 under Ubuntu, execute: 

sudo apt-get install php5-gd

For instructions on downlading and installing Antiword, PdfToText, html2text, and UnRTF visit:

NOTE: OUTDATED URL http://www.catsone.com/resumeIndexingSo ... e=&os=LIST

1) Unpack tarball (cats-0.9.1.tar.gz) under your apache document root (/var/www/html, /usr/local/apache2/htdocs, /cygdrive/c/wamp/www, or similar) and create a symlink to it named 'cats': 

cd /var/www/html
tar zxvf cats-0.9.1.tar.gz
ln -s cats-0.9.1 cats

2) Launch MySQL client and create a new database and user. 

mysql -uroot -p
mysql> CREATE DATABASE cats;
mysql> GRANT ALL PRIVILEGES ON `cats`.* TO 'cats'@'localhost' IDENTIFIED BY 'password';
mysql> EXIT;

3) Change ownership of the installation directory to the user and group that your web server runs under. This is usually 'apache', 'nobody', or 'www' (you can do a ps -auxww to see what user your web server is running as). 

 chown apache:apache cats
 chown -R apache:apache cats-x.x.x/
 chmod 770 cats/attachments

4) Preform any necessary apache configuration changes so that the installation is accessible from a web browser (aliases, virtual hosts, etc.). See apache documentation for how to do this.

5) In a web browser, visit the CATS installer page inside the cats web directory to finish the installation process: *

http://mydomain.com/cats/installwizard.php

(Replacing 'mydomain.com' with your domain name, or the ip address of your server)

  • Tip: If the installer does not load, check to see if there is a file called 'INSTALL_BLOCK' in the CATS directory. Delete it to allow the installer to be executed.

6) Follow the installer directions to complete the installation.

If any tests do not pass, check your configuration and requirements fulfillment and refresh the page (hold down shift while refreshing for Firefox and IE to ensure a refresh). You may visit the forum on http://www.opencats.org/ for support.

7) CATS should now be up and running.



D) Upgrading from an Earlier Version (Unix/Linux) - In Depth

THESE INSTRUCTIONS ARE FOR USERS OF A LINUX OR UNIX OPERATING SYSTEM. For installation instructions for Windows, read part F) Upgrading from an Earlier Version (Windows)

1) Unpack tarball (cats-0.9.1.tar.gz) under your apache document root (/var/www/html, /usr/local/apache2/htdocs or similar). 

cd /var/www/html
tar zxvf cats-0.9.1.tar.gz

2) Back up the 'cats' database by issuing the following command at your shell prompt: 

# mysqldump -uroot -p cats > ~/cats-backup.sql
(enter the password you created for the 'cats' user during install when prompted to do so)

Please note that this backup can not be restored by the interactive CATS installer - it is a failsafe incase the upgrade fails and the database becomes corrupt. If you later need to restore the database from this backup, you can issue the command: 

mysql -uroot -p cats < ~/cats-backup.sql

3) Remove the 'cats' symlink (DO NOT USE rm -rf; this would delete all of your attachments. USE rm WITH NO COMMAND LINE OPTIONS!): 

rm cats

4) Copy the attachments/ directory from cats-x.x.x/ to cats-0.9.1/:

Linux: 

cp -p -r cats-x.x.x/attachments/ cats-0.9.1/

FreeBSD: 

cp -p -R cats-x.x.x/attachments/ cats-0.9.1/

Where x.x.x is your older version number of CATS.

5) Create a symlink to the cats-0.9.1 directory: 

ln -s cats-0.9.1 cats

6) Change ownership of the installation directory to the user and group that your web server runs under. This is usually 'apache', 'nobody', or 'www' (you can do a ps -auxww to see what user your web server is running as). 

chown apache:apache cats
chown -R apache:apache cats-0.9.1/

7) In a web browser, visit the CATS installer page inside the cats web directory to finish the installation process: *

http://mydomain.com/cats/installwizard.php

(Replacing 'mydomain.com' with your domain name, or the ip address of your server)

  • Tip: If the installer does not load, check to see if there is a file called 'INSTALL_BLOCK' in the CATS directory. Delete it to allow the installer to be executed.

8) Follow the installer directions to complete the installation. Your database schema will be upgraded automatically.

If any tests do not pass, check your configuration and requirements fulfillment and refresh the page (hold down shift while refreshing for Firefox and IE to ensure a refresh).

New Installation (Windows)

Prerequisites:

- OR (Power Users) -

Installation instructions are given for the WAMP environment only.

1) Open tarball (cats-0.9.1.tar.gz) under WinRAR and extract all files to c:\wamp\www (or your web server's document root folder).

2) Launch phpMyAdmin by clicking on the WAMP icon in your system tray and selecting phpMyAdmin. A web browser will open. In the page that displays, type 'cats' into the textbox under Create new database and click the Create button.

3) Enable GD2 by clicking on the WAMP icon in your system tray and selecting 'PHP settings' followed by 'PHP extensions', and selecting 'php_gd2'.

4) Bring your WAMP server online by clicking on the WAMP icon in your system tray and selecting 'Put Online'.

5) In a Web Browser, visit http://localhost/cats-0.9.1/ . If CATS has been configured correctly, you should see a page that says:

CATS has not yet been installed, or a previous installation was not completed. Please visit the Installation Wizard to continue.

Follow the link to the Installation Wizard to complete installation. When asked for database name, user, and password use database 'cats', user 'root', and a blank password.

Upgrading from an Earlier Version (Windows)

1) Open tarball (cats-0.9.1.tar.gz) and extract all files to c:\wamp\www (or your web server's document root folder).

2) Launch phpMyAdmin by clicking on the WAMP icon in your system tray and selecting phpMyAdmin. A web browser will open.

On the dropdown menu under Database on the left, Choose 'cats'.

Select the 'Export' tab.

Check 'Save as File' at the bottom of the window and press 'Go'. Download and put the resulting SQL file somewhere safe on your computer. you will need this file to restore your database in the event something goes wrong during the upgrade process.

3) Copy the attachments folder from your previous installation of CATS into your new installation of CATS. For example, if you installed CATS 0.8.0 in c:\wamp\www\cats-0.8.0, move c:\wamp\www\cats-0.8.0\attachments to c:\wamp\www\cats-0.9.1\attachments.

4) In a Web Browser, visit http://localhost/cats-0.9.1/ . If CATS has been configured correctly, you should see a page that says:

CATS has not yet been installed, or a previous installation was not completed. Please visit the Installation Wizard to continue.

Follow the link to the Installation Wizard to complete installation.

Advanced CATS Add-ons

For advanced users, CATS has a few special features which can be manually installed.

1) Sphinx Indexing [ http://www.sphinxsearch.com/ ]: CATS can integrate with the advanced Sphinx to dramatically improve the speed which indexed documents are searched (more than 200x speed improvement). To learn how to integrate with the Sphinx engine, visit the Sphinx 'how-to' in the opencats.org wiki

2) Scheduled E-Mail reminders CATS can send out E-Mail reminders for calendar events before they happen. To enable this feature, configure cron or another scheduling daemon to invoke QueueCLI.php every minute. An example crontab line would look like: 

* * * * * /usr/local/bin/php /var/www/html/cats/QueueCLI.php

Or, 

* * * * * curl http://mysite.com/QueueCLI.php > /dev/null

3) CLI / On demand backups CATS can generate a backup from the command line on Unix systems. If the Unix zip utility is installed, then you can execute: 

php scripts/makeBackup.php 1

from the CATS root directory to generate a backup in scrips/backup/catsbackup.bak.

This, combined with a script to rotate backups which was executed from cron, could yield automated backups.

4) CATS attachments layout upgrade All new CATS attachments bury themselves a few more levels down in the attachments folder. If you are upgrading from a previous 0.7.1 installation of CATS and want CATS to reorganize your attachments folder to follow the new organization pattern, log in as an administrator and visit: 

ajax.php?f=install:attachmentsToThreeDirectory

H) Integration with Sphinx

As of CATS 0.9.1 Sphinx integration is available via separate package. Sphinx speeds up text-based database searches considerably.

Download URL: http://www.opencats.org/downloads/sphinx_for_cats.tar.gz


WEB HOSTING for OPENCATS

   Update by Jos on Tue May 06, 2008 8:00 pm
   For users who want to install CATS on a shared host, there is a big roadblock. You need to have shell access to install/configure the resume parsers. 
   If you do not have shell access, I recommend using a VPS or similar machine.



Note there are some webhosts who are skilled in accomodating the reuqirements for Opencats;
Are you having trouble finding a hosting company for opencats?
Need help installing and setting up your opencats
I Have a Solution For You
I own a hosting company called Universal Net Visions http://www.universalnetvisions.com
and we host people with opencats and the opencats is up and running great
We also have personal standing by to do the install, setup and upgrade for you
you can reach me throught email at jerimeolmstead@universalnetvisions.com , My msn is gutshot01@hotmail.com or  visite our site and get my cell number off the contact s page and well handle it from there
Thank you
Universal Net Visions
Todays Visions For Tomorrows Future
Owner and CEO
Jerime Olmstead
Retrieved from "http://www.opencats.org/documentation/OpenCATS_Installation"