Installation and removal

This chapter deals about installation, removal, group installation, upgrade, transfer database, transfer settings, etc.

Installing Biblioscape

Biblioscape is designed to be installed by any user. Whether or not you have an administrator account on your computer (normally, Windows programs can only be installed if the user has administrator rights), you can install Biblioscape. As a result, there is no shortcut created automatically and Biblioscape is not added to the Windows programs list, although it is very easy to do that manually after installation.

Installation

  1. Create a new folder on your hard drive. We call this the "installation folder". If you have Windows Vista, do not create this folder under "C:\Program Files\". We recommend you create the installation folder at "C:\Biblioscape 7\".
  2. After downloading the Biblioscape installation file "bsp7.exe" from the web, double-click the executable to run it. You will be prompted about the installation. Click the OK button.
  3. The WinZip self-extractor window will appear. Click the "Browse..." button and select the folder you created in step one. Click the UnZip button. Biblioscape will be uncompressed to the folder you selected. After unzipping, Biblioscape will start automatically if you leave the option checked.

Please read the license agreement in the Biblioscape installation folder. If you have a previous version of Biblioscape on your computer, please install the new version to a different folder. There is no need to uninstall the previous version. The installation of Biblioscape itself takes about another 30 megabytes.

Windows 95, 98, Millenium, NT, 2000

Any Windows account can install Biblioscape. Your account can be an administrator, a standard user, or a restricted user. The installation folder can be in any place. For example: "c:\program files\Biblioscape 7\", "c:\Bibliosacpe 7\", "c"\my downloads\", or "My Documents".

Windows XP

Windows XP does not allow users with a limited account to write to most folders. If you have an administrator account, you can install Biblioscape in any folder you want. But if you want others with limited accounts to run it, you have to put the installation folder in a place where every user has write privileges, for example: "C:\Shared Documents\Biblioscape 7\". If you only have a limited account, you can install Biblioscape under the "Shared Documents" folder if you want others to run it. Or you can put the installation folder under "My Documents".

Windows Vista

Windows Vista is more restrictive than Windows XP for security reasons. Even if you have an administrator account, you cannot install Biblioscape under the "C:\Program Files\Biblioscape 7\" folder because Vista won't let Biblioscape write files in sub-folders of "C:\Program Files\Biblioscape 7\". You must put the installation folder in a place over which you have full control, for example, "C:\Biblioscape 7\" or "C:\manual\biblioscape7\". If you want others to be able to run it, you have to put the installation folder in the Public folder. If you don't have administrator privileges, users with standard accounts can still install Biblioscape by putting the installation folder in the folder with your login name, or the public folder.

System Requirements

Biblioscape runs only under Windows 95, 98, Millennium, NT 4, 2000, XP, and Vista. It also runs under 64 bit Vista and XP. Users have run it under WINE on Linux with success. It does not run under Windows 3.1, or other operating systems (Macintosh, UNIX). But, once published on the web using BiblioWeb, users can access a Biblioscape database with any computer (PC, Macintosh, and UNIX workstations…) through a web browser. Web access includes searching the Biblioscape database, retrieving references in any desired format, modifying existing records, and even adding new records and formatting documents. BiblioWeb requires Biblioscape Professional or Librarian editions. But all features of Biblioscape are available for the first 100 runs in the trial edition.

Creating a shortcut

Since Biblioscape is not installed by an installer, there is no shortcut created. You can use Windows Explorer to run Biblioscape by double clicking the file "Biblioscape.exe" under the Biblioscape installation folder. To create a shortcut, drag "Biblioscape.exe" to your desktop using the right mouse button. Release the right mouse button and select "Create Shortcut". Once you've done this, you can run Biblioscape by double clicking the desktop shortcut icon.

Windows XP: It is also possible to add Biblioscape to the Windows Start menu manually, as would normally be done by an installer. To do this, simply use the Windows Explorer to create shortcuts to Biblioscape, BiblioSidekick, Rebuild and any other applications you want in the start menu. Then paste these shortcuts into the "Start Menu" folder under your computer or user name. The applications will now appear in the Windows start menu.

Don’t have Internet connection

If your computer does not have an Internet connection, you will need to download the installation file to a USB drive using a computer with Internet access. Then you can copy it from the USB drive to your computer to install it.

Install the Add-in for Corel WordPerfect

Several WordPerfect macros are installed in the "...\Biblioscape 7\Tools\" folder. To run these macros, please go to the menu command "Tools | Macros | Play..." in WordPerfect. Go the the "Tools" sub-folder under Biblioscape installation and run the macros. The marcos under Biblioscape Tools folder require saving your WordPerfect document as RTF file. RTF is a Microsoft standard. It is not very well implemented in WordPerfect. If you have complicated formatting in your WordPerfect document, going through RTF may lose some formatting. With Biblioscape, tt is also possible to format your WordPerfect document natively without going through RTF. Please read the section Integration with Corel WordPerfect for more information.

Install the Add-in for Microsoft Word

