usr/src/cmd/avs/dscfg/dscfgadm.sh

   1 #!/usr/bin/ksh
   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 usr/src/OPENSOLARIS.LICENSE
   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 usr/src/OPENSOLARIS.LICENSE.
  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 # Copyright 2010 Sun Microsystems, Inc.  All rights reserved.
  23 # Use is subject to license terms.
  24 #
  25
  26 typeset -r PROG=$(basename $0)
  27 typeset -r CTAG_NULL="-"
  28
  29 #
  30 # help message
  31 #
  32 help()
  33 {
  34         $xopt
  35
  36         cluster_configured
  37         CLUSTER_CONFIGURED=$?
  38
  39         echo "\
  40 usage:
  41         $PROG
  42         $PROG -i
  43         $PROG -e [-r][-p]
  44         $PROG -d [-r]" >&2
  45         if [ $CLUSTER_CONFIGURED -eq 1 ]; then
  46                 echo "\
  47         $PROG -s" >&2
  48         fi
  49
  50         echo "\
  51         -i      : display information on the Availability Suite services
  52         -e      : enable Availability Suite services (all, by default)
  53         -d      : disable Availability Suite services (all, by default)
  54         -r      : enable/disable Remote Mirror
  55         -p      : enable Point in Time Copy" >&2
  56         if [ $CLUSTER_CONFIGURED -eq 1 ]; then
  57                 echo "\
  58         -s      : set the location of the cluster configuration database" >&2
  59         fi
  60         echo "\
  61         -x      : turn on script debugging (may be used with any valid option)
  62
  63          When executed with no options or with nothing but -x, $PROG runs in
  64          interactive fashion, allowing the user to initialize the local (and
  65          if applicable, the cluster) configuration database, and to start the
  66          Availability Suite services." >&2
  67
  68         exit 2
  69 }
  70
  71 ########################## SET GLOBAL VARIABLES ######################
  72
  73 # root directory
  74 PKG_INSTALL_ROOT=""
  75 export PKG_INSTALL_ROOT
  76
  77 # set lib path
  78 LD_LIBRARY_PATH=/usr/lib:/usr/lib
  79 export LD_LIBRARY_PATH
  80
  81 # set dscfg
  82 DSCFG="/usr/sbin/dscfg"
  83 export DSCFG
  84
  85 # set parser config location
  86 PCONFIG="/etc/dscfg_format"
  87 export PCONFIG
  88
  89 # set local dscfg location
  90 export LOCAL_DSCFG="/etc/dscfg_local"
  91
  92 # set cluster dscfg reference file
  93 export CLUSTER_REF="/etc/dscfg_cluster"
  94
  95 # a service that has a dependency on us
  96 FS_LOCAL_SVC="svc:/system/filesystem/local"
  97
  98 NODELIST="/tmp/nodelist"
  99 DSCFGLOCKDCF="/etc/dscfg_lockdb"
 100 DSCFG_DEPEND_NOCHK="/tmp/.dscfgadm_pid"
 101
 102 # SMF defines
 103 MANIFEST_PATH=/lib/svc/manifest/system
 104
 105 # SMF services (enable and disable)
 106 SMF_ENABLE="nws_scm nws_sv nws_ii nws_rdc nws_rdcsyncd"
 107 SMF_DISABLE="nws_rdcsyncd nws_rdc nws_ii nws_sv nws_scm"
 108
 109 # state of each service
 110 nws_scm_enabled=0
 111 nws_sv_enabled=0
 112 nws_ii_enabled=0
 113 nws_rdc_enabled=0
 114 nws_rdcsyncd_enabled=0
 115
 116 # set path
 117 PATH=/usr/bin:/usr/sbin:/sbin/sh
 118 export PATH
 119
 120 # set architecture
 121 ARCH=`uname -p`
 122 export ARCH
 123 OS_MINOR=`uname -r | cut -d '.' -f2`
 124
 125 # number of sectors required for database
 126 # 1024*1024*5.5/512
 127 REQUIRED=11264
 128
 129 # must set here, else seen as null in MAIN
 130 VALID_DB_ENTERED=0
 131
 132 NO_ARGS=0
 133
 134 # for debugging
 135 xopt=
 136
 137 # set lengthy message here
 138 CLUST_LOC_MESS="The current location is invalid for a Sun StorageTek \
 139 Data Services configuration database.  Once a valid location is \
 140 entered (raw slice on \"did\" device), you may upgrade the existing \
 141 database to this new location - following the procedure outlined \
 142 in the Installation and Configuration Guide."
 143
 144 ########################## SET GLOBAL VARIABLES ######################
 145
 146
 147 ########################## ERROR  ####################################
 148
 149 # called with optional error msg $1
 150 # prints basic guidelines for configuration of the database location
 151 error()
 152 {
 153     $xopt
 154
 155     echo >&2
 156     echo "INSTALLATION ERROR" >&2
 157     echo "Error: $1" >&2
 158     echo >&2
 159     in_cluster
 160
 161     if [ $? -eq 1 ]; then
 162         echo "GENERAL INSTALLATION RULES:" >&2
 163         echo "\tBecause you are installing on a cluster," >&2
 164         echo "\tthe database must be located on a raw slice of a did device.">&2
 165         echo "\t  e.g. /dev/did/rdsk/d17s1" >&2
 166     fi
 167     # let?
 168     MB=`expr $REQUIRED / 2 / 1024`
 169     echo "\t$REQUIRED sectors ($MB MBs) are required for the database." >&2
 170 }
 171
 172 ########################## ERROR  ####################################
 173
 174 ########################## ALL LOCATION TESTS ########################
 175
 176 # sets numerous environment variables describing the state of the system
 177 get_system_state()
 178 {
 179         $xopt
 180
 181         valid_local_dscfg_exists
 182         VALID_LOCAL_DB=$?
 183         OLD_VALID_LOCAL_DB=$VALID_LOCAL_DB
 184
 185         in_cluster
 186         IN_CLUSTER=$?
 187
 188         cluster_configured
 189         CLUSTER_CONFIGURED=$?
 190
 191         if [ $IN_CLUSTER = 1 ]; then
 192                 valid_cluster_dscfg_exists
 193                 VALID_CLUSTER_DB=$?
 194                 OLD_VALID_CLUSTER_DB=$VALID_CLUSTER_DB
 195         else
 196                 VALID_CLUSTER_DB=0
 197         fi
 198 }
 199
 200 # Checks if in cluster
 201 # returns 1 if in cluster, else 0
 202 #
 203 in_cluster()
 204 {
 205     $xopt
 206
 207     if [ -x /usr/sbin/clinfo ]; then
 208             clinfo
 209         if [ $? -eq 0 ]; then
 210             return 1
 211         else
 212             return 0
 213         fi
 214     else
 215         return 0
 216     fi
 217 }
 218
 219 # checks if a system is configured as a cluster
 220 # returns 1 if configured as a cluster, 0 if not
 221 #
 222 cluster_configured()
 223 {
 224     $xopt
 225
 226     if [ -f /etc/cluster/nodeid ]; then
 227         return 1
 228     else
 229         return 0
 230     fi
 231 }
 232
 233 # Check the list of Sun Cluster device groups known in the dscfg, determing
 234 # if they are currently enabled on this Sun Cluster node. If so, fail allowing
 235 # the system administator to scswitch them elsewhere.
 236 #
 237 check_device_groups()
 238 {
 239         $xopt
 240
 241         if [ $VALID_CLUSTER_DB == 1 ]; then
 242                 DEVICE_GROUPS=`$DSCFG -s $FILE_LOC -l 2>/dev/null | \
 243                 grep "^dsvol:" | cut -d' ' -f3 | sort | uniq | xargs`
 244                 for x in $DEVICE_GROUPS
 245                 do
 246                         $DSCFG -D $x 2>/dev/null
 247                         if [ $? -eq 1 ]
 248                         then
 249                                 IN_USE="$IN_USE $x"
 250                         fi
 251                 done
 252
 253                 if [ -n "$IN_USE" ]
 254                 then
 255                     print "The following Sun Cluster device groups are in use "
 256                     print "by Availability Suite on this node."
 257                     print ""
 258                     print "$IN_USE"
 259                     print ""
 260                     print "'scswitch' them to another Sun Cluster node before "
 261                     print "attempting to disable any data services."
 262                     return 1
 263                 else
 264                     return 0
 265                 fi
 266         fi
 267
 268         return 0
 269 }
 270
 271 # checks to see if this is a char device in the
 272 # /dev/did/rdsk directory returns 1 if so.
 273 #
 274 is_did_device()
 275 {
 276         $xopt
 277
 278         DID=`echo $1 | awk -F/ '{print $3}'`
 279         RDSK=`echo $1 | awk -F/ '{print $4}'`
 280
 281         if [ "did" = $DID -a "rdsk" = $RDSK -a -c $1 ]; then
 282                 return 1
 283         else
 284                 return 0
 285         fi
 286 }
 287
 288 #
 289 # checks size of area for db location
 290 #
 291 check_size()
 292 {
 293         $xopt
 294
 295         # if in cluster look for d*s*
 296         SLICE=`echo $1 | sed -n 's/.*d.*s\(.*\)/\1/p'`
 297
 298         SECTORS=`prtvtoc $1 | tr -s ' '| grep "^ $SLICE " | awk '{print $5}'`
 299
 300         if [ -z "$SECTORS" ]; then
 301             echo "SLICE at $1 not found on this device"
 302             return 0
 303         fi
 304
 305         # if required size is greater than space available, then fail
 306         if [ $REQUIRED -gt $SECTORS ]; then
 307                 return 0
 308         else
 309                 return 1
 310         fi
 311 }
 312
 313 # looks in dscfg_cluster reference file.  if a location is configured,
 314 # tests to see if it is a valid database.  if so, returns 1
 315 #
 316 valid_cluster_dscfg_exists()
 317 {
 318     $xopt
 319
 320     if [ -s $CLUSTER_REF ]; then
 321         FILE_LOC=`head -1 $CLUSTER_REF`
 322         contains_data $FILE_LOC
 323         return $?
 324     else
 325         return 0
 326     fi
 327 }
 328
 329
 330 # checks for the existence of dscfg_local database, and if it exists,
 331 # tests to see if it is a valid database.  if so, returns 1
 332 #
 333 valid_local_dscfg_exists()
 334 {
 335     $xopt
 336
 337     if [ -s $LOCAL_DSCFG ]; then
 338         contains_data $LOCAL_DSCFG
 339         return $?
 340     else
 341        return 0
 342     fi
 343 }
 344
 345 # used to test if a valid DS config database exists on machine already
 346 # MAGIC_STRING is the top line in the config used in v3.1 & v3.2
 347 #
 348 contains_data()
 349 {
 350     $xopt
 351
 352     # dscfg distinct strings, varies on the architecture
 353     if [ $ARCH = "sparc" ]
 354     then
 355         MAGIC_STRING="MAGI"
 356     elif [ $ARCH = "i386" ]
 357     then
 358         MAGIC_STRING="IGAM"
 359     fi
 360
 361     # Create a PID unique temporary file
 362     TMP_FILE=/tmp/$$
 363
 364     # Write the first or 16th block (skipping over VTOC) to
 365     # the TMP_FILE, then scan for the presence of the "MAGI"
 366     #
 367     for offset in 0 16
 368     do
 369         if [ ! -z "$1" ]; then
 370             dd if=$1 of=$TMP_FILE count=1 iseek=$offset 2>/dev/null
 371             FILECONTENTS=`strings $TMP_FILE | head -1 2>/dev/null`
 372             if [ `echo $FILECONTENTS | grep -c "$MAGIC_STRING"` -gt 0 ]; then
 373                 rm $TMP_FILE
 374                 return 1
 375             fi
 376         fi
 377     done
 378
 379     rm $TMP_FILE
 380     return 0
 381 }
 382
 383 ########################## ALL LOCATION TESTS ########################
 384
 385
 386 ########################## MAIN FUNCTIONS ############################
 387
 388 # since location already has been set, asks what to do now?  keeping
 389 # it still checks the size (since an upgrade from 3.0 may still be
 390 # occuring) and also checks if was an old cluster config on disallowed
 391 # /dev/did/dsk directory
 392 #
 393 # returns:
 394 #       0 if cluster location is invalid or the user does not want to keep it
 395 #       1 if the location is valid and the user wants to keep it.
 396 #
 397 keep_it()
 398 {
 399     $xopt
 400
 401     NOTE="\nThe Sun StorageTek Data Services database configuration"
 402     NOTE="$NOTE location has already been set."
 403     echo $NOTE
 404
 405     echo "\nCurrent location: $PKG_INSTALL_ROOT$FILE_LOC"
 406
 407     QUEST="Would you like to preserve the existing configuration"
 408     QUEST="$QUEST information at its current location? "
 409
 410     ANS=`ckyorn -Qd n -p "$QUEST"`
 411
 412     case $ANS in
 413         y|Y|yes|YES|Yes)
 414             #Since the user has said "yes I want to keep this current one"
 415             #it may actually be a 3.x database, which only required 4.5mb
 416             #space, so now will check that there is room to grow another 1mb"
 417             check_location $FILE_LOC
 418             if [ $? = 0 ]; then
 419                 error "$CLUST_LOC_MESS"
 420                 return 0
 421             else
 422                 OLD_FILE_LOC=$FILE_LOC
 423                 FILE_LOC=$NULL
 424                 return 1
 425             fi
 426             ;;
 427         *)
 428             return 0
 429             ;;
 430     esac
 431 }
 432
 433 #
 434 # asks if user wants to keep existing db information, overwrite with
 435 # a new db, or view the contents, and be asked again...
 436 # returns:
 437 #       0 if old location is bad
 438 #       1 if old location is good
 439 #
 440 preserve_overwrite_maybe()
 441 {
 442     $xopt
 443
 444     echo "\nIt appears a valid database configuration exists here already."
 445
 446     while true
 447     do
 448       SAFE_LOC=$FILE_LOC
 449
 450         echo "\nWould you like to preserve this information and continue?"
 451         echo "\ty - preserve current configuration"
 452         echo "\tn - overwrite with new configuration"
 453         echo "\tmaybe - view contents of current configuration"
 454
 455         ANS=`ckkeywd -Q y n maybe`
 456         case $ANS in
 457           y)
 458                 check_location $FILE_LOC
 459                 if [ $? = 0 ]; then
 460                         error "$CLUST_LOC_MESS"
 461                         return 0
 462                 else
 463                         $DSCFG -s "$FILE_LOC" -C $CTAG_NULL >/dev/null 2>&1
 464                         OLD_FILE_LOC=$FILE_LOC
 465                         FILE_LOC=$NULL
 466                         return 1
 467                 fi
 468                 ;;
 469           n)
 470                 check_location $FILE_LOC
 471                 if [ $? = 0 ]; then
 472                         error "$CLUST_LOC_MESS"
 473                         return 0
 474                 else
 475                         return 1
 476                 fi
 477                 ;;
 478
 479           maybe)
 480                 # print contents of this db config.
 481                 echo "\nContents of database configuration found at $SAFE_LOC are:"
 482                 $DSCFG -l -s "$FILE_LOC" | more
 483                 FILE_LOC=$SAFE_LOC
 484                 continue
 485               ;;
 486         esac
 487     done
 488 }
 489
 490 # gets location from user
 491 #
 492 get_location()
 493 {
 494     $xopt
 495
 496     #Checks for absolute path name, and if file name and file doesn't
 497     #exist, creates it.
 498     echo "\n\n----------ENTER DATABASE CONFIGURATION LOCATION-----------------"
 499     echo "Note:  Please ensure this location meets all requirements specified"
 500     echo "in the Availability Suite Installation Guide."
 501
 502     FILE_LOC=`ckpath -artwQ -p "Enter location:"`
 503     if [ $? = 1 ]
 504         then
 505             exit 1
 506         fi
 507
 508     # allow non-root user to access for least privileges
 509     chmod 666 $FILE_LOC
 510 }
 511
 512
 513 #
 514 # tests for proper config
 515 #
 516 # returns:
 517 #       0 if bad location
 518 #       1 if good location
 519 #
 520 check_location()
 521 {
 522         $xopt
 523
 524         # set to FILE_LOC
 525         LOCATION=$1
 526
 527         did_clust_msg="You are in cluster and $LOCATION is not valid DID device"
 528
 529         # Set "actual file location" variable here to equal file location
 530         # entered by user because getting here means contains_data was already
 531         # successfully called before and now the two can equal each other for
 532         # future testing.
 533
 534         SAFE_LOC=$FILE_LOC
 535
 536         if [ $IN_CLUSTER = 1 -o $CLUSTER_CONFIGURED = 1 ]; then
 537                 if [ -b "$LOCATION" ] || [ -c "$LOCATION" ]; then
 538                         is_did_device $LOCATION
 539                         if [ $? = 0 ]; then
 540                                 error "$did_clust_msg"
 541                                 return 0
 542                         fi
 543                 else
 544                         error "$did_clust_msg"
 545                         return 0
 546                 fi
 547         else
 548                 echo "Location may not be changed in a non Sun Cluster OE." 2>&1
 549                 return 0
 550         fi
 551
 552         check_size $LOCATION
 553
 554         if [ $? != 1 ]; then
 555                 error "$LOCATION does not meet minimum space requirement."
 556                 return 0
 557         else
 558                 return 1
 559         fi
 560 }
 561
 562 #
 563 # Notifies the user that the SMF services are online,
 564 # and gives him the option to disable the services before proceeding.  If
 565 # the services are not disabled, the program cannot proceed with setting
 566 # a new dscfg location.
 567 #
 568 ask_to_disable()
 569 {
 570     $xopt
 571
 572     echo "\
 573 \nYour services must be disabled before a new configuration location is set.\n"
 574
 575     QUEST="Would you like to disable the services now and continue with the"
 576     QUEST="$QUEST Availability Suite setup? "
 577
 578     ANS=`ckyorn -Qd n -p "$QUEST"`
 579
 580     case $ANS
 581         in y|Y|yes|YES|Yes)
 582             return 1
 583             ;;
 584         *)
 585             return 0
 586             ;;
 587     esac
 588 }
 589
 590 #
 591 # Asks the user if he would like to enable the services now.  If so,
 592 # import them (if necessary) and enable them.
 593 #
 594 ask_to_enable()
 595 {
 596     $xopt
 597
 598     echo "\
 599 \nIf you would like to start using the Availability Suite immediately, you may
 600 start the SMF services now.  You may also choose to start the services later
 601 using the $PROG -e command."
 602
 603     QUEST="Would you like to start the services now? "
 604
 605     ANS=`ckyorn -Qd n -p "$QUEST"`
 606
 607     case $ANS
 608         in y|Y|yes|YES|Yes)
 609             return 1
 610             ;;
 611         *)
 612             return 0
 613             ;;
 614     esac
 615 }
 616
 617 #
 618 # display information about the system
 619 #
 620 display_info()
 621 {
 622         $xopt
 623
 624         typeset grp_error_flg=0
 625         typeset -L15 svc state en SVC="SERVICE" STATE="STATE" EN="ENABLED"
 626         echo "$SVC\t$STATE\t$EN"
 627
 628         for i in $SMF_ENABLE
 629         do
 630                 is_imported $i
 631                 if [ $? = 1 ]
 632                 then
 633                         state=`svcprop -c -p restarter/state \
 634                             svc:/system/${i}:default`
 635                         en=`svcprop -c -p general/enabled \
 636                             svc:/system/${i}:default`
 637                         check_fs_local_grouping $i
 638                         if [ $? -ne 0 ]
 639                         then
 640                                 svc="${i}***"
 641                                 grp_error_flg=$((grp_error_flg + 1))
 642                         else
 643                                 svc=$i
 644                         fi
 645
 646                         echo "$svc\t$state\t$en"
 647                 fi
 648         done
 649
 650         print "\nAvailability Suite Configuration:"
 651         printf "Local configuration database: "
 652         if [ $VALID_LOCAL_DB = 1 ]
 653         then
 654                 print "valid"
 655         else
 656                 print "invalid"
 657         fi
 658
 659         if [ $CLUSTER_CONFIGURED = 1 ]
 660         then
 661                 printf "cluster configuration database: "
 662                 if [ $VALID_CLUSTER_DB = 1 ]
 663                 then
 664                         print "valid"
 665                         print "cluster configuration location: ${FILE_LOC}"
 666                 else
 667                         print "invalid"
 668                 fi
 669         fi
 670
 671         if [ $grp_error_flg -gt 0 ]
 672         then
 673                 typeset p
 674                 typeset p_has
 675                 if [ $grp_error_flg -gt 1 ]
 676                 then
 677                         p="s"
 678                         p_has="have"
 679                 else
 680                         p=""
 681                         p_has="has"
 682                 fi
 683
 684                 printf "\n*** Warning: The service$p above $p_has an incorrect "
 685                 printf "dependency.  To repair the\n"
 686                 printf "problem, run \"dscfgadm\".\n"
 687         fi
 688 }
 689
 690 #
 691 # initialize the local configuration database (only called if none exists)
 692 # returns 0 if successful, 1 if failed
 693 #
 694 initialize_local_db()
 695 {
 696         $xopt
 697
 698         echo "Could not find a valid local configuration database."
 699         echo "Initializing local configuration database..."
 700         echo y | ${DSCFG} -i > /dev/null 2>&1
 701         ${DSCFG} -i -p ${PCONFIG} > /dev/null 2>&1
 702
 703         # Make sure the new location is initialized properly
 704         valid_local_dscfg_exists
 705         VALID_LOCAL_DB=$?
 706         if [ $VALID_LOCAL_DB != 1 ]
 707         then
 708                 echo "Unable to initialize local configuration database" >&2
 709                 return 1
 710         else
 711                 echo "Successfully initialized local configuration database"
 712         fi
 713
 714         return 0
 715 }
 716
 717 #
 718 # initialize the cluster configuration database, if necessary
 719 # returns 0 if successful, 1 if failed
 720 #
 721 initialize_cluster_db()
 722 {
 723         $xopt
 724
 725         if [ ! -n "$FILE_LOC" ]
 726         then
 727                 return 0
 728         fi
 729
 730         echo "Initializing cluster configuration database..."
 731         ${DSCFG} -s ${FILE_LOC} -C $CTAG_NULL > /dev/null 2>&1
 732         echo y | ${DSCFG} -i -C $CTAG_NULL > /dev/null 2>&1
 733         ${DSCFG} -i -p ${PCONFIG} -C $CTAG_NULL > /dev/null 2>&1
 734
 735         # make sure the cluster db is valid now
 736         valid_cluster_dscfg_exists
 737         VALID_CLUSTER_DB=$?
 738         if [ $VALID_CLUSTER_DB != 1 ]
 739         then
 740                 echo "Unable to initialize cluster configuration database" >&2
 741                         return 1
 742         else
 743                 echo "Successfully initialized cluster configuration database"
 744         fi
 745
 746         return 0
 747
 748 }
 749
 750 #
 751 # prompt the user for a config location and set AVS to use that location
 752 #
 753 set_cluster_config()
 754 {
 755
 756 $xopt
 757
 758 REPEAT=0
 759 while [ $REPEAT -eq 0 ]; do
 760   # See if user has entered location already, and it was an existing
 761   # db.  Retruns FILE_LOC value
 762   if [ $VALID_DB_ENTERED = 1 ]; then
 763
 764         # reset
 765       VALID_DB_ENTERED=0
 766         preserve_overwrite_maybe
 767
 768         # if 1, location passes, and FILE_LOC being passed to end, else
 769       # set VALID_CLUSTER_DB to 0 since the "valid one" isn't valid anymore
 770       # (bad size, etc) thereby when looping go straight to get_location
 771       if [ $? = 1 ]; then
 772           REPEAT=1
 773           continue
 774       else
 775           VALID_CLUSTER_DB=0
 776           continue
 777       fi
 778   fi
 779
 780   # if 1, then valid db exists, now see what user wants to do
 781   if [ $VALID_CLUSTER_DB = 1 ]; then
 782       SAFE_LOC=$FILE_LOC
 783       keep_it
 784
 785       # if 0, then user can't or won't keep location.  set PROMPT
 786       # so we will get new location from user.
 787       if [ $? = 0 ]; then
 788           PROMPT=0
 789       else
 790           PROMPT=1
 791         fi
 792   fi
 793
 794   # if either are 0, then user wants or needs new db as outlined in
 795   # earlier comments
 796   if [ $VALID_CLUSTER_DB = 0 ] || [ $PROMPT = 0 ]; then
 797         #
 798         # We cannot proceed if the services are running.  Give the user
 799         # a chance to stop the services.  If he chooses not to, bail.
 800         #
 801         check_enabled
 802         if [ $? = 1 ]
 803         then
 804                 show_enabled
 805                 ask_to_disable
 806                 if [ $? = 0 ]
 807                 then
 808                         echo "A new configuration location was not set."
 809                         exit 1
 810                 else
 811                         disable_services
 812                         if [ $? != 0 ]
 813                         then
 814                                 exit 1
 815                         fi
 816                 fi
 817
 818         fi
 819
 820         get_location
 821         contains_data $FILE_LOC
 822
 823         # if 1, then user entered an existsing db location, loop
 824         # back to ask what to do with it
 825         if [ $? = 1 ]; then
 826           VALID_DB_ENTERED=1
 827           continue
 828         else
 829           check_location $FILE_LOC
 830
 831           # if 0, that means location has failed, loop and
 832           # get_location again
 833           if [ $? = 0 ]; then
 834                 VALID_CLUSTER_DB=0
 835                 continue
 836           fi
 837           # entered location passes tests
 838           REPEAT=1
 839           continue
 840         fi
 841   else
 842       # user wants to leave location where and how it is
 843         # FILE_LOC being passed all the way to end
 844         REPEAT=1
 845         continue
 846   fi
 847 done
 848
 849 }
 850
 851 ########################## MAIN FUNCTIONS ############################
 852
 853 ######################## SMF HELPER FUNCTIONS ########################
 854 #
 855 # check if any SMF service is online (enabled)
 856 #
 857 check_enabled()
 858 {
 859         $xopt
 860         typeset ret=0
 861         typeset svc
 862
 863         for svc in $SMF_ENABLE
 864         do
 865                 is_enabled $svc
 866                 eval ${svc}_enabled=$?
 867                 ret=$((ret | ${svc}_enabled))
 868         done
 869
 870         return $ret
 871 }
 872
 873 #
 874 # Display which services are enabled.  (Must be called after check_enabled)
 875 #
 876 show_enabled()
 877 {
 878         $xopt
 879         typeset svc
 880
 881         echo "\nThe following Availability Suite services are enabled:"
 882
 883         for svc in $SMF_ENABLE
 884         do
 885         if (( ${svc}_enabled == 1 ))
 886         then
 887             printf "$svc "
 888         fi
 889         done
 890
 891         echo ""
 892 }
 893
 894
 895 #
 896 # check if the given SMF service is online (enabled)
 897 #
 898 # $1: service name to check for
 899 #
 900 is_enabled()
 901 {
 902         $xopt
 903         typeset en
 904
 905         is_imported $1
 906         if [ $? = 1 ]
 907         then
 908                 en=`svcprop -c -p general/enabled svc:/system/${1}:default`
 909                 if [ $en = "true" ]
 910                 then
 911                         return 1
 912                 fi
 913         fi
 914
 915         return 0
 916
 917 }
 918
 919 #
 920 # If necessary, flag no dependency check
 921 #
 922 no_depend_check()
 923 {
 924         $xopt
 925         typeset pid
 926         typeset msg=0
 927
 928         if [ $OS_MINOR -lt 11 ]
 929         then
 930                 if [ -f $DSCFG_DEPEND_NOCHK ]
 931                 then
 932                         pid=`cat $DSCFG_DEPEND_NOCHK`
 933                         echo "Another dscfgadm disable is in progress."
 934                         echo "Waiting for pid: $pid to terminate..."
 935
 936                         while [ -f $DSCFG_DEPEND_NOCHK ]
 937                         do
 938                                 if (( msg && (msg % 6 == 0)))
 939                                 then
 940                                         printf "\nAnother dscfgadm disable "
 941                                         printf "(pid: $pid) still appears to "
 942                                         printf " be in progress.\n"
 943                                         printf "If this is not the case, you "
 944                                         printf "may remove "
 945                                         printf "$DSCFG_DEPEND_NOCHK.\n"
 946                                 fi
 947                                 sleep 5
 948                                 msg=$((msg + 1))
 949                         done
 950                 fi
 951
 952                 touch $DSCFG_DEPEND_NOCHK
 953                 echo $$ >> $DSCFG_DEPEND_NOCHK
 954         fi
 955 }
 956
 957 #
 958 # If necessary, remove the no dependency check flag
 959 #
 960 rm_no_depend_check()
 961 {
 962         $xopt
 963         if [ $OS_MINOR -lt 11 ]
 964         then
 965                 rm -f $DSCFG_DEPEND_NOCHK
 966         fi
 967 }
 968
 969 #
 970 # set the filesystem/local dependency type and refresh
 971 #
 972 # $1: service name
 973 # $2: either "require_all" or "optional_all"
 974 #
 975 set_fs_local_grouping()
 976 {
 977         $xopt
 978         typeset svc=$1
 979         typeset dep_group=$2
 980
 981         # set proper dependency type for fs-local
 982         if [ $svc != nws_rdcsyncd ]; then
 983                 svccfg -s $FS_LOCAL_SVC setprop \
 984                    ${svc}-local-fs/grouping=$dep_group
 985                 if [ $? -ne 0 ]
 986                 then
 987                         printf "command failed: svccfg -s $FS_LOCAL_SVC "
 988                         printf "setprop ${svc}-local-fs/grouping=$dep_group "
 989                         printf ">&2\n"
 990                         return 1
 991                 fi
 992
 993                 # we need local-fs to know about the new grouping attributes
 994                 svcadm refresh ${FS_LOCAL_SVC}:default
 995                 if [ $? -ne 0 ]
 996                 then
 997                         print "Failed to refresh ${FS_LOCAL_SVC} >&2"
 998                         return 1
 999                 fi
1000         fi
1001
1002         return 0
1003 }
1004
1005 #
1006 # check if the grouping dependency type for filesystem/local is correct
1007 #
1008 # input:
1009 # $1: service name
1010 #
1011 # returns:
1012 #       0 if the setting is correct
1013 #       1 if the setting is incorrect
1014 # outputs: sets CORRECT_GROUPING with the value of what the grouping should be.
1015 #
1016 check_fs_local_grouping()
1017 {
1018         $xopt
1019         typeset svc=$1
1020         typeset cur_grouping
1021
1022         if [ $svc = nws_rdcsyncd ]
1023         then
1024                 return 0
1025         fi
1026
1027         # If it's not imported, we just return success, since we don't want
1028         # further processing
1029         is_imported $svc
1030         if [ $? = 0 ]
1031         then
1032                 return 0
1033         fi
1034
1035         # get the current grouping value from the repository
1036         cur_grouping=`svcprop -c -p ${svc}-local-fs/grouping $FS_LOCAL_SVC`
1037
1038         # Figure out what the grouping should be (based on enabled status)
1039         is_enabled $svc
1040         if [ $? = 1 ]
1041         then
1042                 CORRECT_GROUPING="require_all"
1043         else
1044                 CORRECT_GROUPING="optional_all"
1045         fi
1046
1047         if [ "$cur_grouping" != "$CORRECT_GROUPING" ]
1048         then
1049                 # grouping is incorrect
1050                 return 1
1051         else
1052                 # grouping is just fine
1053                 return 0
1054         fi
1055 }
1056
1057 #
1058 # enable/disable the given SMF service.  Also, update the filesystem-local
1059 # dependency, if appropriate.
1060 #
1061 # $1: service name to check for
1062 # $2: "enable" or "disable"
1063 #
1064 svc_operation()
1065 {
1066         $xopt
1067         typeset svc=$1
1068         typeset command=$2
1069         typeset enable_state
1070         typeset dep_group
1071
1072         # If disabling, then enable_state better be true, and we are
1073         # transitioning to "option_all" grouping
1074         if [ $command = "disable" ]
1075         then
1076                 enable_state=1
1077                 dep_group="optional_all"
1078
1079         # If enabling, then enable_state better be false, and we are
1080         # transitioning to "require_all" grouping
1081         elif [ $command = "enable" ]
1082         then
1083                 enable_state=0
1084                 dep_group="require_all"
1085         else
1086                 echo "invalid command: $command" >&2
1087         fi
1088
1089         is_imported $svc
1090         if [ $? = 1 ]
1091         then
1092                 is_enabled $svc
1093                 if [ $? = $enable_state ]
1094                 then
1095                         if [ $enable_state -eq 1 ]
1096                         then
1097                                 # we're doing a disable--remove hard dependency
1098                                 set_fs_local_grouping $svc $dep_group
1099                                 if [ $? -ne 0 ]
1100                                 then
1101                                         return 1
1102                                 fi
1103                         fi
1104
1105                         svcadm $command -s svc:/system/$svc
1106                         if [ $? != 0 ]
1107                         then
1108                                 echo "$svc failed to $command" >&2
1109                                 return 1
1110                         fi
1111
1112                         if [ $enable_state -eq 0 ]
1113                         then
1114                                 # we just did an enable--create hard dependency
1115                                 set_fs_local_grouping $svc $dep_group
1116                                 if [ $? -ne 0 ]
1117                                 then
1118                                         return 1
1119                                 fi
1120                         fi
1121
1122                 else
1123                         echo "$svc service already ${command}d... skipping"
1124                 fi
1125         fi
1126
1127         return 0
1128 }
1129
1130 #
1131 # This chart summarizes the behavior of the -r and -p sub-options for the
1132 # -e and -d options.
1133 # There are 5 possible states, and 5 transitions out of each state.
1134 #
1135 # states: (vertical axis)
1136 # -------
1137 # 0: no services enabled
1138 # C: one or both core services enabled (illegal state)
1139 # R: both core services and RM services enabled
1140 # P: both core services and PITC service enabled
1141 # A: all services enabled
1142 #
1143 # transitions: (horizontal axis)
1144 # ------------
1145 # +/-a: enable/disable, respectively, with neither -r nor -p
1146 # +/-r: enable/disable, respectively, with -r flag
1147 # +p: enable with -p flag
1148 #
1149 # The result of the function is the next state after the action has been
1150 # successfully performed.
1151 #
1152 #      +a | -a | +r | -r | +p |
1153 #   ++----+----+----+----+----+
1154 #   ++----+----+----+----+----+
1155 # 0 || A  | 0* | R  | 0* | P  |
1156 # --++----+----+----+----+----+
1157 # C || A* | 0* | R  | 0  | P  |
1158 # --++----+----+----+----+----+
1159 # R || A* | 0* | R* | 0  | A  |
1160 # --++----+----+----+----+----+
1161 # P || A* | 0* | A* | P* | P* |
1162 # --++----+----+----+----+----+
1163 # A || A* | 0  | A* | P  | A* |
1164 # --++----+----+----+----+----+
1165 #
1166 # *: warning message is displayed, stating that a service is already
1167 #    enabled/disabled.
1168 #
1169
1170 # enable the SMF services needed for the Availability Suite
1171 #
1172 enable_services()
1173 {
1174         $xopt
1175         typeset svc
1176
1177         # first, import them if they have not yet been imported
1178         import_services
1179
1180         # if neither r_flag nor p_flag is set, enable all services
1181         if (( (r_flag | p_flag) == 0 ))
1182         then
1183                 for svc in $SMF_ENABLE
1184                 do
1185                         if ! svc_operation $svc enable
1186                         then
1187                                 return 1
1188                         fi
1189                 done
1190         else
1191                 # figure out which services are enabled
1192                 check_enabled
1193
1194                 # First, make sure both core services are enabled
1195                 for svc in nws_scm nws_sv
1196                 do
1197                         if (( ${svc}_enabled == 0 )) && \
1198                                 ! svc_operation $svc enable
1199                         then
1200                                 return 1
1201                         fi
1202                 done
1203
1204                 if ((p_flag))
1205                 then
1206                         if ! svc_operation nws_ii enable
1207                         then
1208                                 return 1
1209                         fi
1210                 fi
1211
1212                 if ((r_flag))
1213                 then
1214                         for svc in nws_rdc nws_rdcsyncd
1215                         do
1216                                 if ! svc_operation $svc enable
1217                                 then
1218                                         return 1
1219                                 fi
1220                         done
1221                 fi
1222
1223         fi
1224
1225         return 0
1226 }
1227
1228 #
1229 # disable the SMF services needed for the Availability Suite
1230 #
1231 disable_services()
1232 {
1233         $xopt
1234         typeset svc
1235
1236         check_device_groups
1237         if [ $? == 1 ]
1238         then
1239                 return 1
1240         fi
1241
1242         # This flags the shutdown scripts to not check to make sure the
1243         # services' dependents have been disabled.  The flag must be removed
1244         # before returning from this function.
1245         no_depend_check
1246
1247         # NB: p_flag is not allowed for disables.  II should not be
1248         # disabled if sndr is enabled.  If rdc is not enabled, disabling just
1249         # II is equivalent to disabling all the remaining services.
1250
1251         # If no flags passed in, just disable everything
1252         if (( r_flag == 0 ))
1253         then
1254                 for svc in $SMF_DISABLE
1255                 do
1256                         if ! svc_operation $svc disable
1257                         then
1258                                 rm_no_depend_check
1259                                 return 1
1260                         fi
1261                 done
1262
1263                 # Now that we've disable the services, lets unload them
1264                 # from the Solaris kernel
1265                 #
1266                 modinfo | grep '(nws:' | grep -v "kRPC Stub" | sort -r | cut -d' ' -f1 | xargs -l modunload -i 2>/dev/null
1267                 modinfo | grep '(nws:' | grep -v "kRPC Stub" | sort -r | cut -d' ' -f1 | xargs -l modunload -i 2>/dev/null
1268         else
1269                 # we're disabling just rdc.  If II is not already enabled,
1270                 # we disable core services, as well.
1271
1272                 # figure out which services are enabled
1273                 check_enabled
1274
1275                 for svc in nws_rdcsyncd nws_rdc
1276                 do
1277                         if ! svc_operation $svc disable
1278                         then
1279                                 rm_no_depend_check
1280                                 return 1
1281                         fi
1282                 done
1283
1284                 if (( nws_ii_enabled == 0 ))
1285                 then
1286                         for svc in nws_sv nws_scm
1287                         do
1288                                 if ((${svc}_enabled)) && \
1289                                         ! svc_operation $svc disable
1290                                 then
1291                                         rm_no_depend_check
1292                                         return 1
1293                                 fi
1294                         done
1295                 fi
1296         fi
1297
1298
1299         rm_no_depend_check
1300         return 0
1301 }
1302
1303 #
1304 # check if a service has been imported into the repository
1305 # $1: service to check
1306 # returns 1 if it is imported, 0 if it is not
1307 #
1308 is_imported()
1309 {
1310         $xopt
1311
1312         typeset svc=$1
1313
1314         svcprop -q -p general/entity_stability svc:/system/${svc}
1315         if [ $? = 1 ]
1316         then
1317                 return 0
1318         else
1319                 return 1
1320         fi
1321 }
1322
1323 #
1324 # import the SMF services into the repository, if necessary
1325 #
1326 import_services()
1327 {
1328         $xopt
1329         typeset svc
1330
1331         for svc in $SMF_ENABLE
1332         do
1333                 import_service $svc
1334         done
1335 }
1336
1337 #
1338 # check to see if an SMF service is in the repository.  If it is not,
1339 # import it in.
1340 # $1: name of service to import
1341 #
1342 import_service()
1343 {
1344         $xopt
1345         typeset svc=$1
1346
1347         is_imported $svc
1348         if [ $? = 0 ]
1349         then
1350                 if [ -f $PKG_INSTALL_ROOT/$MANIFEST_PATH/$svc.xml ]
1351                 then
1352                         svccfg import $PKG_INSTALL_ROOT/$MANIFEST_PATH/$svc.xml
1353
1354                         if [ $OS_MINOR -lt 11 ]
1355                         then
1356                                 # workaround for 6221374--let local-fs know
1357                                 # that it depends on us.
1358                                 svcadm refresh ${FS_LOCAL_SVC}:default
1359                         fi
1360                 fi
1361         fi
1362 }
1363
1364
1365 ########################## MAIN ######################################
1366
1367 # getopt processing
1368 enable=0
1369 disable=0
1370 set_location=0
1371 get_info=0
1372 r_flag=0
1373 p_flag=0
1374 while getopts "xedsirp" opt 2>/dev/null
1375 do
1376         case $opt in
1377         \?)
1378                 help
1379                 ;;
1380         e)
1381                 enable=1
1382                 ;;
1383         d)
1384                 disable=1
1385                 ;;
1386         x)
1387                 xopt="set -x"
1388                 set -x
1389                 ;;
1390         s)
1391                 set_location=1
1392                 ;;
1393         i)
1394                 get_info=1
1395                 ;;
1396         r)
1397                 r_flag=1
1398                 ;;
1399         p)
1400                 p_flag=1
1401                 ;;
1402         esac
1403 done
1404
1405 # at most one option (besides -x) may be specified at a time
1406 options_count=$((enable + disable + set_location + get_info))
1407 if [ $options_count -gt 1 ]
1408 then
1409         help
1410 elif [ $options_count = 0 ]
1411 then
1412         NO_ARGS=1
1413 fi
1414
1415 if (( ((r_flag + p_flag) > 0) && ((enable | disable) == 0) ))
1416 then
1417         echo "-r and -p options may only be used with -d or -e options" >&2
1418         return 1
1419 elif (( p_flag && disable ))
1420 then
1421         echo "The -p option may not be used with the -d option" >&2
1422         return 1
1423 fi
1424
1425
1426
1427 # set all the system information variables
1428 get_system_state
1429
1430 # if we're enabling, we need to make sure we have a valid dscfg out there.
1431 if [ $enable = 1 -a $VALID_LOCAL_DB != 1 ]
1432 then
1433         echo "Cannot find a valid configuration database" >&2
1434         return 1
1435 fi
1436
1437 if [ $NO_ARGS = 1 ]
1438 then
1439
1440         # only initialize the database if necessary
1441         if [ $VALID_LOCAL_DB = 1 ]; then
1442                 echo "Local configuration database is already initialized."
1443         else
1444                 initialize_local_db
1445                 if [ $? != 0 ]; then
1446                         return 1
1447                 fi
1448         fi
1449
1450         if [ $CLUSTER_CONFIGURED = 1 ]
1451         then
1452                 if [ $VALID_CLUSTER_DB = 1 ]; then
1453                         printf "Cluster configuration database is already "
1454                         printf "initialized.\n"
1455                 else
1456                         # ask the user for a cluster database location
1457                         set_cluster_config
1458
1459                         # initialize the new db
1460                         initialize_cluster_db
1461                         if [ $? != 0 ]; then
1462                                 return 1
1463                         fi
1464                 fi
1465
1466         fi
1467
1468         # make sure that the local filesystem dependency type is correct
1469         for svc in $SMF_ENABLE
1470         do
1471                 check_fs_local_grouping $svc
1472                 if [ $? -ne 0 ]
1473                 then
1474                         # NOTE: check_fs_local_grouping sets CORRECT_GROUPING
1475                         # To avoid this issue in the future, always administer
1476                         # the services using dscfgadm.
1477                         printf "Warning: Fixing dependency for $svc.\n"
1478                         set_fs_local_grouping $svc $CORRECT_GROUPING
1479                         if [ $? -ne 0 ]
1480                         then
1481                                 return 1
1482                         fi
1483                 fi
1484         done
1485
1486         # give the user the chance to startup AVS services, if not started
1487         check_enabled
1488         if [ $? = 1 ]; then
1489                 if [ $OLD_VALID_LOCAL_DB = 0 ]; then
1490                         printf "WARNING: AVS services are running on a system "
1491                         printf "which had no valid configuration\ndatabase\n"
1492                 fi
1493                 show_enabled
1494         else
1495                 ask_to_enable
1496                 if [ $? = 1 ]; then
1497                         enable_services
1498                         if [ $? != 0 ]
1499                         then
1500                                 return 1
1501                         fi
1502                 fi
1503         fi
1504
1505 elif [ $enable = 1 ]
1506 then
1507         enable_services
1508         if [ $? != 0 ]
1509         then
1510                 return 1
1511         fi
1512
1513 elif [ $disable = 1 ]
1514 then
1515         disable_services
1516         if [ $? != 0 ]
1517         then
1518                 return 1
1519         fi
1520
1521 elif [ $get_info = 1 ]
1522 then
1523         display_info
1524
1525 elif [ $set_location = 1 ]
1526 then
1527         if [ $CLUSTER_CONFIGURED = 1 ]
1528         then
1529                 # ask the user for a cluster database location
1530                 set_cluster_config
1531
1532                 # initialize the new db
1533                 initialize_cluster_db
1534                 if [ $? != 0 ]; then
1535                         return 1
1536                 fi
1537         else
1538                 echo "$PROG -s is only available on Sun Cluster OE systems" >&2
1539                 return 1
1540         fi
1541 fi
1542
1543 return 0
1544
1545
1546 ########################## MAIN ######################################
1547