Table of Contents

• Requirements

• Installing OpenDocMan

  • Things You Need to Do to Install OpenDocMan

  • 5 Minute Install

Requirements

• Web Server (Apache preferred, but may also work on IIS and others)

• PHP 5

• MySQL 5

Installing OpenDocMan

Things You Need to Do to Install OpenDocMan

1. Check to ensure that you and your web host have the minimum requirements to run OpenDocMan.

2. Download the latest release of OpenDocMan.

3. Unzip the downloaded file to a folder inside your web server.

4. Print this page out so you have it handy during the installation.

5 Minute Install

Here's the quick version of the instructions, for those that are already comfortable with performing such installations. More detailed instructions follow.

1. Download and unzip the OpenDocMan package, if you haven't already.

2. Create a database for OpenDocMan on your web server, as well as a MySQL user who has all privileges for accessing and modifying it.

3. Create a folder outside of your public html folder that will contain your data files. This will be your “dataDir” folder in the config. For example, `mkdir /home/joeuser/document_repository/`

4. Make sure the permissions and ownership of the data folder will allow for the web server to write to it. For example, `chgrp apache /home/joeuser/document_repository/; chmod 770 /home/joeuser/document_repository`

5. You may also need to edit your apache settings to get the permissions working. The installation script has some examples that you will be presented with.

6. Place the OpenDocMan software files in the desired location on your web server:

   • If you want to integrate OpenDocMan into the root of your domain (e.g. http://example.com/), move or upload all contents of the unzipped OpenDocman directory (but excluding the directory itself) into the root directory of your web server.

   • If you want to have your OpenDocMan installation in its own subdirectory on your web site (e.g. http://example.com/docs/), rename the directory opendocman-x.x to the name you'd like the subdirectory to have and move or upload it to your web server. For example if you want the OpenDocMan installation in a subdirectory called “docs”, you should rename the directory called “opendocman-x.x” to “docs” and upload it to the root directory of your web server.

   • Make sure there is a templates_c folder ( ex. “mkdir templates_c” ), and the templates_c folder is writeable (ex. “chmod 775 templates_c” )

7. Run the OpenDocMan installation script by accessing the opendocman folder URL in a web browser.

8. Fill out the necessary form fields during the installer

9. When you get to the last page, you click on the “New installation…” link for a fresh installation

That's it! OpenDocMan should now be installed.