Previewserver-All Oses
Total Page:16
File Type:pdf, Size:1020Kb
USER DOCUMENTATION Preview Server – Voyager 8.0.0 CONFIDENTIAL INFORMATION The information herein is the property of Ex Libris Ltd. or its affiliates and any misuse or abuse will result in economic loss. DO NOT COPY UNLESS YOU HAVE BEEN GIVEN SPECIFIC WRITTEN AUTHORIZATION FROM EX LIBRIS LTD. This document is provided for limited and restricted purposes in accordance with a binding contract with Ex Libris Ltd. or an affiliate. The information herein includes trade secrets and is confidential. DISCLAIMER The information in this document will be subject to periodic change and updating. Please confirm that you have the most current documentation. There are no warranties of any kind, express or implied, provided in this documentation, other than those expressly agreed upon in the applicable Ex Libris contract. Any references in this document to non-Ex Libris Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this Ex Libris product and Ex Libris has no liability for materials on those Web sites. Table of Contents 1 Introduction ...........................................................................................................................................................5 2 Preview Server Requirements .............................................................................................................................6 2.1 Browser Requirements ..................................................................................................................................6 2.2 Client Requirements ......................................................................................................................................6 2.3 Local Preview Server Requirements .............................................................................................................6 2.4 WebVoyáge Requirements ...........................................................................................................................6 3 Preview Server – Ex Libris OPAC .......................................................................................................................7 4 Preview Server – Clients ......................................................................................................................................8 4.1 Download and Install the Clients ...................................................................................................................8 4.2 Modify the Voyager.ini ...................................................................................................................................8 4.3 Run Voyager Clients .....................................................................................................................................9 5 Preview Server – Local - Installation ............................................................................................................... 10 5.1 Download Preview Server Package ........................................................................................................... 10 5.1.1 For UNIX........................................................................................................................................ 10 5.1.2 For Windows ................................................................................................................................. 10 5.2 Install Preview Server Package.................................................................................................................. 11 5.2.1 For UNIX........................................................................................................................................ 11 5.2.2 For Windows ................................................................................................................................. 12 6 Preview Server – Local – Skin Management .................................................................................................. 13 6.1 Start Preview Server .................................................................................................................................. 13 6.1.1 For UNIX........................................................................................................................................ 13 6.1.2 For Windows ................................................................................................................................. 13 6.2 Test Preview Server ................................................................................................................................... 13 6.3 Login to the Administration Area ................................................................................................................ 13 6.4 Skin Administration ..................................................................................................................................... 13 6.5 Customize Skins ......................................................................................................................................... 14 6.5.1 For UNIX........................................................................................................................................ 14 6.5.2 For Windows ................................................................................................................................. 14 6.6 Stop Preview Server ................................................................................................................................... 14 6.6.1 For UNIX........................................................................................................................................ 14 6.6.2 For Windows ................................................................................................................................. 14 6.7 Uninstall Preview Server ............................................................................................................................ 15 6.7.1 For Unix ......................................................................................................................................... 15 6.7.2 For Windows ................................................................................................................................. 15 7 Appendix A – Change Default Port for Preview Server ................................................................................. 16 7.1 For UNIX ..................................................................................................................................................... 16 7.2 For Windows............................................................................................................................................... 16 1 Introduction Preview Server is available for customers to literally see the new features of Voyager® before upgrading to a new software release/version. There are 3 ways to use Preview Server. The first ways consists of using the Ex Libris hosted software which consists of testing the OPAC. Using this environment that is setup and hosted by Ex Libris you can connect a browser to an Ex Libris provided URL and check out the basic functionality of the OPAC. You cannot make any changes to the display of the OPAC and does not have the extensive feature set that the OPAC is capable of. This feature is available to see what changes have been made out-of-the-box for the new release. You can compare this OPAC with what is available in your installation using an unmodified skin. Another way to utilitize the Ex Libris hosted installations is by using the Voyager clients. If you desire to test the clients out on the latest voyager release prior to your upgrade, you can download the clients from the documentation center. You must ensure that PC requirements are met for this version of Voyager. You can find those requirements in Section 3 of the Voyager Installation and Upgrade Requirements documentation. For specific installation instructions you can find them in Section 4 of the Technical User’s Guide. For media client instructions, they can be found in Section one of the Media Scheduling Guide. After the clients have been installed on your local PC, you can modify the voyager.ini to connect to the Ex Libris hosted voyager installation. You will be able to see all of the client feature updates and enhancements. If there is a client feature that depends on server side changes, those features will not be enabled. This is to ensure that our customers experience the functionality of the software without special customizations for any specific institution or workflow. Also, do not rely on your changes remaining in Ex Libris environment for the duration of your testing, if at any point a refresh of the preview server is required, this refresh may be performed without notice. If you are looking to focus on the OPAC and make customization changes in preparations for your Voyager upgrade, then you will want to use the local OPAC Preview Server installation. The local preview server installation is the second component of preview server and allows customers to test and try out the opac in a local setting prior to the upgrade. This feature will give you access to the xsl, css and configuration files necessary to making changes to the look and feel of the Tomcat OPAC. This feature can be valuable and reduce the stress of going through the Voyage upgrade process, by making the