1 OVERVIEW 9 1.1 GENERAL 9 1.1.1 Copyright 10 1.2 SUPPORTED CONFIGURATION 10 1.2.1 Hardware 10 1.2.2 Software 11 1.3 CONTENTS 11 1.3.1 Software 11 1.3.2 Documentation 15 1.4 BACKWARD COMPATIBILITY 16 1.5 DEFAULT SHELL 16 1.6 PROBLEM REPORTING/CHANGE REQUEST 16 1 INTRODUCTION 17 1.1 PURPOSE 17 1.2 SCOPE 17 1.3 APPLICABLE DOCUMENTS 17 1.4 REFERENCE DOCUMENTS 17 1.5 ABBREVIATIONS AND ACRONYMS 17 1.6 GLOSSARY 18 1.7 STYLISTIC CONVENTIONS 18 2 INSTALLATION 19 2.1 INSTALLATION REQUIREMENTS 20 2.1.1 Hardware Requirements 20 2.2 UPGRADING THE VLTSW FROM PREVIOUS VLTSW VERSIONS 21 2.3 PREPARING THE OPERATING SYSTEM 21 2.3.1 Installing the OS 21 2.3.2 Add Users and Groups 21 2.3.3 Define Disk Areas 22 2.4 DOWNLOADING THE SOFTWARE FROM THE CD 23 2.5 GET THE INSTALL PROCEDURE 24 2.6 SET THE ENVIRONMENT 24 2.6.1 PECS 24 2.6.2 Define the VLT Root and VLT Data Areas 25 2.7 INSTALL PRODUCTS 26 2.7.1 GNU tools 26 2.7.2 Tcl/Tk 27 2.7.3 VxWorks-TORNADO 28 2.7.4 OS configuration for CCSlite 28 2.7.5 MIDAS 28 2.7.6 JAVA 28 2.8 ENVIRONMENT VERIFICATION 28 2.9 VLT COMMON SOFTWARE INSTALLATION 29 2.9.1 Automatic Installation 31 2.9.2 Step-by-step Installation 32 2.9.3 Quick Verification 32 2.9.4 Whatis database creation 34 2.10 RESTORING THE PREVIOUS CONFIGURATION (your environments etc.) 34 3 VERIFICATION 37 3.1 UNDERSTANDING ENVIRONMENTS 37 3.1.1 Configuring Environments 38 3.2 THE APPLICATION EXAMPLE 38 3.2.1 The LCU Application 39 3.2.2 The WS Application 39 3.3 INSTALLING AND CONFIGURING ACC DATABASE 40 3.3.1 Automatic Startup of Database Daemon at boot Time 43 3.4 CONFIGURE AND VERIFY 44 3.4.1 Configure the LCU TCP/IP Channels 44 3.4.2 Configure the LOGGING System. 44 3.4.3 Data Flow System (DFS) logging system configuration (if applicable) 46 3.4.4 Configure the WS Environment 46 3.4.5 Verify the WS Environment 47 3.4.6 Configure the LCU Files on the WS 48 3.4.7 Make the LCU known to the CCSLite environment 50 3.4.8 Verify the LCU environment 51 3.4.9 Interact with an LCU Application 51 3.4.10 Verify Cooperation between WS and LCU Applications 52 3.4.11 WS Environment Shutdown 53 3.5 OTHER TESTS 53 3.6 CONFIGURING WORKSTATION STARTUP 53 3.7 REPORT TO ESO 53 4 TROUBLE SHOOTING GUIDE 55 4.1 Problems with NFS files 55 4.2 Missing setuid on MSQL deamon 55 4.3 "couldn't write PID" after starting the mSQL server 55 4.4 The LCU does not boot 55 4.5 The LCU boots but does not find the bootScript file 56 4.6 LCC does not start successfully 56 4.7 VxWorks code is not compiled 56 4.8 WS environment does not start 56 4.9 Lccei does not start (properly) 57 4.10 Lccei cannot communicate with an LCU 57 4.11 LOG system does not work 57 4.12 lccei does not accept CDT 58 4.13 Scan system does not start on the LCU 58 4.14 Declarative conflicts during installation 58 4.15 Force an error log from an LCU 58 4.16 Security error messages from Tk 59 4.17 LCU boot problem: INTROOT contains old code 59 4.18 LCU boot problem: tim board not installed 59 4.19 "unbalanced" Parentheses Warning from tclCheck 59 4.20 Man pages not correctly formatted 60 4.21 Different LCU environments on the same node 60 4.22 LCU slow speed. 60 5 PECS (Pluggable Environment Contribution System) 63 5.1 USER ENVIRONMENT SETTINGS 63 5.2 A CRASH-COURSE IN BOURNE SHELL 66
