install

开源MARC数据处理

INSTALL



Oct 22, 2002


	1. R E Q U I R E M E N T S

	Tested Windows 98 SE accessible in the internet:
	See Actual Installation at http://consag.tij.uia.mx/loyola/index.php
	
		Apache 2.0.42			http://www.apache.org
		MySQL 3.23.39			http://www.mysql.com
		PHP 4.2.3				http://www.php.net		
		phpMyAdmin 2.2.7-pl1 	http://phpmyadmin.sourceforge.net

	Tested at Linux at phpmylibrary sourceforge demo site:
	http://phpmylibrary.sourceforge.net/phpinfo.php for more info.
	See demo at http://phpmylibrary.sourceforge.net/html/modules/PhpMyLibrary
		
		PHP 4.1.2 
		Apache/1.3.26
		MySQL 3.22.27
		phpMyAdmin 2.2.7-pl1

	Tested at on my PC Pentium II at Windows 2000 
	http://localhost/PhpMyLibrary
	
		
		PHP 4.2.2
		Apache/2.0.40 
		MySQL 3.23.52-nt 
		phpMyAdmin 2.2.7-pl1
		
	I've include my php.ini and httpd.conf here. The configuration files that
	I used in my computer during the development.
	
	Note: You must install 
	
	PHP 4.2.2 at your c:\php 
	 
	Apache/2.0.40 Apache at c:\Program Files\Apache Group\
	
	MySQL 3.23.39 at c:\mysql
	
	phpMyAdmin 2.2.7-pl1 and PhpMyLibrary-2.0.1 at c:\htdocs\
	
	
	Copy the configuration files at
	
	PhpMyLibrary/polerio/docs/win2k/ directory.	
	
	Copy-paste the php.ini to c:\winnt\
	Copy-paste the httpd.conf to c:\Program Files\Apache Group\Apache2\conf
	
	The httpd.conf used the c:\htdocs as its htdocs directory
	thus you must copy all your web-files in there including the PhpMyLibrary
	it is at c:\htdocs\ directory

	Be noted you must copy your dlls from c:\php\dlls\ directory to c:\winnt or
	c:\windows directory. Just copy-paste the files and not the directory.
	
	for your convenience I also added my phpmyadmin config.inc.php file in here.
	I've used the phpMyAdmin 2.2.7-pl1 version.
	
	I suggest you to use phpmyadmin so that your mysql database are manageable at your 
	local web server.
	
	Now accessed your PhpMyLibrary at http://localhost/PhpMyLibrary
	phpmyadmin at http://localhost/phpmyadmin		
	
	if you doesn't have phpmyadmin you will do your database management at the command
	prompt, the old way. first go to your dos, c:\mysql\bin
	then type mysql, create a database, PhpMyLibrary
	
	for more instruction open the file mysql-configure.txt
	
		

	2. I N S T A L L A T I O N
	
		
		a) Get your phpmylibrary.sql at PhpMyLibrary/polerio/sql/ directory	
			a.1) be sure that you already created a database for your library with which
				 this sql files will be imported.
			a.2) you should also obtained the proper output of test.php located in your
				 PhpMyLibrary/test.php, to see the result you should access your 
				 webserver like this http://localhost/PhpMyLibrary/test.php	
		b) Configure your database file conf.php at PhpMyLibrary/polerio/config/ directory
		c) Configure your Library parameters at PhpMyLibrary/polerio/module/config/ directory
		d) Access your site http://yourlocalhost/PhpMyLibrary/
		e) Edit your account. Login as username admin and password admin, then change your password.
		f) Go to letter 'c' to further configure your library settings, like name, address, logo, etc. 
		
		Additional
		
		g) Edit files in your PhpMyLibrary/themes/ directory. You can copy-paste in theme in here.
		   Open http://consag.tij.uia.mx/phpmylibrary/index.php for actual application of Themes 
		   Download themes http://www.nukethemes.de,  http://www.vipixel.com, etc. for free themes.
		   
		h) Manage your Library(must login as admin). 
		
				1.  Try to add data using cataloging form. Click Catalog.
				2.  Test your MARC/ISIS import feature.
				3.  Try to add some accession numbers to your bibliographic info.
					To do this you must edit your book. An option to add/edit/delete accession 
					numbers will occur.
				4.  Try to add sample users. Regular user, admin, etc..
				5.  Test the online borrowing.
		
		i) Double check the PhpMyLibrary features. 
			
				1. WebOPAC - this is the online public access catalog. The use can use this
							 to search the book they want.
							 
				2. Cataloging Function - it is here that you will encode new bibliographic info.
						      i.e. 100 00$aPolerio Babao
						      	   245 01$bPhpMyLibrary Software Documentation
						      	   260   $aPhilippines 2002 							

							  Note: 
							  		
							  	You must have at least title or author in your bibliographic entry.
							  	The PhpMyLibrary searches only at following fields: Title, Author, Publisher, Subject, Notes.
							  	The tags are 245, 100, 260, (650 or 630), 500 respectively.
				
				3.MARC or CDS/ISIS Import/Export - it is in this function you are allowed to import your
								existing bibliographic records. Whether be it in MARC standard or in CDS/ISIS output file.
								
								If you have an existing record saved in your file. You can just import it to the PhpMyLibrary
								and you're done. The bibliographic entry of your book is already searchable to the internet or intranet.
								
								If you have a CDS/ISIS  ISO files, you can also export it to the PhpMyLibrary. With this 
								no encoding will be done because this software included the CDS/ISIS->MARC conversion.
								
				 4. Online Reservation Feature - if you can borrow online already at your library web site then you are
				 				using the Online Reservation Feature of the Library. This is a complication function
				 				this includes the addition of users, accession numbers and bibliographic infos.
				 
				 5. Miscellaneous functions:
				 
				 				polGenSQL.py - it uses python and mysqldb(mysql adapter for python) to smoothly
				 							   export your existing MARC data into PhpMyLibrary.
				 							   
				 				Theming System - if you have change already the deafult PhpMyLibrary design/theme then you already
				 							    experience the advantage of theme system.  
				
	2. S U P P O R T
	
		a)  If your installation did'nt work then try to browse the user email archive.
		    https://sourceforge.net/mailarchive/forum.php?forum_id=2919
			It is from here that might find answer similar to what you experince in installing the software.
		
		b)  If still you can't find the solution for your problem then do email me at [e-mail]
		
		c)  To receive an automatic updated news mail about PhpMyLibrary then subsribe to the mailing lists
			http://lists.sourceforge.net/mailman/listinfo/phpmylibrary-users
			It is from here I commonly send important announcement about PhpMyLibrary.



	3. N O T E
	
		a)  The Multi-admin functionality is not available to post-nuke usres yet.
			It only detects the currently log-in uid of the nuke users. If it find the
			uid of 2 then it's the administrator.
			
	4. T H E M E S Customization
		
		a)  You can edit the theme images because it was saved as PNG, editable at Macromedia 
			Fireworks. You can replace any font there perhaps with your Library name.
			The PhpMyLibrary-2.0.1 Version uses mBloctec. Open it at your themes directory
			to modify/cunstomize its HTML/Images.
			
			
	5. H I N T 
	
	
	!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
	
		For you to have a succesful installation of the PhpMyLibrary software you should first
		install the WAMPP for Windows and LAMPP for Linux. 
		
		WAMPP - Windows98/nt, Apache Server, MySQL, MySQL, PHP, PhpMyAdmin
		LAMPP - Linux, Apache, MySQL, MySQL, PHP, PhpMyAdmin
		
		
		Step 1. Extract/Install
		
		Apache - Install the Apache at c:\program files
		PHP - unzip it first then make a directory php at c:\
			  then copy all the content of uncompressed php files in
			  c:\php
	    MySQL - this is automatic install, just make sure it is installed at your c:\
	    PhpMyAdmin - create a directory htdocs at c:\ then extract the phpmyadmin at c:\htdocs
	    	  rename the Phpmyadmin-2... to phpmyadmin.
	    PhpMyLibrary - unzip and copy this also at your c:\htdocs directory
	    	  don't rename it. Case sensitive.
		
		
		Step 2.
		
		For windows users. Simply copy-paste this into your httpd.conf file
		at c:\Program Files\Apache Group\Apache2\conf\httpd.conf
		at the very bottom. Not on top of the file.
		This is for Apache 2.0.40. If you are installing using Apache 1.x
		then your ServerRoot must go like this ServerRoot "C:/Program Files/Apache Group/Apache"		
		
		ServerRoot "C:/Program Files/Apache Group/Apache2"

		DocumentRoot "C:/htdocs"

		<Directory "C:/htdocs">
    		Options Indexes FollowSymLinks
    		AllowOverride None
    		Order allow,deny
    		Allow from all
		</Directory>

		DirectoryIndex index.php index.html 

		ScriptAlias /php/ "c:/php/"
		AddType application/x-httpd-php .php
		Action application/x-httpd-php "/php/php.exe"
		
		Step 3.
		
   		ATTENTION! ATTENTION! ATTENTION! (From PHP Install Instruction)
	    Some extra DLLs are required for some PHP extensions. Please copy the
   		bundled dlls from the 'dlls/' directory in distribution package to your
   		windows/system (Win9.x) or winnt/system32 (WinNT, Win2000, XP) directory.
   		If you already have these DLLs installed on your system,
   		overwrite them only if something is not working correctly.
   		Before overwriting them, it is a good idea to backup them or move them to
   		another folder - just in case something goes wrong.
		ATTENTION! ATTENTION! ATTENTION!
		
		To do this simply:
				
		Copy-paste your c:\php\dlls\all_.dll_files_in_here_... to
		c:\windows for Windows 95/98
   		c:\winnt or c:\winnt40 for NT/2000/XP servers


   		In addition rename your c:\php\php.ini-dist to php.ini then copy-paste it to
		c:\windows for Windows 95/98
   		c:\winnt or c:\winnt40 for NT/2000/XP servers
  		
   		Now, go to directory
		c:\windows for Windows 95/98
   		c:\winnt or c:\winnt40 for NT/2000/XP servers
   		then open your php.ini using notepad/wordpad then
   		copy-paste this into your php.ini at the bottom not on the top!!!!!!
   		
   		extension_dir = "c:\php\extensions"
		doc_root = c:\htdocs
   		
   		Step 4. MySQL
   		
   			This is automatic install. Make sure that MySQL is installed at your c:\
   			To test your installation go to your dos prompt then
   			type c:\mysql\bin\mysql
   			
   			If you see some output then your MySQL was installed.
   			
   		
   		Step 5. Testing phpmyadmin 
   		
   		open first your phpmyadmin at c:\htdocs\phpmyadmin\config-inc.php
   		then look for this $cfgPmaAbsoluteUri then replace it with a value
   		
   		$cfgPmaAbsoluteUri = 'http://localhost/phpmyadmin/';
   		
   		Then go to your http://localhost/phpmyadmin
   		
   		then create database. then import the phpmylibrary sql PhpMyLibrary/polerio/sql/phpmysql.sql
   		
   		
   		Step 6. PhpMyLibrary
   		
   		go to your c:\htdocs\PhpMyLibrary\polerio\config\conf.php
   		
   		then replace $config['dbname'] = 'postnuke'; with your $config['dbname'] = 'database_name_used_from_step5';
   		
   		Then open your http://localhost/PhpMyLibrary/
   		
   		If you get proper output then play with your library settings at  c:\htdocs\PhpMyLibrary\polerio\module\config\conf.php
   		
   		
   		Step 7. Sorry. This is not a hint. This is just another long instruction to guide you.
   		
		Thank you for your interest in PhpMyLibrary    		
   		
      !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!	
   		
	  New Theme Available Oct 28, 2002
	  
	  	It was named Ateneo because the idea of a layout like this came from the Ateneo Webmaster.
	  	You can modify it to suit your library website. The primary advantage of this is 
	  	to allow you to use 100% percent of your center page compare to tabulated appearance.
	  	It depends on your needs. Ateneo template is just one of the example.


PhpMyLibrary 2.0.0

Oct 3, 2002

	- If you really just want to make this run already proceed to you configuration files
	The database configuration at PhpMyLibrary/polerio/config/conf.php
	The library configuration is at PhpMyLibrary/polerio/module/config/conf.php
	Then export you sql data from PhpMyLibrary/polerio/sql/phpmylibrary.sql into 
	your database.
	
	- If you can connect already into your database then go to your site. 
	http://somehost.com/PhpMyLibrary/ if installed as stand-alone and
	http://somehost.com/somenuke/modules.php?op=modload&name=PhpMyLibrary&file=index
	if installed as postnuke module.

	- If it's ok. Look for sample MARC data at PhpMyLibrary/polerio/module/import/LOC
	to see some actual MARC file then proceed to your site then Record Import that file
	so that you can already have some sample data into your phpmylibrary. 
	
	- Then try to login as admin, admin if stand-alone module. Then change your password
	there. If you install it into your postnuke site, then loging into your postnuke