OCRShop GUI: Manual Installation on Linux July 22, 2004 This document describes how to install OCRShop GUI manually on Linux, without using the GUI installer. Use this document if: * The normal OCRShop GUI installer will not run on your Linux machine. * You have only command-line access on a Linux machine; this might be the case, for example, if you must telnet to a remote machine, or if you use a machine where X-Windows is not installed. If you need to install OCRShop GUI manually on another UNIX operating system, please contact Vividata. ***** Note on the installation directory: These instructions assume the Vividata installation directory is /opt/Vividata. You may install OCRShop GUI in any directory; however, if you install in a directory other than the default, you must adjust the path appropriately when following these directions. ***** 1. Download the OCRShop GUI distribution A. Log into your Vividata account at http://www.vividata.com/account. If you do not have a Vividata account: Go to http://www.vividata.com/be_ocrshop_eval.html, click "Register & Download Now!", and follow the instructions to register for a Vividata account and an OCRShop GUI evaluation. B. After loggin in, click "Downloads", then click on the "x86 Linux" link for OCRShop GUI. Save the distribution file to your machine. The distribution file is a gzipped tar file. 2. Open the distribution file In a temporary directory on your machine, unzip then untar the distribution file with the commands: gunzip ocrshop.4.61e.linux.tar.gz tar xvf ocrshop.4.61e.linux.tar The distribution will untar into a single directory by the name of vividata_linux_4.61, called the spool directory. 3. Extract the software package A. Go into the spool directory with the command: cd vividata_linux_4.61 B. In this directory, you should see the following items: installer ocrshop_dist.4.61.linux.tar.gz README.ocrshop ocrshop_4_61_linux.desc packages_linux.desc RELEASE.ocrshop C. Unzip and untar the software package with the following commands: gunzip ocrshop_dist.4.61e.linux.tar.gz tar xvf ocrshop_dist.4.61e.linux.tar This should untar into the following files and directories: bin/ config/ lib/ help/ README.linux 4. Set up the Vividata installation directory A. Log in as root. B. Make the Vividata installation directory with the command: mkdir /opt/Vividata 5. Copy the directories and files to the Vividata installation directory You must still be root to perform this step. From the directory where you extracted the software package, run these commands to copy the files you extracted to the Vividata installation directory: cp -rp bin /opt/Vividata/ cp -rp config /opt/Vividata/ cp -rp lib /opt/Vividata/ cp -rp help /opt/Vividata cp -rp README.linux /opt/Vividata/ cp -rp installer /opt/Vividata/bin/ 6. Create your license file A. First, make sure you have a copy of your OCRShop GUI license key available. Your license key consists of 3 lines of text. If you have not received your license key from Vividata via email, you may download it from the Vividata website: log in at http://www.vividata.com/account, click "License Keys", find your license key in the list. B. Create a text file called /opt/Vividata/config/license.dat. Cut and paste your license key from the email or webpage into this file. Be very careful when copying your license key, because any typos, extraneous text, or missing text will prevent the license manager from reading your license key. The license.dat file should now look something like: SERVER testmachine 0003b28a2241 VENDOR vv_d2 FEATURE ocrxtr vv_d2 46.255 permanent 1 0b211123bb33 ck=171 7. Start the FlexLM license manager In bash, start FlexLM with the command: /opt/Vividata/bin/lmgrd -c /opt/Vividata/config/license.dat >> /tmp/vividata.log 2>&1 Or in tcsh, start FlexLM with the command: /opt/Vividata/bin/lmgrd -c /opt/Vividata/config/license.dat > /tmp/vividata.log & The FlexLM license manager should now be running and using the license.dat file which you created. Verify the license manager is running correctly with the command: /opt/Vividata/bin/lmstat -a It should say that the processes "lmgrd" and "vv_d2" are "UP". These processes are the license manager daemons and must run in the background for you to use OCRShop GUI. 8. Create the init script to start the license manager at boot time If you do not wish to start the FlexLM license manager by hand every time you boot your machine, you may create an init script that will start FlexLM automatically at boot time. A. Create a text file containing the text between the "----------" lines: --------- #!/bin/sh # Start/stop FLEXlm/Vividata license daemon # This script is created by the Vividata Installer program. # Copyright (c) 1998, Vividata, Inc. All rights reserved. # PATH=/bin:/usr/bin export PATH case "$1" in start) echo "FLEXlm/Vividata license daemon /opt/Vividata/bin/lmgrd started." > /dev/console su - nobody -c "umask 111; /opt/Vividata/bin/lmgrd -c /opt/Vividata/config/license.dat >> /tmp/vividata.log 2>&1" ;; stop) /opt/Vividata/bin/lmutil lmdown -c /opt/Vividata/config/license.dat -q ;; *) echo "Usage: $0 {start | stop}" exit 1 ;; esac exit 0 --------- B. Copy this text file to your init.d directory. The exact location will vary by operating system: For Redhat systems, copy the script to create the following files: /etc/rc.d/init.d/vv_d2 /etc/rc.d/rc2.d/S25vv_d2 /etc/rc.d/rc3.d/S25vv_d2 /etc/rc.d/rc5.d/S25vv_d2 /etc/rc.d/rc2.d/K25vv_d2 /etc/rc.d/rc3.d/K25vv_d2 /etc/rc.d/rc5.d/K25vv_d2 For SuSE systems, copy the script to create the following files: /etc/init.d/vv_d2 /etc/init.d/rc1.d/S25vv_d2 /etc/init.d/rc2.d/S25vv_d2 /etc/init.d/rc3.d/S25vv_d2 /etc/init.d/rc1.d/K25vv_d2 /etc/init.d/rc2.d/K25vv_d2 /etc/init.d/rc3.d/K25vv_d2 9. Test the installation. OCRShop GUI should now be completely installed on your system. To test your installation, verify the license manager is running with the command: /opt/Vividata/bin/lmstat -a It should report that both lmgrd and vv_d2 are "UP" and that you have a license for OCRShop GUI. Try starting OCRShop GUI itself with the command: /opt/Vividata/bin/ocrshop ************************************************************************ If you encounter any problems, please refer to the OCRShop GUI manual, available for download at: http://www.vividata.com/support_docs.html Submit additional questions to Vividata technical support: http://www.vividata.com/support_contact.html ************************************************************************