|
|
Home  Workshops Server OpenDocMan and Mandriva 2006 in 5 Steps
|
OpenDocMan and Mandriva 2006 in 5 Steps |
|
|
|
Sunday, 28 May 2006 |
OpenDocMan is a full featured Web-based document management system designed to conform to ISO 17025/IEC. It features automatic installation, file expiration, multiple version handling, file check-in/out, departmental access control, file moderation, fine grained user access control, email notification and a search function.
It is written in PHP, and is utilizing MySQL for the backend, this software is useful for any company looking to keep their documentation in a centralized repository.
Opendocman requires Apache Webserver (or any other webserver, that supports PHP), MySQL Server and PHP 4 or 5 compiled with MySQL Support and Linux. It was partially tested on MS-Windows and IIS-Server.
The workshop explains the installation using Mandriva 2006 free edition. It includes two "Flash Tutorials" also.
Here is our “test lab” configuration.
Step 1: Mandriva 2006 Installation with necessary components
I don’t want to explain how
to install Mandriva 2006. If you have any problems, please read here:
http://www.mandrake.tips.4.free.fr/installmdv2006.html
The next picture shows the
package selection we are using for this workshop:
We’ll need Apache, MySQL and
PHP but will also install Webmin to configure and control everything easily.
Apache with PHP support
should be installed if you used the setting in the picture above. Let’s start
to install Webmin and then continue with MySQL Server.
Open “Mandriva Linux
Control Center”
and install the software package webmin-1.220-9mdk.
Start webmin like this from
your Linux console:
/etc/init.d/webmin start
You should now be able to run
the web-based interface with your favorite browser by using the following URL:
https://192.168.33.5:10000
Note: Please make sure to configure the firewall correctly. For test purposes you can switch it off using the Control Center (see Security).
The following “Flash
Animation” will show the webmin installation. You’ll need an installed Flash
plug-in installed on your favorite browser. Use the links below to start the
tutorial:
It’s time to install MYSQL
Server. To do so just use the Mandriva
Control Center
and install the following packages like already described above:
MySQL-4.4.12-3
libmysql
The installer will
automatically ask you the install the following packages as well:
MySQL-client
MySQL-common
perl-DBD-mysql
php-mysql
Open Webmin and click to the
“Servers” section.
Click on the “MYSQL Database
Server” icon and open the “Module Config” tab.
Please change the settings like
this:
Command to start MySQL
Server: /etc/init.d/mysqld start
Command to stop MySQL Server:
/etc/init.d/mysqld stop
Start MySQL Server using the
start button like shown above. That’s it! We’ll create the database in step 2.
In the meantime let’s check
if Apache and PHP are running correctly on the server. Open you favorite editor and create the following
info.php script:
<?PHP
phpinfo();
?>
Save the three lines and store the info.php file in the following directory:
/var/www/html
If you’re using the following URL, you should see something like this:
http://192.168.33.5/info.php
Step 2: Download and install OpenDocman
Download the latest version using the URL below and store into your “Download” directory.
http://www.opendocman.com/
Unzip the file, create a new directory (opendocman) as root under /var/www/html and copy all files and subdirectories across. Use the following commands to accomplish this:
cd /home/frank/Download
tar xzf opendocman-1.2p3.tar.gz
cd opendocman-1.2p3
su
mkdir /var/www/html/opendocman
cp -R * /var/www/html/opendocman
Step 3: Create MySQL Database
There are different ways to create the needed MySQL database and
database users. You can use webmin to create it very easy. Just follow the
instructions given in the following flash tutorial. Use the link for your
browser below:
If you prefer to create the database using the Linux console, please type the following commands:
/etc/init.d/mysqld
start
mysql -u root –p
mysql> create
database opendocman;
mysql> grant
select,insert,update,delete,create on opendocman.* to opendocman@localhost
identified by 'opendocman';
mysql> flush
privileges;
mysql> exit;
cd
/var/www/html/opendocman
mysql -u
opendocman -p opendocman < database.sql
Step 4: Configure Opendocman
You’ll find the configuration file in Opendocman root directory. Open config.php with your favorite browser and make sure to adapt the following settings:
$database - The name of the database used =
‘opendocman’
$user - The user that has update/insert/delete permissions
on above database = ‘opendocman’
$pass - Password for above user = ‘opendocman’
$hostname - The hostname of the database server = ‘localhost’
base_url - Set this to the url of the site =
‘http://192.168.33.5/opendocman’
site_mail - The email address of the administrator of this
site. Users will be told to contact this person if they encounter errors. = ‘
This e-mail address is being protected from spam bots, you need JavaScript enabled to view it
’
root_username - This variable sets the root username. It
must be set to one of the current users of opendocman. The root user will be
able to access all files and have authority for everything. = ‘admin’
dataDir - Location of file repository. This should ideally
be outside the Web server root. Make sure the server has permissions to
read/write files in this folder! =
‘/var/www/document_repository’
Please read and understand all other parameters. They are commented and should be self explanatory. Change any that apply, but it is not necessary for our test. Now we have to create the location of the file repository (outside the Web server). Get su permissions first.
su
cd /var/wwwmkdir document_repository
chown –R apache:apache document_repository
chmod 777 –R document_repository
Step 5. Run Opendocman and get additional help
If everything is configured correctly, we can start to use Opendocman with our favorite browser by typing the following URL:
http://192.168.33.5/opendocman
Use the admin user without password to login. I recommend changing the password as soon as possible.
If you have any problems with the OpenDocman installation and usage, please use the following links:
Read the documentation: http://www.opendocman.com/demo/docs/opendocman.html
Try the demo page: http://opendocman.sourceforge.net/demo.
Login as: Username: demo Password: demo
Use the OpenDocman forums to get additional help from the developers: http://sourceforge.net/forum/forum.php?forum_id=236529
Use the Linux-Tip forums to get additional installation help and to leave commands about the article: http://www.linux-tip.com/
Download the article as pdf file here.
|
|
Virus Info Feed
Alexa Traffic Stats
|
)+',top='+(screen.availHeight/2-(599/2))+',width='+(803+10)+',height='+(599+75)+'');)
)+',top='+(screen.availHeight/2-(388/2))+',width='+(716+10)+',height='+(388+75)+'');)
)+',top='+(screen.availHeight/2-(549/2))+',width='+(912+10)+',height='+(549+75)+'');)
)+',top='+(screen.availHeight/2-(503/2))+',width='+(782+10)+',height='+(503+75)+'');)
)+',top='+(screen.availHeight/2-(433/2))+',width='+(799+10)+',height='+(433+75)+'');)
)+',top='+(screen.availHeight/2-(540/2))+',width='+(603+10)+',height='+(540+75)+'');)
)+',top='+(screen.availHeight/2-(322/2))+',width='+(697+10)+',height='+(322+75)+'');)
)+',top='+(screen.availHeight/2-(365/2))+',width='+(798+10)+',height='+(365+75)+'');)
