Validating Host Deployment with HostChecker
Deployment / Validating Host Deployment with HostChecker

Delphix has developed a hostchecker script that contains standardized checks for source and target hosts - these checks generally fall into three buckets
  • OS and Host permissions/access
  • Network Port Checks
  • DB-specific functionality

OS and Host permissions/access and network port checks can (and should) be performed prior to Delphix installation to ensure a smooth deployment.

Each DB should have a specifically associated hostchecker - you can find detailed documentation on the DB-specific hostchecker page.

  1. Download the appropriate HostChecker tarball for your engine from https://download.delphix.com/. Tarballs follow the naming convention "hostchecker_<OS>_<processor>.tar". For example, if you are validating a linux x86 host you should download the hostchecker_linux_x86.tar tarball. 

  2. Create a working directory and extract the HostChecker files from the HostChecker tarball.

    mkdir dlpx-host-checker
cd dlpx-host-checker/
tar -xf hostchecker_linux_x86.tar

  3. Run the sh script contained within:

    sh hostchecker.sh

    This will extract the JDK included in the tarball (if necessary) and invoke the HostChecker. 

    ora10205@bbdhcp:/home/ora10205/hostchecker-> sh hostchecker.sh
Extracting the JDK from the tarball jdk-6u45-linux-i586.tar.gz.

    Don't Run as Root

    Do not run the HostChecker as root; this will cause misleading or incorrect results from many of the checks.

  4. Select which checks you want to run. 

    Run Tests without the Interface

    You can also run checks without spawning the interface. Enter --help to get a list of arguments you can pass to the HostChecker.

  5. As the checks are made, enter the requested arguments.

  6. Read the output of the check.  
    The general format is that severity increases as you scroll down the output. First comes informational output, then warnings, then errors.

    Internal Errors

    If you see a message that starts with Internal Error, forward it to Delphix Support immediately. This represents a potential bug in the HostChecker, and not necessarily a problem with your environment.

  7. Error or warning messages will explain any possible problems and how to address them. Resolve the issues that the HostChecker describes. Do not be surprised or undo your work if more errors appear the next time you run HostChecker, because the error you just fixed may have been masking other problems.
  8. Repeat steps 3 - 7 until all the checks return no errors or warnings.