X-Git-Url: http://jsfdemo.indexdata.com/?a=blobdiff_plain;f=doc%2Fbook.xml;h=87f022b727c4a048d602b5fc57712b068472f0bc;hb=8c04107cfb8985794d301b2c58a0b5c60723c487;hp=43cbd0263758791be08b1b4b9b28685e1cc135ea;hpb=7c2c72339e8d1f6ada2de74870bcc8ae038d062e;p=pazpar2-moved-to-github.git diff --git a/doc/book.xml b/doc/book.xml index 43cbd02..87f022b 100644 --- a/doc/book.xml +++ b/doc/book.xml @@ -9,7 +9,6 @@ %idcommon; ]> - Pazpar2 - User's Guide and Reference @@ -88,7 +87,7 @@ scenes. Pazpar2 connects to servers, carries out searches, and retrieves, deduplicates, and stores results internally. Your application code may periodically inquire about the status of an ongoing operation, - and ask to see records or other result set facets. Result become + and ask to see records or other result set facets. Result becomes available immediately, and it is easy to build end-user interfaces which feel extremely responsive, even when searching more than 100 servers concurrently. @@ -119,7 +118,7 @@ If you wish to connect to commercial or other databases which do not support open standards, please contact Index Data. We have a licensing agreement with a third party vendor which will enable Pazpar2 to access - thousands of online databases, in addition the vast number of catalogs + thousands of online databases, in addition to the vast number of catalogs and online services that support the Z39.50 protocol. @@ -149,7 +148,7 @@ Installation - The Pazpar2 package very small. It includes documentation as well + The Pazpar2 package is very small. It includes documentation as well as the Pazpar2 server. The package also includes a simple user interface test1 which consists of a single HTML page and a single JavaScript file to illustrate the use of Pazpar2. @@ -223,6 +222,55 @@ +
+ Installation on Windows (from Source) + + Pazpar2 can be built for Windows using + Microsoft Visual Studio. + The support files for building YAZ on Windows are located in the + win directory. The compilation is performed + using the win/makefile which is to be + processed by the NMAKE utility part of Visual Studio. + + + Ensure that the development libraries + header files are + available on your system before compiling Pazpar2. For installation + of YAZ, refer to the YAZ installation chapter. + It is easiest if YAZ and Pazpar2 are unpacked in the same + directory (side-by-side). + + + The compilation is tuned by editing the makefile of Pazpar2. + The process is similar to YAZ. Adjust the various directories + YAZ_DIR, ZLIB_DIR, .. + + + Compile Pazpar2 by invoking nmake in + the win directory. + The resulting binaries of the build process are located in the + bin of the Pazpar2 source + tree - including the pazpar2.exe and necessary DLLs. + + + The Windows version of Pazpar2 is a console application. It may + be installed as a Windows Service by adding option + -install for the pazpar2 program. This will + register Pazpar2 as a service and use the other options provided + in the same invocation. For example: + + cd \MyPazpar2\etc + ..\bin\pazpar2 -install -c pazpar2.cfg -l pazpar2.log + + The Pazpar2 service may now be controlled via the Service Control + Panel. It may be unregistered by passing the -remove + option. Example: + + cd \MyPazpar2\etc + ..\bin\pazpar2 -remove + + +
+
Installation of test1 interface @@ -236,12 +284,18 @@ Start the Pazpar2 daemon using the 'in-source' binary of the Pazpar2 - daemon. + daemon. On Unix the process is: cd etc cp pazpar2.cfg.dist pazpar2.cfg ../src/pazpar2 -f pazpar2.cfg -t edu.xml + And on Windows: + + cd etc + copy pazpar2.cfg.dist pazpar2.cfg + ..\bin\pazpar2 -f pazpar2.cfg -t edu.xml + This will start a Pazpar2 listener on port 8004. It will proxy HTTP requests to localhost - port 80, which we assume will be the regular HTTP server on the system. Inspect and modify pazpar2.cfg as needed @@ -411,8 +465,8 @@ Sometimes, it may be necessary to implement functionality on your regular webserver that makes use of search results, for example to implement data import functionality, emailing results, history - lists, personal citation lists, interlibrary loan functionality - ,etc. Fortunately, it is simple to exchange information between + lists, personal citation lists, interlibrary loan functionality, + etc. Fortunately, it is simple to exchange information between Pazpar2, your browser scripting, and backend server-side scripting. You can send a session ID and possibly a record ID from your browser code to your server code, and from there use Pazpar2s webservice API @@ -427,7 +481,7 @@ Your data model Pazpar2 does not have a preconceived model of what makes up a data - model. There are no assumption that records have specific fields or + model. There are no assumptions that records have specific fields or that they are organized in any particular way. The only assumption is that data comes packaged in a form that the software can work with (presently, that means XML or MARC), and that you can provide