ipa-test-task(1)


NAME

   ipa-test-task - Run a task for FreeIPA testing

SYNOPSIS

   ipa-test-task -h
   ipa-test-task [global-options] TASK [task-options]

DESCRIPTION

   Run  a task using FreeIPA integration testing configuration.  This tool
   is meant for use in scripts that test FreeIPA functionality.  See  ipa-
   test-config(1) for FreeIPA integration test configuration.

   This  tool  should never be run in a production environment.  It is not
   designed with security in mind.

GLOBAL OPTIONS

   -h, --help
          Print out the command's  usage  and  exit.   If  given  after  a
          subcommand, prints that subcommand's usage message.

   --with-beakerlib
          Enable  BeakerLib  integration.   Log  messages are reported via
          beakerlib(1) commands.  This option requires an active BeakerLib
          phase.

SUBCOMMANDS

   ipa-test-task install-master [--host HOST]
          Install  an  initial  IPA  server  on  the given host, or on the
          configured master if --host is not given.

   ipa-test-task install-replica [--master MASTER] HOST
          Install an IPA replica on the given  host.   It  is  initialized
          from  the  IPA  server given by --master, or from the configured
          master if --master is not given.

   ipa-test-task install-client [--master MASTER] HOST
          Install an IPA client on the given host.  It is initialized from
          the  IPA server given by --master, or from the configured master
          if --master is not given.

   ipa-test-task connect-replica HOST1 HOST2
          Create a replication agreement between two given replicas.

   ipa-test-task disconnect-replica HOST1 HOST2
          Remove a replication agreement between two given replicas.

   ipa-test-task uninstall-server [HOST [HOST ...]]
          Uninstall an  IPA  server  (master  or  replica)  on  the  given
          host(s),   and   restore   the   host(s)  to  the  state  before
          installation.  If no host is given,  uninstalls  all  configured
          masters and replicas.  If no server is installed on a host, does
          nothing on that host.

   ipa-test-task uninstall-client [HOST [HOST ...]]
          Uninstall an IPA client on the given host(s),  and  restore  the
          host(s)  to the state before installation.  If no host is given,
          uninstalls all configured clients.  If no client is installed on
          a host, does nothing on that host.

   ipa-test-task uninstall-all
          Uninstall  IPA  from  all  configured master, replica and client
          hosts.    Equivalent    to    running    uninstall-server    and
          uninstall-client without arguments.

   ipa-test-task cleanup [HOST [HOST ...]]
          Restore  system  configuration (such as /etc/resolv.conf) on the
          given hosts to a state before installation.   If  no  hosts  are
          given,  clean  up  all  configured hosts.  This functionality is
          included in the uninstall-* subcommands  and  is  rarely  useful
          alone.

   ipa-test-task  install-topo  [--skip-master] [--skip-clients] [--master
   M] [--replicas R1 [R2...]] [--clients C1 [C2 ...]] TOPO
          Install a number of FreeIPA servers and  clients  in  the  given
          topology.  Use the list-topos subcommand for a list of available
          topologies.

          Unless --skip-master is given, an initial server is installed on
          the  host  given  by  --master,  or  on the configured master if
          --master is missing.

          Replicas are installed according to  the  selected  topology  on
          hosts given by --replicas, or on all configured replicas if that
          option is not given.

          Unless --skip-clients is given, clients are installed  on  hosts
          given by --clients, or on all configured clients if --clients is
          not given.  Servers used for client installation are selected in
          a round-robin fashion.

   ipa-test-task list-topos
          List the topologies available for the install-topo subcommand.

   ipa-test-task install-adtrust HOST
          Run  ipa-adtrust-install  on  the  IPA and generate SIDs for the
          entries in IPA.

   ipa-test-task configure-dns-for-trust HOST AD
          Based on the relationship of the domains configures the IPA  DNS
          for trust.  AD DNS needs to be setup manually.

   ipa-test-task establish-trust-with-ad HOST AD
          Establishes  trust with Active Directory. Trust type is detected
          depending on the presence of SfU (Services for Unix) support  on
          the AD.

   ipa-test-task remove-trust-with-ad HOST AD
          Removes trust with Active Directory. Also removes the associated
          ID range.

   ipa-test-task configure-auth-to-local-rule HOST AD
          Configures auth_to_local rule in /etc/krb5.conf

   ipa-test-task clear-sssd-cache HOST
          Clears SSSD cache by removing the cache files. Restarts SSSD.

   ipa-test-task setup-sssd-debugging HOST
          Sets up SSSD debugging. Restarts SSSD.

   ipa-test-task sync-time HOST SERVER
          Syncs the time with the remote server.  Please  note  that  this
          function leaves ntpd stopped.

   ipa-test-task add-a-records-in-master-domain MASTER
          Adds A records to the IPA master for all the hosts in the master
          domain.

   ipa-test-task add-a-record MASTER HOST
          Adds an A record for the host to the IPA master.

EXIT STATUS

   0 if the command was successful

   nonzero if an error occurred

REFERENCES

   A full description of the  FreeIPA  integration  testing  framework  is
   available at http://www.freeipa.org/page/V3/Integration_testing





Opportunity


Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.





Free Software


Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.


Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.





Free Books


The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.


Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.





Education


Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.


Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.