If you have Microsoft Word 6, 7, 97, 2000, 2003, or 2007 on you computer, you can install the Biblioscape Add-in template file into Word. Biblioscape-related menus will be added to the Word menu system and you can format a paper without leaving Word. To install the Add-in, first locate the “Startup” folder where Word is installed. Then copy the file “bib_word.dot” from the Biblioscape “Tools” folder into the Word “Startup” folder. The next time you start Word, the template will install itself and add Biblioscape-related menus into Word.

Remove Biblioscape

Since Biblioscape is not installed by a Windows installer, removing it is very simple. Just delete the Biblioscape installation folder; the job is done. If you have created a desktop shortcut, select the shortcut and press the Delete key to remove it.

Run Biblioscape from a USB drive

You can run Biblioscape from a USB drive. This feature is very convenient for users who need to take the application with them to the library, attend a conference, etc. When you run Biblioscape from a USB drive on a public computer, it changes to the trial edition. Since the trial edition is fully functional for 100 runs, this won't be a problem -- it is unlikely that you will use the same public computer to run Biblioscape more than 100 times.

  1. Copy the Biblioscape installation folder and all its sub-folders from your hard drive to the USB drive.
  2. On the USB drive, create a folder named "usb" under the Biblioscape root folder.
  3. Copy all the files in your database folder to the "usb" folder created in the last step.
  4. Take the USB drive to another computer. Double click "Biblioscape.exe" on the USB drive to run it. The database in the "usb" folder will be opened automatically. At startup, if Biblioscape detects a "usb" folder under the root folder, Biblioscape will open the database in the "usb" folder automatically.

 

Major upgrades and minor upgrades

Major upgrades include major changes in program design and database structure. They are released about every two years. Minor upgrades include mainly bug fixes and minor improvements. Immediatly after a major upgrade, you may see minor upgrades on a weekly basis. After a major upgrade stablizes, you will see minor upgrades released on a monthly basis. Here are the differences between major upgrades and minor upgrades.

  • Major upgrades are not free. Minor upgrades are always free of charge.
  • Major upgrades need to be installed on a different folder from the previous installation. Minor upgrades are installed on the same folder and replace previously installed files.
  • After installing a major upgrade, you will have a trial period with all features unlocked. Installing minor upgrades have no effect on your trial counter.

Install a major upgrade

A major upgrade is downloaded as a self extracting zip file. You can download the latest Biblioscape release at http://www.biblioscape.com/download.htm. You double click the downloaded file to install it. You should not install it over a previous installation. You don't have to remove the previous version. Just be sure to install a major upgrade to a new folder.

Install a minor upgrade

A minor upgrade is downloaded as a zip file. You can download the latest Biblioscape minor upgrade at http://www.biblioscape.com/download/bsp7_patch.zip. The release history can be found at http://support.biblioscape.com. Unzip it to your Biblioscape root folder. For example, if you have installed Biblioscape 7 before under the folder "C:\Biblioscape 7\", you should unzip minor upgrade 7.27 to the Biblioscape 7 root folder "C:\Biblioscape 7\". When prompted to replace existing files, click Yes to replace them.

Moving installation from one computer to another

If you have bought a new computer and want to install Biblioscape on it. But you want to keep all the customized settings, import filters, styles, etc., you can simply copy your Biblioscape 7 installation folder from the old PC to the new one. Run Biblioscape on the new PC and email support@biblioscape.com for a new registration key. You will receive up to 3 keys per purchase. You will find all the option settings, customized styles and import filters are copied to the new PC. The only thing that is not copied is menu and toolbar customization. Those settings are saved under your PC's registry.

If your database folder is not under Biblioscape installation folder, you have to copy your database folder to the new PC as well. On the new PC, run Biblioscape and go to "File | Database | Open Database". Select the "*.bsl" file under the copied database folder to open it.

Multiuser environment

Biblioscape supports multiuser environment in several ways. Biblioscape database can be shared by many users with a desktop interface as well as a web interface. So the first question should be: Which interface do you plan to use? The desktop interface gives you more features but cost more. The web interface doesn't require the installation of Biblioscape but has limited features. If needed, you can have a mixed solution.

Share a database with desktop application

  • Pros: All features are available (depends on which edition is purchased)
  • Cons: Each user needs to purchase a copy of Biblioscape. When openning a remote database, performance becomes slow.

Share a database on a mapped drive (not recommended): This is the easiest way to share a database among users. You simply put your database on a shared drive. This shared drive is mapped to a drive letter in each user's PC. End user just need to run Biblioscape and go to "File | Database | Open Database". Go to the shared drive, find Biblioscape database directory, and open the *.bsl file. Although the setup is very easy, there are a couple of drawbacks with this approach. When your database becomes large, the application will slow down. Because Biblioscape needs to load the whole database from the file server to your local machine, each time a query is run, it generates a huge amount of network traffic.

Share a database through BiblioRemote server (recommended): Instead of openning a shared database directly on a shared drive, we recommend using BiblioRemote server. BiblioRemote is included with Biblioscape installation. You can find it under "...\Biblioscape x\BiblioRemote\" folder. BiblioRemote is a database server. User can open a remote database located on the LAN (Local Area Network) or on the internet. All the database operations are handled by BiblioRemote server instead of each copy of Biblioscape. Compared to the shared drive approach, it is more robust and scale well. When used in a LAN, it gives good performance and it won't degrade rapidly as the size of your database grows.

