T A B L E O F C O N T E N T S 1 INTRODUCTION 9 1.1 PURPOSE 9 1.2 SCOPE 9 1.3 APPLICABLE DOCUMENTS 9 1.4 REFERENCE DOCUMENTS 9 1.5 ABBREVIATIONS AND ACRONYMS 9 1.6 GLOSSARY 10 1.7 STYLISTIC CONVENTIONS 10 2 OVERVIEW 11 2.1 GENERAL 11 2.1.1 Copyright 11 2.2 SUPPORTED CONFIGURATION 12 2.2.1 Hardware 12 2.2.2 Software 12 2.3 CONTENTS 13 2.3.1 Software 13 2.3.2 Documentation 17 2.4 BACKWARD COMPATIBILITY 18 2.5 NEW DEFAULT SHELL 18 2.6 PROBLEM REPORTING/CHANGE REQUEST 18 3 INSTALLATION 19 3.1 INSTALLATION REQUIREMENTS 20 3.1.1 Hardware Requirements 20 3.2 UPGRADING THE VLTSW FROM "NOV2000" 21 3.3 PREPARING THE OPERATING SYSTEM 21 3.3.1 Installing the OS 21 3.3.2 Add Users and Groups 21 3.3.3 Define Disk Areas 22 3.4 DOWNLOADING THE SOFTWARE FROM THE CD 23 3.5 GET THE INSTALL PROCEDURE 25 3.6 SET THE ENVIRONMENT 25 3.6.1 PECS 25 3.6.2 Define the VLT Root and VLT Data Areas 26 3.7 INSTALL PRODUCTS 26 3.7.1 GNU tools 26 3.7.2 Tcl/Tk 27 3.7.3 VxWorks-TORNADO 28 3.7.4 RTAP 28 3.7.5 OS configuration for CCSlite 29 3.7.6 MIDAS 29 3.7.7 JAVA 29 3.8 ENVIRONMENT VERIFICATION 29 3.9 VLT COMMON SOFTWARE INSTALLATION 30 3.9.1 Automatic Installation 31 3.9.2 Step-by-step Installation 32 3.9.3 Quick Verification 32 3.9.4 Whatis database creation 34 3.10 RESTORING THE PREVIOUS CONFIGURATION 35 4 VERIFICATION 37 4.1 UNDERSTANDING ENVIRONMENTS 37 4.1.1 Configuring Environments 38 4.2 THE APPLICATION EXAMPLE 39 4.2.1 The LCU Application 39 4.2.2 The WS Application 40 4.3 INSTALLING AND CONFIGURING ACC DATABASE 40 4.3.1 Automatic Startup of Database Daemon at boot Time 43 4.4 CONFIGURE AND VERIFY 44 4.4.1 Configure the LCU TCP/IP Channels 44 4.4.2 Configure the LOGGING System. 44 4.4.3 Configure the WS Environment 45 4.4.4 Verify the WS Environment 46 4.4.5 Configure the LCU Files on the WS 47 4.4.6 Make the LCU known to the CCS environment 49 4.4.7 Verify the LCU environment 50 4.4.8 Interact with an LCU Application 50 4.4.9 Verify Cooperation between WS and LCU Applications 51 4.4.10 Configure the CCS/Scan System 52 4.4.11 Verification of the Scan System 53 4.4.12 WS Environment Shutdown 54 4.5 OTHER TESTS 54 4.6 CONFIGURING WORKSTATION STARTUP 54 4.7 REPORT TO ESO 54 5 TROUBLE SHOOTING GUIDE 57 5.1 Problems with NFS files 57 5.2 Missing setuid on MSQL deamon 57 5.3 "couldn't write PID" after starting the mSQL server 57 5.4 The LCU does not boot 57 5.5 The LCU boots but does not find the bootScript file 58 5.6 LCC does not start successfully 58 5.7 VxWorks code is not compiled 58 5.8 RTAP environment does not start 58 5.9 Lccei does not start (properly) 59 5.10 Lccei cannot communicate with an LCU 59 5.11 RtapUnlockExe fails 59 5.12 RTAP does not shutdown 59 5.13 LOG system does not work 59 5.14 lccei does not accept CDT 60 5.15 Scan system does not start on the LCU 60 5.16 Declarative conflicts during installation 60 5.17 Force an error log from an LCU 61 5.18 Security error messages from Tk 61 5.19 LCU boot problem: INTROOT contains old code 61 5.20 LCU boot problem: tim board not installed 61 5.21 "unbalanced" Parentheses Warning from tclCheck 61 5.22 Man pages not correctly formatted 62 5.23 Different LCU environments on the same nodeDifferent LCU environments on the same node 62 5.24 LCU slow speed. 63 6 PECS (Pluggable Environment Contribution System) 65 6.1 USER ENVIRONMENT SETTINGS 65 6.2 A CRASH-COURSE IN BOURNE SHELL 68
