Next Previous Contents

2. Installation and Updating

2.1 Update Procedure

To update your current version to the latest release:

  1. Rename your current opendocman folder.
  2. Unarchive opendocman into a new folder
  3. Edit the config.php in your new folder (Look at your old config.php file for some settings that can be transferred over from the old config to the new).
  4. Load the setup.php page (ex. http://www.mydomain.com/opendocman/setup.php) and click on the appropriate upgrade link. Refer to your old config.php to see what version you were using before.

2.2 New Installation

  1. Untar files into any dir in your webserver documents dir (ex. /var/www)
  2. Edit config.php
    1. All parameters are commented and should be self explanatory. Change any that apply, especially the database parameters.
  3. If you DO have database creation permissions to your MySQL database then you can use the automatic setup script (preferred method).
    1. Load the setup.php page and click on the new install link. (ex. http://www.mydomain.com/opendocman/setup.php)
    2. Enter the username and password of a user that has database creation permissions for the database configured in config.php
    3. Skip step 4 and move on to step 5
  4. If you DO NOT have database creation permissions, be advised that you should be carefull in doing things manually
    1. NOTE: The entries below are just examples.
    2. create a MySQL-database and MySQL-User for opendocman
      $> mysql -u root -p
      Welcome to the MySQL monitor. Commands end with ; or \g.
      Your MySQL connection id is 5525 to server version: 3.22.32
      Type 'help' for help.
      mysql> create database opendocman;
      mysql> grant select,insert,update,delete,create on opendocman.* to opendocman@localhost identified by 'opendocman';
      mysql> flush privileges;
      mysql> exit;
      $> mysql -u opendocman -p opendocman < database.sql
        
      
  5. Make a directory for the files to be stored that is accessible to the web server but not available by browsing
    $>mkdir /usr/local/opendocman/data
     
    
  6. Point your favorite webbrowser to the opendocman folder: ex. "http://www.mydomain.com/opendocman"
  7. Login as "admin" (without password). After that, go to "admin->users->update->admin" and set your admin password.
  8. Add departments, categories, users, etc.
  9. Enjoy!

Next Previous Contents