remote-hcu-services.prg

#!/usr/local/bin/php
<?php
  /*
   * Filename: hcu-services
   * 
   * mws 4/15/2013
   * 
   * Purpose: This script is intended to be executed from the command line.
   *          It will allow the user to turn enable/disable HomeCU Services.
   *          This is done by making changes to the cutrustedetail record where
   *          trustedid = 'HOMECUSERVICES' and cu = 'HOMECU'
   * 
   * Command Line Arguments:
   *          -s {Services} that will be affected by the script value
   *            Options are  ALL, or a list of services
   *           USAGE:
   *           -s ALL
   *           OR
   *           for one service
   *           -s IPAY 
   *           for multiple services
   *           -s IPAY -s ENSENTA
   *
   *          -a {Action} {on/off} this argument determines what the purpose of 
   *             the script should 
   *           USAGE:
   *           -a on for On
   *           -a off for Off
   *    
   *          -q {quiet} flag is set when listed.  When set, the program should NOT
   *           print any output
   */

  $suppressPrint = false;
  $serviceAction = "";      // ** Service actions {on/off}
  $serviceCodes = "";       // ** The services that will be affected {ALL for all services} or individual OR array of list
  $argsFound = true;       // ** Were ALL the necessary arguments found?

  // ** INCLUDE NEEDED SCRIPT
  require('remote-hcu-services.conf');
  require('cutrusted.i');
  require('dbenv.i');
  require('dbfunc.i');
  // ** Command line does NOT set _SERVER['SERVER_NAME'] -- use homecuServer from the remote-hcu-services.conf file
  $dbhost = ($homecuServer == 'monitor' ? 'localhost' : "db-" . $homecuServer);


  // ** Declare argument option list
  $options = Array("s:" => "required:",
                   "a:" => "required:",
                   "q"  => "optional");
  $opts = getopt(implode('', array_keys($options)), $options);

  // ** validate options
  // ** ACTION
  if (array_key_exists('a', $opts)) {
    if (strtolower($opts['a']) == 'on' || strtolower($opts['a']) == 'off') {
      $serviceAction = strtolower($opts['a']);
    } else {
      // ** Incorrect Syntact for -a
      $argsFound = false;
    }
  } else {
    // ** NO -a found
    $argsFound = false;
  }

  if (array_key_exists('s', $opts)) {
    $serviceCodes = $opts['s'];
  } else {
    // ** -s options NOT FOUND
    $argsFound = false;
  }
  if (array_key_exists('q', $opts)) {
    $suppressPrint = true;
  }

  if (!$argsFound) {
    print "
usage: hcu-services -a action -s service [-q]
    ";
    exit;
  }





  $dbh = db_pconnect();

  // ** Retrieve the HomeCU Services Record
  $trustSettings = Array('Cu' => prep_save($homecuTrustCU, 12), 'trustedid' => prep_save($homecuTrustID, 20));
  $retResp = cutd_read($dbh, $trustSettings);
  if ($retResp['status']['Response']) {
    // ** Verify the data 
    if ($retResp['data']["{$homecuTrustCU}|{$homecuTrustID}"]) {
      if (is_array($retResp['data']["{$homecuTrustCU}|{$homecuTrustID}"])) {
        $homecuServices = $retResp['data']["{$homecuTrustCU}|{$homecuTrustID}"];
        /* homecuServices
         * This should now be an array of key/value sets.
         *
         * key is the homecuService ie IPAY,ENSENTA
         *
         * value {Y, N, U}
         *
         *    N - Service is ONLINE
         *    Y - Service is OFFLINE - and stays down, if the script is set to enable services, this service will NOT change
         *    U - Service is OFFLINE - and if the script is set to enable services, the service value is set to N
         *
         * NOW -- LOOP through all the key/value sets
         *        when action is set to Off -a off, then turn all occurrences of N to U
         *        when action is set to On -a on, then turn all occurrencens of U to N
         * if -s ALL is set, then all services will be affected
         * if -s is an array of services, only those listed services should be affected
         *
         */
        foreach ($homecuServices as $itemService => $itemValue) {
          // ** First determine if we are on a correct service
          $foundService = false;
          if (is_array($serviceCodes)) {
            // ** Command line service codes is an ARRAY -- look up using in_array
            if (in_array($itemService, $serviceCodes)) {
              // ** CUTD Service was found in list of command line services to alter
              $foundService = true;
            }
          } elseif ((strtoupper($serviceCodes) == 'ALL') || ($serviceCodes == trim($itemService))) {
            // ** Command line service code is ALL -- Attempt to alter ALL services
            // ** OR
            // ** Command line referenced ONE code -- and it is a match
            $foundService = true;
          }
          if ($foundService) {
            // ** Now depending on the action -- perform update
            if ($serviceAction == 'on') {
              // * ONLY Update if current itemValue is U
              if ($itemValue == 'U') {
                $homecuServices[$itemService] = 'N';
              }
            } elseif ($serviceAction == 'off') {
              // * ONLY Update if current itemValue is N
              if ($itemValue == 'N') {
                $homecuServices[$itemService] = 'U';
              }
            }
          }

        }

        // ** AFTER SETTING ALL THE SERVICES
        //   ** I need to resave the trusted detail record with the new values
        $trustSettings = Array('Cu' => prep_save($homecuTrustCU, 12), 'trustedid' => prep_save($homecuTrustID, 20), 'fields' => $homecuServices);
        $retResp = cutd_write($dbh, $trustSettings);
        if ($retResp['status']['Response']) {
        } else {
          // ** ERROR - when updating the record
          if (!$suppressPrint) {print "\nError when updating the services.";}
        }
      } else {
        if (!$suppressPrint) {print "\nHomeCU Services Found. Data Not Valid";}
      }
    } else {
      if (!$suppressPrint) {print "\nHomeCU Services Found. No Services Data Found";}
    }
  } else {
    if (!$suppressPrint) {print "\nNo HomeCU Services Record Found.";}
  }


?>