Unix Web Search Install Instructions
At anytime you can see answers to common support issues at .
The included setupunix.exe will install the source code and necessary files onto your computer hard drive into the folder “c:\Rm Unix Web Search Files”. It is intended that these files will be copied onto a computer that can ftp to the web site. This setupunix.exe does not need to be run on the web server itself.
Note:
When installed you will point your web browser to libsearch.cgi. It will send html back to your browser which will then show you the search screen and results.
The following are the instructions for those included files. These instructions assume you are familiar with maintaining a web site hosted on a web server running under Unix.
You will need to make changes to lib.conf. Lib.conf can be opened with notepad or any other ascii editor.
Lib.conf contains the following information
DATABASE record
fields are separated by a : (colon) delimiter
Field1- Organization Name displayed in the list on the opening screen
Field 2- City State/Prov and Country (not currently displayed in list on opening screen)
Field 3- password (enter an * if not required)
Note: Standard passwords will show in the url on the Address line of the web browser. They could be copied and pasted to people who shouldn’t have password access. If this is a concern, ask your Internet service Provider if they have CGI::Session installed. If not, ask them if they can install that for you.
Field 4- e-mail address of person who receives an e-mail request for the password to search your library
Field 5- e-mail address of person who receives requests to borrow items.
Field 6- path and name of library.txt file (This is the file you create within ResourceMate® utilities menu, "Create Web Search File" or from the separate expweb.exe program and have ftp'd to this location). This can be a relative ../ path directive.
Field 7- number of records in data file. It is not necessary to change this number whenever you have re-created the library.txt file. This is for display purposes only. We recommend that people link to the search page instead of the opening page so users don’t have to do an extra click just to be able to begin their searching.
Make sure that when you are done there are 7 :’s on this line otherwise web search will not work properly.
VIRTUAL- the virtual location ( for your logo file
LOGOIMG- the filename of your logo
ADMINEMAIL- the administrators e-mail address
ADMINNAME- the name of the administrator
ABOUTPAGE- the page the user will be taken to when they click on the “About” link. If you want an About link, set SHOW_ABOUT_LINK:Y
ORG_NAME- the organization name
ORG_URL- the url of the organization
xSMTPSERVER- don’t do anything with this parameter unless advised by Jaywil Software
SENDMAIL:/usr/sbin/sendmail –t- leave this as is unless sendmail is in a different location
If you don’t want the “Request to Borrow Checked Item(s)” section available, change the following parameter to N
ALLOW_REQUESTS:Y
The following parameters allow you to change the label that will be displayed on the screen. If you want to include information other than the standard fields, click on the Configure button in Utilities, “Create Web Search File”.
SEARCH_FIELD_LABEL1:Title
SEARCH_FIELD_LABEL2:Author
SEARCH_FIELD_LABEL3:Category
SEARCH_FIELD_LABEL4:Subject
SEARCH_FIELD_LABEL5:Dewey
SEARCH_FIELD_LABEL6:ISBN
SEARCH_FIELD_LABEL7:Publisher
SEARCH_FIELD_LABEL8:Keywords
Note: in ResourceMate under Utilities, Create Web Search File, Configure – confirm that Keywords has been selected to export.
SEARCH_FIELD_LABEL9:User2 field (can be made invisible)
SEARCH_FIELD_LABEL10:User3 field
SEARCH_FIELD_LABEL11:User4 field
SEARCH_FIELD_LABEL12:User5 field
SEARCH_FIELD_LABEL13:User6 field
SEARCH_FIELD_LABEL14:User7 field
The following parameters allow you to determine which fields are searchable. It is possible for data to be displayed even though it is not searchable. Indicate either Y or N.
SEARCH_FIELD_SEARCHABLE1:Y
SEARCH_FIELD_SEARCHABLE2:Y
SEARCH_FIELD_SEARCHABLE3:Y
SEARCH_FIELD_SEARCHABLE4:Y
SEARCH_FIELD_SEARCHABLE5:Y
SEARCH_FIELD_SEARCHABLE6:Y
SEARCH_FIELD_SEARCHABLE7:Y
SEARCH_FIELD_SEARCHABLE8:Y
SEARCH_FIELD_SEARCHABLE9:N
SEARCH_FIELD_SEARCHABLE10:N
SEARCH_FIELD_SEARCHABLE11:N
SEARCH_FIELD_SEARCHABLE12:N
SEARCH_FIELD_SEARCHABLE13:N
SEARCH_FIELD_SEARCHABLE14:N
Indicate Basic (one line with multiple buttons) or Advanced (multiple lines) search screen
SEARCHPAGE_SEARCH_DEFAULT:Basic
Indicate the number of buttons per line when using the Basic search screen
SEARCHPAGE_BUTTONS_PER_LINE:4
Indicate the button width. Blank allows the images to default to their own pixel size. (Height is set proportionately to width.)
SEARCHPAGE_BUTTON_WIDTH:
Indicate the text for the link to switch to the Basic Search screen
SEARCHPAGE_TEXT_BASIC_LINK:Basic Search Screen
Indicate the text for the link to switch to the Advanced Search screen
SEARCHPAGE_TEXT_ADVANCED_LINK:Advanced Search Screen
Indicate the jpg button file for each search field (this should match up with the corresponding SEARCH_FIELD_LABEL ). See the “additional search buttons” folder when searching other fields.
Note: If you don’t want a field searchable in the Basic search screen but want it searchable in the Complex search screen change this parameter to _ instead of btnSearch???.jpg. The button for that field will not show in the Basic search screen.
SEARCHPAGE_BUTTON1_FILENAME:btnSearchTitle.jpg
SEARCHPAGE_BUTTON2_FILENAME:btnSearchAuthor.jpg
SEARCHPAGE_BUTTON3_FILENAME:btnSearchCategory.jpg
SEARCHPAGE_BUTTON4_FILENAME:btnSearchSubject.jpg
SEARCHPAGE_BUTTON5_FILENAME:btnSearchDewey.jpg
SEARCHPAGE_BUTTON6_FILENAME:btnSearchISBN.jpg
SEARCHPAGE_BUTTON7_FILENAME:btnSearchPublisher.jpg
SEARCHPAGE_BUTTON8_FILENAME:btnSearchKeyword.jpg
SEARCHPAGE_BUTTON9_FILENAME:
SEARCHPAGE_BUTTON10_FILENAME:
SEARCHPAGE_BUTTON11_FILENAME:
SEARCHPAGE_BUTTON12_FILENAME:
SEARCHPAGE_BUTTON13_FILENAME:
SEARCHPAGE_BUTTON14_FILENAME:
The following parameters allow you to determine which fields are displayed. It is possible for data to be searched but not displayed (eg. keywords). Indicate either Y or N.
SEARCH_FIELD_DISPLAYED1:Y
SEARCH_FIELD_DISPLAYED2:Y
SEARCH_FIELD_DISPLAYED3:Y
SEARCH_FIELD_DISPLAYED4:Y
SEARCH_FIELD_DISPLAYED5:Y
SEARCH_FIELD_DISPLAYED6:Y
SEARCH_FIELD_DISPLAYED7:Y
SEARCH_FIELD_DISPLAYED8:N
SEARCH_FIELD_DISPLAYED9:N
SEARCH_FIELD_DISPLAYED10:N
SEARCH_FIELD_DISPLAYED11:N
SEARCH_FIELD_DISPLAYED12:N
SEARCH_FIELD_DISPLAYED13:N
SEARCH_FIELD_DISPLAYED14:N
The following parameters allow you to setup additional links that will show at the bottom of each screen. Enter the label that will show on the screen and the url that it will point to.
ADDITIONAL_LINK_LABEL1:
ADDITIONAL_LINK_LABEL2:
ADDITIONAL_LINK_LABEL3:
ADDITIONAL_LINK_LABEL4:
ADDITIONAL_LINK_LABEL5:
ADDITIONAL_LINK_LABEL6:
ADDITIONAL_LINK_LABEL7:
ADDITIONAL_LINK_LABEL8:
ADDITIONAL_LINK_LABEL9:
ADDITIONAL_LINK_LABEL10:
ADDITIONAL_LINK_URL1:
ADDITIONAL_LINK_URL2:
ADDITIONAL_LINK_URL3:
ADDITIONAL_LINK_URL4:
ADDITIONAL_LINK_URL5:
ADDITIONAL_LINK_URL6:
ADDITIONAL_LINK_URL7:
ADDITIONAL_LINK_URL8:
ADDITIONAL_LINK_URL9:
ADDITIONAL_LINK_URL10:
Determine their placement by setting LEFT, CENTER or RIGHT.
ADDITIONAL_LINK_JUSTIFY:LEFT
Indicate whether you want double spacing or not.
ADDITIONAL_LINK_DOUBLESPACE:N
Customize the following text if desired.
SEARCHPAGE_TEXT_FIND_ANY:Find Any
SEARCHPAGE_TEXT_FIND_ALL:Find All
SEARCHPAGE_TEXT_MATCH_PHRASE:Match Phrase
Indicate the default search method
SEARCHPAGE_MATCH_LIST_DEFAULT:1
This section will only be relevant if you are at ResourceMate 3.0.0.43 or higher. You can confirm this by clicking on Help, About ResourceMate. You can only export multimedia items if you have ResourceMate Plus and have checked “Export Multimedia Images” in Utilities, Create Web Search File, Configure. ALL multimedia items (not just pictures) that have the
set will be exported to the folder you have designated in “Images Folder:”. The contents of this folder will have to be transferred up to your web site into the folder indicated by the following RESULTSPAGE_IMAGE_PATH: parameter.
Determine whether multimedia files will show (or be clickable)
RESULTSPAGE_SHOW_IMAGE:Y
Determine the size of images that are displayed
RESULTSPAGE_SIZE_IMAGE_WIDTH:125
Indicate the folder that will contain the multimedia files (relative to the folder that libsearch.cgi is in)
RESULTSPAGE_IMAGE_PATH:../libsearch_images/
By default, all associated icons will display for each file type. This parameter can be changed to a list of viewable extensions (jpg,gif,docx) . Only multimedia files with these extensions we be viewable.
RESULTSPAGE_IMAGE_ICONS:all
Note: If one of your common file extensions does not have an associated _icon_???.png file in the folder designated by RESULTSPAGE_IMAGE_PATH: it will display the LINK graphic. You can create a new png file where ??? is the extension (3 or more characters) that is currently showing the LINK graphic.
Change the Back to Top text
RESULTSPAGE_TEXT_BACK_TO_TOP:Back to Top
If e-mail are not being generated properly sent
SMBLAT_EMAIL_ONLY:N
to
SMBLAT_EMAIL_ONLY:Y
Copy (ftp) libsearch.cgi and lib.conf into a web-accessible location that has permission to execute scripts via the web (usually the cgi-bin folder).
Libsearch.cgi must be made executable (755).
You may need to use the command
chmod a+x libsearch.cgi
while logged into the site in an ssh session to make the file executable
or
set the permissions to 755 (Owner-Read, Write, Execute, Group-Read, Execute, World or Users-Read, Execute)
Create a sub-directory from cgi-bin named “tmp” and make sure all users have read/write privileges (775).
You may need to use the command
chmod 775 tmp
while logged into the site in an ssh session to establish read/write privileges
or
set the permissions of that folder to 775 (Owner-Read, Write, Execute, Group-Read, Write, Execute, World or Users-Read, Execute)
Create a libsearch sub-directory off of the root level of this web site.
Copy (ftp) library.txt and logo1.gif into that sub-directory.
Copy (ftp) the btnsearch*.jpg files referenced in the SEARCHPAGE_BUTTON1_FILENAME section into that sub-directory.
The VIRTUAL parameter should be set to this location.
Create a libsearch_images (or value you entered in above RESULTSPAGE_IMAGE_PATH parameter) sub-directory off of the root level of this web site.
Copy (ftp) all the files in the libsearch_images folder on your computer into that sub-directory.
To test your web search point your web browser to where
Yourorg.com is your web site
Cgi-bin is the folder where libsearch.cgi is located
Support can be found at .
To create or refresh your web search data choose “Create Web Search File” from the Utilities menu in ResourceMate® to create a new library.txt file which can then be optionally renamed (as long as parameter 6 in the DATABASE line is set to the same file name) and ftp’ed to the web site. If you are exporting multimedia images, they will also need to be transferred to the correct folder (RESULTSPAGE_IMAGE_PATH:) on your web site.
If you have any questions regarding this process, please do not hesitate to contact us.
Jaywil Software Dev. Inc.
P.O. Box 25005
Guelph, ON, Canada
N1G 4T4
1-800-815-8370
Appendix – Additional Parameters
* General screen settings
SCREEN_BGCOLOR:White
GENERAL_FONT_TYPE:Verdana
GENERAL_FONT_SIZE:10pt
GENERAL_FONT_COLOR:Black
Set link colors
GENERAL_LINK_COLOR:Black
ACTIVE_LINK_COLOR:Black
VISITED_LINK_COLOR:Black
HOVER_LINK_COLOR:Black
* show options for front screen
SHOW_ABOUT_LINK:N
SHOW_LIST_LIBRARIES_LINK:Y
SHOW_CONTACT_ADMIN_LINK:Y
SHOW_SEARCH_LINK:Y
SHOW_VISITOR_NUMBER:Y
SHOW_TOTAL_LIBRARY_DATABASES:Y
SHOW_PASSWORD_REQUIRED:Y
SHOW_NUM_DATABASE_ITEMS:Y
* text options for front screen
TEXT_ABOUT_LINK:About
TEXT_LIST_LIBRARIES_LINK:List Libraries
TEXT_CONTACT_ADMIN_LINK:Contact Admin
TEXT_SEARCH_LINK:Search
TEXT_VISITOR_NUMBER:Visitor Number:
TEXT_TOTAL_LIBRARY_DATABASES:Total Library Databases:
TEXT_PASSWORD_REQUIRED:Password Required
TEXT_NO_PASSWORD_REQUIRED:No Password
* Search screen options
SEARCHPAGE_SHOW_SEARCH_LIBRARY:Y
SEARCHPAGE_TEXT_SEARCH:Search
SEARCHPAGE_SHOW_ENTER_FIELDS:Y
SEARCHPAGE_TEXT_ENTER_FIELDS:Enter field(s) to search, select the checkbox for an exact phrase match
SEARCHPAGE_SHOW_EXACT_PHRASE_CHECKBOX:Y
SEARCHPAGE_TEXT_SEARCH_BUTTON:Search
SEARCHPAGE_TEXT_CLEAR_BUTTON:Clear
* Results options
RESULTSPAGE_SHOW_LIBRARY_NAME:Y
RESULTSPAGE_SHOW_YOUR_SEARCH_FOUND:Y
RESULTSPAGE_TEXT_YOUR_SEARCH_FOUND:Your Search Found
RESULTSPAGE_TEXT_MATCHES:Match(es)
RESULTSPAGE_TEXT_REQUEST_NAME:Name:
RESULTSPAGE_TEXT_REQUEST_EMAIL:Phone Number/Email Address:
RESULTSPAGE_TEXT_REQUEST_COMMENTS:Comments:
RESULTSPAGE_TEXT_RESULT_#:Result #
RESULTSPAGE_SHOW_RESULT_#:Y
RESULTSPAGE_TEXT_PREV_BUTTON:Prev
RESULTSPAGE_TEXT_NEXT_BUTTON:Next
RESULTSPAGE_TEXT_REQUEST_BUTTON:Request To Borrow Checked Item(s)
* email options
EMAIL_TEXT_SUBJECT_BORROW:Borrow Request
EMAIL_TEXT_TITLE1:******************************************************
EMAIL_TEXT_TITLE2: Borrow Request Form
EMAIL_TEXT_TITLE3: from Library Search
EMAIL_TEXT_TITLE4:******************************************************
EMAIL_TEXT_LIBRARY:Library :
EMAIL_TEXT_NAME:Name Of Requestor:
EMAIL_TEXT_EMAIL:Phone/Email :
EMAIL_TEXT_DATE:Date/Time :
EMAIL_TEXT_FROM:From :
EMAIL_TEXT_FOOTER1:******************************************************
EMAIL_TEXT_COMMENTS:COMMENTS:
EMAIL_TEXT_REQUESTED_ITEM:***************** Requested Item *****************
* fields shown in e-mail - number based on SEARCH_FIELD_LABEL numbers
EMAIL_FIELD_DETAIL_LINE1:1
EMAIL_FIELD_DETAIL_LINE2:2
EMAIL_FIELD_DETAIL_LINE3:5
EMAIL_FIELD_DETAIL_LINE4:6
EMAIL_FIELD_DETAIL_LINE5:0
EMAIL_FIELD_DETAIL_LINE6:0
EMAIL_FIELD_DETAIL_LINE7:0
EMAIL_FIELD_DETAIL_LINE8:0
EMAIL_FIELD_DETAIL_LINE9:0
EMAIL_FIELD_DETAIL_LINE10:0
EMAIL_FIELD_DETAIL_LINE11:0
EMAIL_FIELD_DETAIL_LINE12:0
EMAIL_FIELD_DETAIL_LINE13:0
EMAIL_FIELD_DETAIL_LINE14:0
* changing these parameters will cause default information to not be displayed
SEARCHPAGE_TEXT_LIBRARY_NAME:
RESULTSPAGE_TEXT_LIBRARY_NAME: