Home | History | Annotate | only in /test/ohacts/src/tset/geo
Up to higher level directory
NameDateSize
config/11-Jun-2008
doc/11-Jun-2008
include/11-Jun-2008
lib/11-Jun-2008
Makefile11-Jun-20081.1K
README11-Jun-20083.7K
scripts/11-Jun-2008
tests/11-Jun-2008
tet_scen11-Jun-20081.6K

README

      1 #
      2 # CDDL HEADER START
      3 #
      4 # The contents of this file are subject to the terms of the
      5 # Common Development and Distribution License (the License).
      6 # You may not use this file except in compliance with the License.
      7 #
      8 # You can obtain a copy of the license at src/CDDL.txt
      9 # or http://www.opensolaris.org/os/licensing.
     10 # See the License for the specific language governing permissions
     11 # and limitations under the License.
     12 #
     13 # When distributing Covered Code, include this CDDL HEADER in each
     14 # file and include the License file at src/CDDL.txt.
     15 # If applicable, add the following below this CDDL HEADER, with the
     16 # fields enclosed by brackets [] replaced with your own identifying
     17 # information: Portions Copyright [yyyy] [name of copyright owner]
     18 #
     19 # CDDL HEADER END
     20 #
     21 
     22 #
     23 # Copyright 2007 Sun Microsystems, Inc.  All rights reserved.
     24 # Use is subject to license terms.
     25 #
     26 # ident	"@(#)README	1.5	07/12/04 SMI"
     27 #
     28 
     29 This directory tree contains the open-source version of the GEO
     30 test harness. For more information or full documentation, refer to the 
     31 Open HA Cluster Express Automated Test Suite User's Guide, 
     32 and for most up-to-date build instructions, which is available at:
     33 
     34   http://www.opensolaris.org/os/community/ha-clusters/ohac/Documentation/Tests/.
     35 
     36 
     37 CREATE TEST REQUEST FILE
     38 ------------------------
     39 
     40 It is required to create a test request file of the GEO clusters configuration
     41 before running geo test.
     42 
     43 1. Copy the ~scate/tset/geo/config/testfile.template file to create the
     44    test request file.  For example,
     45    $ cd ~scate/tset/geo/config
     46    $ cp testfile.template /var/tmp/geo_testfile.conf
     47 
     48 3. Open the new test request file for editing.
     49    $ vi /var/tmp/geo_testfile.conf
     50   
     51 4. Change the values of the variables listed in the file.
     52    Please refer to the comments at the top of testfile.template file.
     53 
     54    When done, save and exit the file.
     55 
     56 5. Example of test request file for running geo-avs testsuite on cluster
     57    'breccia' and cluster 'hadar':
     58 
     59 -----
     60 
     61 #
     62 # Geo Test Request File
     63 #
     64 
     65 NODENAME=pbric1
     66 SEQUENCE=geo
     67 
     68 CLUSTER_1_NODE=pbric1
     69 CLUSTER_1_FAILOVER_ADDRESS_1=breccia-100
     70 CLUSTER_1_FAILOVER_ADDRESS_2=breccia-2
     71 CLUSTER_1_FAILOVER_ADDRESS_3=breccia-3
     72 CLUSTER_1_FAILOVER_ADDRESS_4=breccia-4
     73 CLUSTER_1_DISK_1=d4
     74 CLUSTER_1_DISK_2=d5
     75 
     76 CLUSTER_2_NODE=phadar1
     77 CLUSTER_2_FAILOVER_ADDRESS_1=hadar-120-1
     78 CLUSTER_2_FAILOVER_ADDRESS_2=hadar2
     79 CLUSTER_2_FAILOVER_ADDRESS_3=hadar-120-2
     80 CLUSTER_2_FAILOVER_ADDRESS_4=hadar3
     81 CLUSTER_2_DISK_1=d5
     82 CLUSTER_2_DISK_2=d6
     83 
     84 RAW_DEVICE_TYPE=sds
     85 DATA_VOL_SIZE=240     
     86 GEO_DELAY=6
     87 PG_TIMEOUT=600
     88 
     89 -----
     90 
     91 
     92 OTHER REQUIREMENTS
     93 ------------------
     94 
     95 1. Make sure SUNW.nfs is installed 
     96 
     97 2. Add the logical hostnames specified in test request file into /etc/hosts
     98 
     99 3. Make sure disks used are SMI- labeled
    100 
    101 4. Make sure disks are connected to same sets of cluster nodes
    102 
    103 5. Make sure when you do 'scconf -pvv | grep d#' where d# is the did of the
    104    disk you are using for the test, the scconf command returns some output. 
    105 
    106 
    107 RUN GEO TEST
    108 ------------
    109 
    110 The command to start the geo test is ~scate/tset/bin/run_geo.
    111 Please refer to 
    112      "Open HA Cluster Automated Test Suite User's Guide"
    113 
    114 
    115 CLEANUP STEPS IN CASE USER HAS TO KILL TEST MANUALLY
    116 ----------------------------------------------------
    117 
    118 1. Remove all protection groups and its device group
    119 
    120 2. Manually kill all dangling processes started by test
    121 
    122 3. Remove resources and resource groups created by test
    123 
    124 4. Umount /global/sndrii* /global/geo*
    125 
    126 5. Remove /global/sndrii* /global/geo* directories
    127 
    128 6. Remove all metasets created by tests
    129    These metasets are named scate-sndrii-dg-1 and scate-sndrii-dg-2.
    130 
    131 7. Remove all entries containing scate-sndrii in /etc/vfstab on all
    132    cluster nodes
    133 
    134 8. Remove /var/cluster/geo/avs/*volset.ini files on all cluster nodes
    135