Supplement to the OLT User Guide for Validated Configuration on Oracle VM -------------------------------------------------------------------------- Oracle Validated Configuration Program is designed for the hardware vendors to validate the hardware, server and storage, configuration with Oracle products. The validated hardware configurations are published at linux.oracle.com/validated-configurations. The OLT kit is a test tool used to validate the configuration. This document contains the steps for Validating a Configuration with Oracle VM. PROJECT STEPS ------------- - Confirm Hardware Configuration - Plan Hardware Capacity - Software Requirements - OLT Test Setup - OLT Test Execution - Submission of OLT Logs for auditing - Feedback and Data Collection - Publishing the Validated Configuration - Known issues Confirm Hardware Configuration ------------------------------ - Identify the Server and Storage models and the Oracle VM version to validate; - For Validated Configurations on Oracle VM * Partners are required to support their own products listed for the VC on Oracle VM * Partners should document that as part of data sheet, websites, any documents that refer to that particular hardware * Endorsing Unbreakable Linux Program would be ideal. Examples of endorsements can be found at http://www.oracle.com/us/technologies/virtualization/024971.htm - Compile the validated configuration specification document specified at oss.oracle.com/projects/olt/dist/documentation/VC_specifications_OVM.txt - Email the specification draft to linuxvc-info-ww_us@oracle.com with subject Line Validated_Configuration____ Note: A bug will be created for this VC for tracking at at bugzilla.oracle.com ( Product=Oracle Linux Tests,Component: ValidConfig ) Use this bug number as the Project ID for this VC * Upload the Specification draft to this bug. Plan Hardware Capacity ---------------------- Minimum hardware requirements: - 2 Identical VT enabled Servers, each with 2CPU and 4GB of RAM; 50GB on the local disk - 170GB on the shared storage OLT runs the tests for 4 virtual machine configurations.The tests are executed sequentially if hardware configuration does not exceed the minimum requirements. OLT decides on how many VMs to configure and schedule tests in parallel. With larger RAM, the more virtual machines can be tested in parallel. The servers with 10GB RAM can run upto 4 VMs in parallel, with 8GB up to 3 VMS, and with 6GB up to 2 VMs. The required shared storage capacity depends on the degree of test parallelism. 170GB is required per VMs. For example, if the server has 10GB RAM and 4 VMs are run simultaneously, allocate 170GB x 4, i.e. 680GB. Total execution time taken for running OLT for all VMs is estimated to be - 84 hours if running 1 VM at a time - 48 hours if running 2 VMs at a time - 32 hours if running 4 VMs at a time Software Requirements --------------------- - Oracle VM Server version 2.1.5 or above - Five Virtual machine templates EL4.8 x86-64 (OEL 4 Update 8 template - PV Small x86_64 (64 bit)) PVM EL4.8 x86-64 (OEL 4 Update 8 template - HVM with PV Drivers Small x86_64 (64 bit)) PVHVM EL5.3 x86-64 (OEL 5 Update 3 template - PV Small x86_64 (64 bit)) PVM EL5.3 x86-64 (OEL 5 Update 3 template - HVM with PV Drivers Small x86_64 (64 bit)) PVHVM EL5.2 x86-64 (Oracle Database 11.1.0.6 for x86_64 (64 bit) with OEL 5 Update 2 PVM - OLT 2.2.0-3 Oracle VM and Oracle VM Template software can be downloaded from eDelivery.oracle.com/linux. OLT kit can be downloaded from oss.oracle.com/projects/olt. OLT Test Setup --------------- 1.Configure the shared storage using the appropriate storage management tool. - SCSI and iSCSI: create P+1 partitions where P is the degree of test parallelism. First partition size is 70GB x P, the rest of partitions are 100GB. - NAS storage: create one file system (/ovm_test) with size calculated in 'Planning Hardware Capacity' section. Create P subdirectories under /test, where P is the degree of parallelism, /ovm_test/vm1,/ovm_test/vm2, etc. The shared storage should be accessible from both servers, have the same device names and permissions. 2.Download and install Oracle VM Server on both machines Important: during installation, create the 50GB root partition (the default is 3GB) At OVM install, local ocfs2 file system is on /OVS partition. Reconfigure it for cluster mode. As root a. # umount /OVS; b. # tunefs.ocfs2 -N 2 -M cluster / where 2 is the number of servers in the cluster c. Create /etc/ocfs2/cluster.conf file d. Start cluster services using /etc/init.d/o2cb e. mount /OVS to the first partition created in step 1 3.Setup the downloaded OEL and Oracle DB templates on the first server a. Use unzip tool to uncompress the file. Copy the extracted file templates to /OVS/seed_pool for OEL templates and /OVS/oracle_pool for Oracle database templates. 4.Setup the OS Packages and Network configuration on Dom0 on both servers: OS Packages a. Register to ULN. b. Subscribe to el5_ga_i386_base channel c. up2date -fi --channel el5_ga_i386_base sysstat d. up2date -fi --channel el5_ga_i386_base gcc e. up2date -fi --channel el5_ga_i386_base expect Network Configuration a. Edit /etc/hosts to include the fully qualified name first followed by the other names. b. Edit /etc/hosts to include localhost entry c. Setup your system such that hostname returns the fully qualified name ( with domainname) 5.Synchronize your system time on both servers using ntpd 6.On the first server, download, and extract OLT. # tar -xzvf /OLT-2.2.0-3.tar.gz OLT Test Execution ------------------ The tests consist of two parts: automated stress tests and manual migration tests. Automated stress test have to be completed for four OEL templates. The test execution flow depends on the degree of parallelism (P) allowed by the hardware capacity.Based on the above, OLT configures & execute the tests on each set of VMs that can be created in parallel, until all the required VMs are covered. 1.Edit the OLT configuration file /OLT-2.2.0-3/olt-setup.env: a. To set the test mode, edit the following parameters: VALIDATED_CONFIG=1 b. Set the dom0 root password DOM0_PASSWORD= c. Set public_if parameter to refer to the public network interface on Dom0, e.g. public_if= d. Set fs_type to reflect the filesystems for the Oracle DB datafiles: For SCSI and iSCSI: fs_type=ext3 or fs_type=ocfs2 For NFS: fs_type=nfs e.Map the 100GB storage partitions or files created during OLT test setup. Note that the disk partition names and directory names mentioned below are examples and should be changed to reflect your storage configuration. For SCSI or iSCSI partitions, map all the created 100GB partitions as fs1= ............... fsP= For NAS, specify the nfs exported filesystem to be used by each of the VMs. fs1=/ovm_test/vm1 ................. fsP=/ovm_test/vmP Note: If the number of partitions or the exported nfs file system (fs1,fs2 etc) is less than the number of VMs ,that can be tested in parallel (P) ,then these partitions/file systems will be reused for each loop of VMs that runs in parallel. 2.As root user, # cd /OLT-2.2.0-3 # ./oltInstaller 3.Collect and submit the logs per Section "Test logs for automated OLT tests" 4. Migration test should be done for one template configuration - for OEL 5.3 x86_64 PVM. Execute migration tests as mentioned in "Migration tests to be executed" of the "OLT User Guide for Oracle VM". On the first server, for OEL_EL5U3_X86_64_PVM_4GB VM only, follow the steps below a. # cd /opt/oracle/oltest/olt-schedule # olt-xen-test -f domains.config -r b. For each test listed in Migration Tests Table. a. Execute Test b. Verify result with the "Expected Results" column c. If test passes, # xm migrate -l c. Connect to the VM using vnc d. Collect logs from the VM,as an archive file (/home/oracle/work/olt-testlogs--