Changes in Installtion Script Version 106 Sep 2005 ----------------------------------------------------- 1) Fix the path of slocate to exclude NAS from slocate index database to avoid high CPU usage Changes in Installtion Script Version 105 August 2005 ----------------------------------------------------- 1) Areca internl RAID array driver 2) Ask confirmation to start the server for header backup and FSID check Changes in Installtion Script Version 104 July 2005 --------------------------------------------------- 1) Exclude NAS from slocate index database to avoid high CPU usage 2) Allow installation on a software RAID 3) For IPStor, use cciss for Compaq Smart Array if sa5-scsi is not already used 4) Remove VIM to avoid high CPU usage 5) Use time.nist.gov as one of default NTP servers Changes in Installtion Script Version 102 February 2005 ------------------------------------------------------- 1) Make a parameter file to keep values for the 2nd phase of setup in order to resolve remote installation issues 2) Resolve local and remote installation issues Changes in Installtion Script Version 101 January 2005 ------------------------------------------------------- 1) Blank splash image for OEMs 2) Check Client licenses 3) Set the log rotation size limit to 20 MB from 200 MB Changes in Installtion Script Version 100 December 2004 ------------------------------------------------------- 1) Apply XFS patch for 4.5 2) New drivers for 3ware 8000, Adaptec RAID 2120s, SysKonnect NIC 3) SCSI parameters passed to WORM Kernel 4) Blank splash image for OEMs Changes in Installtion Script Version 4.5b October 2004 ------------------------------------------------------- 1) Upgrade to IPStor 4.5: - Check that NAS, Failover, and SafeCache are not enabled - Dump volume headers for backup Changes in Installtion Script Version 4.5 Septembre 2004 -------------------------------------------------------- 1) New drivers for LSI SCSI card Changes in Installtion Script Version 4.4 Septembre 2004 -------------------------------------------------------- 1) New driver for 3Ware 9000 to avoid controller resets 2) Version 2.0.6 driver for Adaptec Ultra 160/320 3) Use new scsi_mod also for VTL 1047 4) Support a Secondary Time Server NTP 5) If any NTP server is specified, then default NTP servers will not be used 6) Line up status displayed 7) Pass base directory and the log file parameters to ipstorupdateimg script 8) Display appliance name instead of Red Hat on bootup 9) List "SCSI device(s) found:" after hba is started 10) Remove automatic patch application part that is not working Changes in Installtion Script Version 4.3 August 2004 ----------------------------------------------------- 1) Taking into account new CD layout 2) WORM kernel 3) Support for LSI SCSI Initiator Changes in Installtion Script Version 4.2b July 2004 to create 883b CD image ---------------------------------------------------------------------------- 1) New sd_mod driver for expanding NAS resources bigger than 1 TB 2) Add installation script version number in etc/updates file 3) Apply patches if any after asking for confirmation 4) Support of new drivers for 3ware 8000 and 9000 ONLY FOR BUILDS AFTER 883: 5) New scsi_mod driver for Linux LUN scan logic. By default Linux scans only LUN0. The parameter max_scsi_luns indicates it to scan more. However,for cetain type of devices, this parameter is overriden and scan goes up to 255 LUNS. In this case some storage devices such as EMC and ATA may see too many devices. A new parameter, check_device_type=0, is added to change this behaviour and always scans up to the value indicated by max_scsi_luns for any device. This new version sets the max_scsi_luns default value to 1 and the scsi_allow_ghost_devices to 256. 6) Do not suggest Qlogic MPIO driver Changes in Installtion Script Version 4.2 June 2004 to create 883a CD image --------------------------------------------------------------------------- 1) Limit syslog messages size to 200 MB, when this limit is reached the log is rotated. 2) Add new drivers: - e1000 - 3Ware - USB - scsi_mod for gdt (Intel internal RAID) - bcm5700 instead of tg3 for Broadcom NeXtreme or HP ProLiant NIC adapters 3) Install new glibc 2.2.5 RPMs 4) Check /proc/scsi/scsi changes after upgrade. If there is any change on storage, a warning message is displayed. 5) Create Debug option to boot without starting automatically ipstor for debugging purposes 6) Manage correctly parameters entered with shutdown, reboot commands 7) Update Desktop Logo 8) Run mpio_generate1 utility if Qlogic MPIO is loaded for auotmatic binding on LSI based storage devices 9) Set reasonable default values for Replication in XML configuration file: Micrscan enabled, Windows Size 4, and Timeout 600 10) Recongnize EMC-Clariion ghost devices in order to show the correct number of devices Introduction ------------ vtlinstall is a bourne shell script that runs on Linux systems only to install or upgrade OEMlabel. This script will do the following tasks: 1. Remove OEMlabel if already installed 2. Keep the current OEMlabel configuration if one exists 3. Update Linux kernel to SETKern 4. Update hardware and library modules 5. Modify RedHat configuration files such as inittab, modules.conf, and logrotate.conf 6. Create startup script soft links in rc3.d and rc5.d 7. Set Company and Host names 8. Add multiple LUN support for each target device 9. Enable/Disable Telnet, FTP, NTP 10. Disable unwanted RedHat services 11. Remove unwanted RedHat RPMs 12. Make a new boot image 13. Reboot the server 14. Boots into the new kernel image 15. Continue installation script 16. Install RPMs to support ACL 17. Install RPMs to support Active Directory 18. Run check utility to verify the environment is sound, abort if errors 19. Install OEMlabel RPM 20. Restore OEMlabel configuration if an upgrade was performed 21. Install OEMlabel Console RPM 22. Remove any Qlogic modules currently running 23. Configure FC HBAs and starts HBA module 24. Update the DeskTop logo 25. Start OEMlabel server 26. Create OEMlabel startup links in rc3.d, rc5.d 27. Create OEMlabel shutdown links in rc0.d, rc1.d, rc2.d, rc6.d 28. Create OEMlabel script file with execution permissions 29. Compare the current storage devices with those previously detected and shows a warning if any difference 30. Apply patches if any after asking for confirmation 31. If Qlogic MPIO driver is loaded, runs mpio_generate1 utility for automatic binding Usage ----- ./vtlinstall --version --help [-c ] --version display version number and exit --help display help and exit -c ask for confirmation before rebooting to complete 2nd phase of instalation Path path to build directory If no path is specified, the image is searched in the current location. If you are installing from a CD-ROM, mount the CD-ROM, go to the mount point, and run. If there is no CD-ROM available, you can download the OEMlabel image from the Web site. Copy the image (at least directories Server, Console, Utilities) to the same local drive as where you copied vtlinstall script. Note: Verify that the vtlinstall file is executable, otherwise change its mode using the command "chmod +x vtlinstall". Supported Installations/Upgrades -------------------------------- This script can support the following installation types: - New installation of OEMlabel on clean systems running RedHat 7.3 - Upgrade of existing versions of OEMlabel It is recommended to stop OEMlabel before starting any upgrades. - New installation with porting existing configuration When you uninstall OEMlabel, the configuration file remains on the system. You may also tar a server configuration for futur use. If you want to use an existing configuration in the /usr/local/vtl/etc directory, restore the configuration before executing the vtlinstall script. Configuration ------------- There are a few parameters that can be changed within the script. Be careful when you edit the installation script file to change parameters. For example, the Build number is used to verify if RPMs in CD image are also of that build. If not then script will exit before upgrade/installation starts. This script will support specific builds only. Set the parameter to build supported by this script. NOTE: The script must be edited and saved with a Linux system editor such as VIM only. Saving the file on a Windows system will corrupt the embedded Grub bitmap. Hardware List Screen -------------------- The script will display a hardware list screen. This screen lists hardware that require special drivers and parameters. These drivers are part of the OEMlabel image. To configure hardware components not listed, use RedHat 7.3 utilities such as kudzu. Current Issues -------------- Hardware Identification ---------------------- This script does not identify hardware in the OEMlabel server. It is up to the person using this script to identify the hardware in the system and make the correct selections from the hardware list. Network Cards ------------- Normally RedHat adds the line "alias ethx " to the /etc/modules.conf file when the network card is detected on boot. But if the network adapter is not in the modules.conf file the installation script will not add the line "alias ethx " to the /etc/modules.conf file for network adapters selected from the hardware list. However, the script will replace eepro100 with e100 driver in the modules.conf file. The script cannot determine what interface the adapter(s) are on. Verify all network adapters are in the /etc/modules.conf file before running this script. OEMlabel startup Links ----------------------- This script assumes an S99OEMlabel symbolic link points to the /usr/local/vtl/bin/OEMname file as per the official OEMlabel Deployment Guide. If you are using a different symbolic link in /etc/rc.d/rc3.d and/or /etc/rc.d/rc5.d, you must delete them before running this script. If you are using the same symbolic link name "S99OEMlabel" then it does not have to be deleted. The vtlinstall script will replace the existing symbolic link. Script Output ------------- The vtlinstall script creates temporary files in the /tmp directory during execution. It creates a log file in /usr/local/vtl-archive. Use this log and the /var/log/messages file to view script activity. Backup ------ The vtlinstall script takes a few precautions to recover from a failed upgrade/new installation process. - It takes two x-rays, one before files are updated and one after the installation is completed x-rays are located in the /usr/local/vtl-archive directory. The x-ray file names contain the prefixes "pre-install" and "post-install". The pre-install x-ray is created only for upgrades. - If the Linux kernel is already installed on the server, the script will backup the directory /lib/modules to a *.tz file in /usr/local/vtl-archive with date and time stamp in the filename. The original /lib/modules directory is updated with new drivers selected during the installation. Proprietary drivers are untouched. - The script also backs up the configuration files in /usr/local/vtl/etc directory during an upgrade. The file is called vtl_config-.tz and is placed in the /usr/local/OEMname-archive directory. RedHat OS Changes ----------------- RedHat OS Services and RPMs --------------------------- The following RedHat services are disabled: autofs ipchains lpd sendmail The following RedHat packages are removed: rhn-applet-1.0.6.11 up2date-gnome-2.7.86-7.x.3 rhn_register-gnome-2.7.21-7.x.3 up2date-2.7.86-7.x.3 rhn_register-2.7.21-7.x.3 ACL RPMs -------- The following ACL RPMs are installed: libacl-2.0.9-0.i386.rpm libattr-2.0.7-0.i386.rpm dmapi-2.0.2-0.i386.rpm acl-2.0.9-0.i386.rpm attr-2.0.7-0.i386.rpm xfsprogs-2.0.3-0.i386.rpm xfsdump-2.0.1-0.i386.rpm Active Directory RPMs --------------------- The following AD RPMs are installed if not done by RedHat 7.3 installation: cyrus-sasl-1.5.24-25.i386.rpm cyrus-sasl-gssapi-1.5.24-25.i386.rpm cyrus-sasl-md5-1.5.24-25.i386.rpm cyrus-sasl-plain-1.5.24-25.i386.rpm krb5-libs-1.2.4-1.i386.rpm openldap-2.0.23-4.i386.rpm --- End of readme ---