Share a database with web browser

  • Pros: No installation needed for end users, so it cost less. Fast performance and easy to learn.
  • Cons: Only a limited feature set is available.

If your users only have a simple needs regarding the shared database, the web interface solution can be attractive. No software installation is needed. You only need to run BiblioWeb server which is installed with Biblioscape under the "BiblioWeb" sub-directory. There is no third party software needed. All you need to do is to run BiblioWeb.exe or set it up as Windows service.

Click here to learn more about BiblioWeb.
Click here to learn more about BiblioRemote.

Install Biblioscape on a network drive

If there are several users in your organization, and you don't want to install Biblioscape on each user's machine, you can simply install Biblioscape on a network drive and let everyone run Biblioscape from there. First, download the trial copy (a self-extracting zip file) from the Web at http://www.biblioscape.com/download.htm. Double click it to run and unzip it to a new folder on your network drive. That is all you need to do for installation. If you already installed Biblioscape on a local machine, you can simply move the Biblioscape folder from your local machine to the network drive because running installer is not needed for Biblioscape installation. User can go to the network drive and double click biblioscape.exe to run it. A network drive may be mapped to a drive letter in user's machine. The end user can drag and drop biblioscape.exe to their desktop using right mouse button and select "Create shortcut here". In the future, user can just dobule click the desktop shortcut icon to run Biblioscape.

Once installed, if you want another user to run Biblioscape from another machine in your network, please set the Biblioscape folder to be shared. Or you can make your Biblioscape folder on your machine a shared folder. Select the Biblioscape installation folder, click the right mouse button and select Properties. Go to the "Sharing" tab and check the boxes "Share this folder on the network" and "Allow network users to change my files". Other people on your LAN can browse to your shared folder and run Biblioscape from there.

If you want to install Biblioscape on a network drive and let several users run Biblioscape from there, please be aware that Biblioscape is licensed to an individual user, not a single machine. So each user needs to purchase Biblioscape and register it. 

Broadband router configuration for BiblioWeb and BiblioRemote

Most Web users in the US access the Internet through broadband connections (DSL or cable). In such cases, your Internet service provider (ISP) usually assigns a static IP based on the hardware ID of your DSL or cable modem. With a broadband connection, it is possible to run a BiblioWeb or BiblioRemote server on your home PC. But there are extra steps to be taken to make it possible.

Most likely you have a router connected to the DSL or cable modem. All your computers and other internet devices are connected to the router. To the outside world, all they see is the router. It controls the traffic between the Internet and your local area network (LAN). When you connect a PC to the router, the router will assign an IP address to that PC based on its hardware ID. If you run a BiblioWeb or BiblioRemote server on that PC, you need to tell the router to direct all the traffic on the port used to the relevant PC. You may have routers of different brands, but the setup is similar. Most of them support setup by using a Web browser. Open your browser and enter http://192.168.0.1 (or whatever the LAN IP address is for the router). You need to know the admin login name and password. This information can be found in your router's manual. Once you are logged in, there should be a hyperlink to assign incoming traffic from the Internet for different ports to the computers of your choice. You have to give a name, choose the port number, and select the computer to which the traffic will be directed on that port. For BiblioWeb, enter port 80 and select the computer where BiblioWeb will be running. For BiblioRemote, assign both port 12005 and 12006 to the computer where BiblioRemote will be running because port 12005 is used for database activities and 12006 is used for admin traffic.

Once you have configured the router to direct traffic on the above ports to the right computer, people on the Web can use your BiblioWeb or BiblioRemote server. If you are running Windows Vista, make sure the ports needed are not blocked by Windows Firewall.

Open a port in Windows firewall

In order to make your computer more secure, Microsoft enables the Windows firewall by default in Windows Vista. This pose a problem if you need to run the BiblioWeb or BiblioRemote servers. The following instructions show how to open the ports needed by BiblioWeb and BiblioRemote in Windows Vista firewall. If you run other security software that blocks Windows ports, please refer to its user manual for how to open a port.

  1. In Windows Vista, click the Start button and type "firewall". Select the suggested program "Windows Firewall".
  2. On the left pane, click the hyperlink "Allow a program through Windows Firewall".
  3. BiblioWeb uses port 80 by default. Click the "Add port..." button. Enter a name like "biblioweb" and port number "80". Chose TCP as the protocol and click the OK button. If you already have a web server using port 80, BiblioWeb will default to port 8001. In that case, enter port 8001 instead. Or, instead, you can click the "Add program..." button and enter the full path to BiblioWeb.exe and click the OK button.
  4. BiblioRemote uses ports 12005 and 12006 by default. Click the "Add port..." button. Enter a name like "biblioremote data" and port number "12005". Chose TCP as the protocol and click the OK button. Click the "Add port..." button again, and enter a name like "biblioremote admin" and port number "12006". Chose TCP as the protocol and click the OK button. Or you can click the "Add program..." button and enter the full path to "...\BiblioRemote\dbsrvr.exe" and click the OK button.