The introduction of web browsers has made the Internet the fastest growing area in information technology. In today's world, anyone can be a publisher on the Web. As a research scientist, you may want to publish your reference collections on your web site, share a common bibliographic database with your colleagues, or access basic bibliographic software features over the Web. With the Biblioscape web server, you can do all of these.
Biblioscape comes with its own web server – BiblioWeb.exe. By combining a web server, database access, and bibliographic specific functions into a single program, we achieved the following:
Since BiblioWeb.exe is a web server itself, you don't even need to have a web server installed. Just install Biblioscape on your PC and the BiblioWeb server is installed as part of Biblioscape. To run the BiblioWeb server, just double click "...\BiblioWeb\BiblioWeb.exe". That is all you need to do.
To satisfy the needs of our customers, BiblioWeb server is licensed in 3 ways. You should pick the one best fit your needs. You can switch to other license mode later at any time.
This is the ideal solution for Intranet use. When BiblioWeb server starts, it will check the number of users registered in the user table. If it exceeds the number of users licensed, the server won't start. To prevent one user account being used by multiple users, the IP address is checked and logged when web user login to the server. One user can't access the server from more than 5 different machines (based on IP address). If a user access Internet through ISP dialup access, the IP address is different each time a user dial up to the Web. So you should not choose this license mode if your Web user access the Web through dial up access.
There are two types of user account you can purchase, Write user account and Read user account. Web users with "Write" account can add new references through a Web browser, or edit existing references if it was created by the same user. Web users with "Read" account can only search and browse references. The "Read" user account is much cheaper than "Write" user account.
When BiblioWeb server serve a request, it is counted as a hit. A hit can be a search request, or a graphic file inside a Web page. During a user session, the same graphic won't be counted twice for a hit. Because it is cached in user's Web browser. All hits served by BiblioWeb server are logged. When licensed by the number of hits, BiblioWeb server does not care how many users do you support, whether they are "Write" accounts or "Read" accounts. As long as the number of hits served by the BiblioWeb server does not exceed the number of hits licensed, BiblioWeb server will function. Once this number is exceeded, you need to purchase more Hits. This is an ideal solution if your Web users are Internet users and they connect to the Web through ISP dial up access.
You can also license BiblioWeb server by the number of concurrent users. Under this mode, BiblioWeb server does not care the number of users supported, the number of hits served, as long as the number of users currently logged on to the server does not exceed the number licensed. When a Web user log on, it is counted as one concurrent user. If this user does not send any request to the server in 15 minutes, he or she is automatically logged off. The number of concurrent users is decremented by one.
Note: Biblioscape Professional edition comes with 3 "Write" user accounts, 3 "Read" user accounts, 50,000 hits accounts, or 1 concurrent user account. Biblioscape Librarian edition comes with 3 concurrent user account.
Once Biblioscape database is published on the Web by BiblioWeb, you can link to it from your Web site, your word document, etc. Since BiblioWeb content is protected, you need to add the login name and password info into the URL. For example, if your user name is "guest" and your password is also "guest". You can enter the following URL to display a reference record:
You can add the "&edit_loginname=guest&edit_password=guest" text to the end of any BiblioWeb URL to gain access to a record, search, etc. This makes it easy to access your database from other places like your word document, a web page, etc. Here are more examples:
To access BiblioWeb powered site, user needs to have a login account. If BiblioWeb is licensed by "concurrent users" or "hits", you can create a hyperlink to let Web user login to BiblioWeb with just one click. The following code shows you how to create such a link in HTML.
Try a <a href="http://128.192.2.200:8002/bw_login2srch?edit_loginname=guest&edit_password=guest">live</a> example.
You can create a hyperlink to run an Advanced Search on BiblioWeb server without the need of account information. But individual record can't be displayed out the search result set, because a proper user login is required for that. The following example shows you how to create such a link in HTML.
This is a test for hyperlinked query. <A HREF="http://128.192.2.200:8002/bw_search_adv?sql=select+bib.*+from+bib+where+bib.authors+like+'%25Smith%25'+&hiwords=smith"> Try this link for all publications by Smith</A>
If you want the user to be able to browse searched records, you need to add the login information plus the query into the hyperlink. In other words, the user login and a pre-defined search is run in one click. To take advantage of this feature, BiblioWeb server should be licensed by "concurrent users" or "hits". Because when licensed by "number of users", each user account can't access the server from more than 5 machines. Here is an example for such a link.
This is a test for auto-login plus hyperlinked query in one click. <A HREF="http://128.192.2.200:8002/bw_login2srch?edit_loginname=guest&edit_password=guest&bw_search_adv?sql=select+bib.*+from+bib+where+bib.title+like+'%25Synthesis%25'+&hiwords=synthesis"> Try this link for all publications have the word "Synthesis" in title</A>
You can customize the look and feel of BiblioWeb powered site by changing the *.htm files under "BiblioWeb" directory. You should not change the word with two "%" around it, for example %bw_msg%. These tags are used by BiblioWeb server. Besides this, you can all the other parts of a htm file to give it a consistent look and feel with your web site.
If you don't want BiblioWeb users to see the content of certain fields, you can hide them. For example, you may not want others to see what's in the "Notes" field of your reference. You can start Biblioscape and go to "Tools | Options". Under the "Others" tab, check the fields you want to hide under "Web Post Hide" fields. For each reference record in Biblioscape, on the reference editor, go to the "All Fields" tab, check the box "Web Post Hide" at the bottom of the list. The setting only applies to reference record display form, not the edit form.
If your reference types are highly customized, you may want to change the field names in the advanced search drop down list. You can do this by editing the file "...\Biblioscape x\Global\fields.txt". Once changed, restart BiblioWeb. New names will be used. After the changes, the field names in Biblioscape are also changed because Biblioscape and BiblioWeb share the same file. When editing the file "fields.txt", do not remove any lines or fields order. Because the fields in this file have to match the fields in another file "fldFldName.txt" exactly. If you want to change fields order or remove fields, you have to do it carefully in both files. Any mismatch will cause Biblioscape and BiblioWeb not running properly. So be sure to copy them for backup before doing any changes.
If the BiblioWeb server accounts comes with Professional or Librarian edition can no longer satisfy your needs, you can purchase more BiblioWeb server accounts. After purchasing, you will be given a registration key by email. To register BiblioWeb server, click "Register" button. Select the license mode by clicking on the tab. Enter the new accounts number and registration code into edit box and click "Register" button.

