Introduction ------------ vtlinstall_suse is a bourne shell script that runs on SuSE Professional 9.3 systems only to install or upgrade OEMlabel. This script will do the following tasks: - Check Args to make sure files are available for install - Verify that the current OS rev is valid - Verify that the Blowfish algorithm is not used for password Encryption Method - If server RPM is installed, ask about an upgrade - Take pre-installation X-ray - Stop server component if it is running - Save the current server configuration if one exists - Limit the size of syslog to 20 MB - Load ext3 filesystem - Rename and rmmod the system's QLogic/LSI FC drivers - Replace the LSI SCSI driver to avoid conflicts with LSI FC target mode driver - Replace sd_mod driver to limit the number of sd devices to attach in order to accelerate startup - Replace mkinitrd to handle sd_mod parameter in /etc/modprobe.conf.local - Replace xfs driver to resolve xfs_freeze issues - Install server RPM - Restore previous configuration if one is found - Install console RPM if requested - Add console path to .bash_profile - Start HBA driver - Start server component - Verify server component has started properly - Create auto start file startup links in rc3.d, rc5.d - Remove any temporary files created by install script Usage ----- ./vtlinstall_suse --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_suse script. Note: Verify that the vtlinstall_suse file is executable, otherwise change its mode using the command "chmod +x vtlinstall_suse". Supported Installations/Upgrades -------------------------------- This script can support the following installation types: - New installation of OEMlabel on clean systems - 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_suse 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 may corrupt the file. OEMlabel startup Links ----------------------- This script assumes an S99vtl 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 "S99vtl" then it does not have to be deleted. The vtlinstall_suse script will replace the existing symbolic link. Script Output ------------- The vtlinstall_suse 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_suse 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.