
Vantaa Intranet Toolkit (VINTKIT)

Version 0.2 30.05.2000



NOTE: The applications in the package are completely separate - 
you can install one of them, all of them or none of them as
you please.



INSTALLATION


1. Unpack the VINTKIT tar archive into the Apache document directory.
For example if your Apache html document are in /www/htdocs:
	
	# cd /www/htdocs
	# tar xvf /tmp/vintkit.tar  # creates a directory /www/htdocs/VINTKIT


Check rights to certain files. Your httpd shoud be able to write to (at
least):

filemanager/admin/fmpasswd
filemanager/admin/fmpasswd-
document_management/dm_archive
document_management/admin/temporary

	# For example "chown nobody:nobody <file/directory>
 


2. Update the path-names. With your favorite text editor edit the file
.variables.php3. Check at least the contents of variables:

$server_name = "127.0.0.1"		# eg. intranet.mycompany.com
$server_document_root = "/www/htdocs/"	# eg. /home/httpd/html
$intra_title = "VINTKIT"		# eg. MyCompany Intranet


Also configure file manager by editing variables in these files:

VINT/filemanager/index.php
VINT/filemanager/index2.php
VINT/filemanager/admin/fm_variables.php
VINT/filemanager/admin/user_admin.php
VINT/filemanager/admin/user_admin2.php





3. Start mysql database server (if mysqld is not running yet)

	# /usr/local/bin/safe_mysqld
	Starting mysqld daemon with databases from /usr/local/var/mysql 



4. Create 'vintuser' username for the database
	#/usr/local/bin/mysql -u root -p
	Enter password:
	Welcome to the MySQL monitor.  Commands end with ; or \g. 
	Your MySQL connection id is 2 to server verson: 3.22.26a

	Type 'help' for help.

	mysql> use mysql
	Reading table information for completion of table and column names 
	You can turn off this feature to get a quicker startup with -A

	Database changed
	mysql> INSERT INTO user VALUES ('localhost','vintuser','','Y','Y','Y','Y','Y','Y','Y','Y','Y','Y','Y','Y','Y','Y'); 
	Query OK, 1 row affected (0.01 sec)

	mysql> UPDATE user SET Password=PASSWORD('INSERT_YOUR_PASSWORD')
    	    -> WHERE user='vintuser';
	Query OK, 1 row affected (0.00 sec)
	Rows matched: 1  Changed: 1  Warnings: 0
 
	mysql> FLUSH PRIVILEGES;  





5. Create databases.

	# /usr/local/bin/mysqladmin -u root -p create news
	Enter password:
	Database "news" created.
	# /usr/local/bin/mysqladmin -u root -p create cantina
	Enter password:
	Database "cantina" created.
	# /usr/local/bin/mysqladmin -u root -p create telephone
	Enter password:
	Database "telephone" created.
	# /usr/local/bin/mysqladmin -u root -p create docmgr 
	Enter password:
	Database "docmgr" created. 
	#/usr/local/bin/mysqladmin -u root -p create journals
	Enter password:
        Database "journals" created.
	#/usr/local/bin/mysqladmin -u root -p create vacations 
        Enter password:
        Database "vacations" created.
	# /usr/local/bin/mysqladmin -u root -p create exhibition
	Enter password:
	Database "exhibition" created.




6. Create database tables. Each VINTKIT module uses only one table.
NOTE: This assumes that you haven't changed database names in
.variables - if you have edit tables.sql accordingly.

	# /usr/local/bin/mysql -u vintuser  -p < install_sql/tables.sql
	Enter password:





7. Additional: You might want to edit/add .htaccess-files for admin
so that not everybody is able to do administrative tasks.

Administrational programs for the packages are in a admin-subdirectory.
The administrational privileges are granted using normal .htaccess-files.

Create .htaccess-file in each of admin directories:
./news/admin/.htaccess
./cantina/admin/.htaccess
./telephonedirectory/admin/.htaccess
./document_management/admin/.htaccess
./journals/admin/.htaccess
./exhibitions/admin/.htaccess
./filemanager/admin/.htaccess

Each .htaccess file might be something like:

AuthName "Cantina"
AuthType Basic
AuthUserFile /etc/httpd/passwd
require valid-user

Then add the user and password to /etc/httpd/passwd using htpasswd-program.
See Apache documentation for details.


8. Additional: Make sure your PHP is configured to quote get/post/cookies
automaticly. It's configured in php.ini:

magic_quotes_gpc        =       On              ; magic quotes for incoming
GET/POST/Cookie data

Also it's recommended that Apache is configured to allow authconfig
(htaccess) in VINT directory and treat index.php just like index.html.





9. Point your browser to http://<your server name>/VINT/





HAVE FUN!
VINTKIT TEAM
Aki - coding
Janne - filemanager
Mans - contrib-applications
Leksa - coordinating & documentation