By default, BiblioWeb is set to use license mode "Num of Hits". This is a least restrictive mode. You can add unlimited number of web users and support unlimited number of concurrent users. Once the 50,000 hits is used up, you can switch to other license mode easily. So, you can continue to use BiblioWeb server while evaluate which additional web user license you want to buy.
To switch BiblioWeb server license mode, just select one of the tabs - "Concurrent", "Num of Users", "Num of Hits", and click the "Register" button. You don't need any code for switching to another license mode. If you bought the Librarian edition, it comes with 3 concurrent user license. So you should switch to the "Concurrent" license mode after the default 50,000 hits are used up.
BiblioWeb server that comes with Biblioscape installation can be run as both a regular Windows application and a Windows service. Although you can put it into the startup folder and let it run automatically when login to your PC, but you need to login to your PC in order for it to run. If you need to install BiblioWeb on a PC shared by several users, you may prefer to make BiblioWeb run as Windows service. When running as Windows service, the BiblioWeb server will be started automatically after a reboot, you don't need to login to your system in order to start it and user login and logoff won't affect the service. Windows service feature is only available in Windows NT and 2000.
Windows Vista: Click Windows Start button and type "task schedular", select program "Task Scheduler" to run it. Click "Action | Create Basic Task..." to add a job using the wizard. Give it a name like "BiblioWeb" and a short description to remind yourself. Click the Next button. On the "Trigger" tab, select "When the computer starts" under "When do you want the task to start". Click Next button. Under "What action do you want the task to perform", select "Start a program" and click the Next button. Click the Browse button to select "BiblioWeb.exe" under the BiblioWeb folder of your Biblioscape installation. Click the Next button and then click the Finish button to create the task. Go to the Task Schedular main window and double click the task you have just created. Under the "General" tab, check the box "Run wether user is logged on or not". On the "Settings" tab, check off the box "Stop the task after...". Click the OK button. You will be prompted to enter a password. You have to enter a Windows account with admin privilege to make BiblioWeb run at computer startup without loging in. If you do not have the admin privilege, the task will not run untill you are logged in to Windows. To remove BiblioWeb from scheduled tasks, just delete it from the list.
Windows 2000/XP: To install BiblioWeb as Windows service, go to "Start | Run". Enter the path of BiblioWeb.exe or by clicking on the "Browse" button. Add " /install" at the end. For example: "C:\Program Files\Biblioscape 5\BiblioWeb\BiblioWeb.exe /install". The service won't be automatically after installation. You can go to Windows service manager to start it. The service will be automatically started when you restart the computer. To remove BiblioWeb from Windows services, replace the " /install" with " /uninstall".
If you are not familiar with Windows service feature, click here to learn more about it. Click here to read a detailed step by step tutorial with graphics about installing BiblioWebSV as a Windows service.
Note: When running BiblioWeb as Windows service, you can still run BiblioWeb as regular Windows application to change settings. The changes made won't be applied untill you reboot the computer or restart BiblioWeb service.
In most cases, BiblioWeb server does not need any configuration. Just run BiblioWeb.exe, your bibliographic is on the Web. You may want to add a shortcut to your Windows startup directory, so BiblioWeb server is started automatically.
By default, BiblioWeb server will post the sample database on the Web. If you want to post another database, just click the "..." button at edit box "Biblioscape database to be posted on the Web". Then select the desired Biblioscape database. Click "Apply" button to update the changed.
By default, BiblioWeb server use port 80. If that port is already used by another web user, BiblioWeb will use port 8001 instead.
Once BiblioWeb server is running, you can access your database with a web browser by enter the URL indicated under label "Click to access Biblioscape database via browser". It is the IP address of your PC. If you use a port other than the default port 80, you need to add the port number at the end. For example, if port number 8001 is used and the IP address of your PC is 209.86.27.129, you should use the following URL http://209.86.27.129:8001
Firewall: Some security software like ZoneAlarm will block all unused ports. If the port used by BiblioWeb is blocked, You won't be able to access BiblioWeb from other computers. You need to change settings in your security software to unblock that port.
Router: For home computers, it is most likely you run BiblioWeb on a computer that is behind a router. The IP address listed by BiblioWeb is the IP address assigned by your LAN. It should start with 192.168.... You cannot use this IP address to access your BiblioWeb from computers outside of your LAN. Only the router has an IP open to the world, you should use that IP address instead. To find your IP address on the Internet, please visit http://checkip.dyndns.org.
Please make sure the port used by BiblioWeb (80 by default) is not blocked by the router. Also, configure your router to forward traffic on that port to the computer on which BiblioWeb runs. For example, if that computer's internal IP address is "192.168.0.3", configure the router (this is sometimes called “port forwarding”) so that it sends all traffic it receives from the Internet for port 80 to "192.168.0.3".
Attachments: By default, Biblioscape creates a sub-folder called "attachments" under the database folder when a new database is created. It is recommended all attachment files are kept under this folder. Biblioscape will automatically use relative path when files under this folder is put into the Attachment of a reference. So the links won't be broken when a database is moved from one computer to another. If you want to make the attachment files available for download for BiblioWeb users, you have to copy the "attachment" folder under the database folder to the "BiblioWeb" folder. The attachment hyperlinks will then work for BiblioWeb users.
All BiblioWeb server activities are logged. If your server is a very busy one, you should periodically clear this usage log table. There is no need to clear the table too often, you can do it once the number of records exceed 50,000. Before clearing log table, you can export it to a comma delimited file by clicking the "Export" button. If you charge your BiblioWeb users base on their usage, the usage log becomes very important. Otherwise, you can choose to not keep the usage log. On BiblioWeb server main window, check off the box "Keep Log" on the window's status bar.
Besides posting bibliographic database on the Web, BiblioWeb server also let you manage a Web based discussion forum. The BiblioWeb powered discussion forum can be used by any number of users without the need to login. Lets assume the IP address of your PC is 128.163.2.12, to let web users access the discussion forum, you can just create a hyperlink pointing to http://128.163.2.12/bw_forum
Each posted message can be assigned a "topic" by the poster. BiblioWeb owner can control what topics to be made available by editing the file "web_forum_topics.txt" in the "Global" sub-directory under directory Biblioscape is installed.
BiblioWeb user has to logon to the server before use. If the user does not have an account, he or she can apply for an account by clicking on the "Sign up now!" hyperlink.

To apply for an account, user will has to enter a preferred login name, password, a valid email address, as well as other information required by BiblioWeb owner. After sending these information to the BiblioWeb server, the applicant may be given an account automatically by the server if BiblioWeb is configured so.

BiblioWeb users can be assigned different privilege under the Status column. A "Read" user can only search and browse the database. A "Write" user can also add new record, edit or delete existing records. On the user admin window, you can check the box "Only allow the user who created the record to Edit or Delete it". An "Admin" user can edit or delete any record. If you change a web user's status to "Disable", the user won't be able to login to the server. When you configure the server to "Create new account automatically upon request by user on the Web", you can let the server to assign the new account a "Read" status or "Write" status.
