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