1ipa-test-task(1) FreeIPA Manual Pages ipa-test-task(1)
2
6 ipa-test-task - Run a task for FreeIPA testing
7
9 ipa-test-task -h
10 ipa-test-task [global-options] TASK [task-options]
11
13 Run a task using FreeIPA integration testing configuration. This tool
14 is meant for use in scripts that test FreeIPA functionality. See ipa-
15 test-config(1) for FreeIPA integration test configuration.
16 This tool should never be run in a production environment. It is not
18 designed with security in mind.
19
22 -h, --help
23 Print out the command's usage and exit. If given after a sub‐
24 command, prints that subcommand's usage message.
25 --with-beakerlib
28 Enable BeakerLib integration. Log messages are reported via
29 beakerlib(1) commands. This option requires an active BeakerLib
30 phase.
31
34 ipa-test-task install-master [--host HOST]
35 Install an initial IPA server on the given host, or on the con‐
36 figured master if --host is not given.
37 ipa-test-task install-replica [--master MASTER] HOST
40 Install an IPA replica on the given host. It is initialized
41 from the IPA server given by --master, or from the configured
42 master if --master is not given.
43 ipa-test-task install-client [--master MASTER] HOST
46 Install an IPA client on the given host. It is initialized from
47 the IPA server given by --master, or from the configured master
48 if --master is not given.
49 ipa-test-task connect-replica HOST1 HOST2
52 Create a replication agreement between two given replicas.
53 ipa-test-task disconnect-replica HOST1 HOST2
56 Remove a replication agreement between two given replicas.
57 ipa-test-task uninstall-server [HOST [HOST ...]]
60 Uninstall an IPA server (master or replica) on the given
61 host(s), and restore the host(s) to the state before installa‐
62 tion. If no host is given, uninstalls all configured masters
63 and replicas. If no server is installed on a host, does nothing
64 on that host.
65 ipa-test-task uninstall-client [HOST [HOST ...]]
68 Uninstall an IPA client on the given host(s), and restore the
69 host(s) to the state before installation. If no host is given,
70 uninstalls all configured clients. If no client is installed on
71 a host, does nothing on that host.
72 ipa-test-task uninstall-all
75 Uninstall IPA from all configured master, replica and client
76 hosts. Equivalent to running uninstall-server and unin‐
77 stall-client without arguments.
78 ipa-test-task cleanup [HOST [HOST ...]]
81 Restore system configuration (such as /etc/resolv.conf) on the
82 given hosts to a state before installation. If no hosts are
83 given, clean up all configured hosts. This functionality is
84 included in the uninstall-* subcommands and is rarely useful
85 alone.
86 ipa-test-task install-topo [--skip-master] [--skip-clients] [--master
89 M] [--replicas R1 [R2...]] [--clients C1 [C2 ...]] TOPO
90 Install a number of FreeIPA servers and clients in the given
91 topology. Use the list-topos subcommand for a list of available
92 topologies.
93 Unless --skip-master is given, an initial server is installed on
95 the host given by --master, or on the configured master if
96 --master is missing.
97 Replicas are installed according to the selected topology on
99 hosts given by --replicas, or on all configured replicas if that
100 option is not given.
101 Unless --skip-clients is given, clients are installed on hosts
103 given by --clients, or on all configured clients if --clients is
104 not given. Servers used for client installation are selected in
105 a round-robin fashion.
106 ipa-test-task list-topos
109 List the topologies available for the install-topo subcommand.
110 ipa-test-task install-adtrust HOST
113 Run ipa-adtrust-install on the IPA and generate SIDs for the
114 entries in IPA.
115 ipa-test-task configure-dns-for-trust HOST AD
118 Based on the relationship of the domains configures the IPA DNS
119 for trust. AD DNS needs to be setup manually.
120 ipa-test-task establish-trust-with-ad HOST AD
123 Establishes trust with Active Directory. Trust type is detected
124 depending on the presence of SfU (Services for Unix) support on
125 the AD.
126 ipa-test-task remove-trust-with-ad HOST AD
129 Removes trust with Active Directory. Also removes the associated
130 ID range.
131 ipa-test-task configure-auth-to-local-rule HOST AD
134 Configures auth_to_local rule in /etc/krb5.conf
135 ipa-test-task clear-sssd-cache HOST
138 Clears SSSD cache by removing the cache files. Restarts SSSD.
139 ipa-test-task setup-sssd-debugging HOST
142 Sets up SSSD debugging. Restarts SSSD.
143 ipa-test-task sync-time HOST SERVER
146 Syncs the time with the remote server. Please note that this
147 function leaves chronyd stopped.
148 ipa-test-task add-a-records-in-master-domain MASTER
151 Adds A records to the IPA master for all the hosts in the master
152 domain.
153 ipa-test-task add-a-record MASTER HOST
156 Adds an A record for the host to the IPA master.
157
160 0 if the command was successful
161 nonzero if an error occurred
163
166 A full description of the FreeIPA integration testing framework is
167 available at http://www.freeipa.org/page/V3/Integration_testing
168FreeIPA Aug 29 2013 ipa-test-task(1)