mirror of
https://salsa.debian.org/freeipa-team/freeipa.git
synced 2024-12-26 08:51:50 -06:00
f93c88f398
See https://lintian.debian.org/tags/hyphen-used-as-minus-sign.html for an explanation. Reviewed-By: Martin Basti <mbasti@redhat.com>
170 lines
6.0 KiB
Groff
170 lines
6.0 KiB
Groff
.\" A man page for ipa-test-task
|
|
.\" Copyright (C) 2013 Red Hat, Inc.
|
|
.\"
|
|
.\" This program is free software; you can redistribute it and/or modify
|
|
.\" it under the terms of the GNU General Public License as published by
|
|
.\" the Free Software Foundation, either version 3 of the License, or
|
|
.\" (at your option) any later version.
|
|
.\"
|
|
.\" This program is distributed in the hope that it will be useful, but
|
|
.\" WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
.\" General Public License for more details.
|
|
.\"
|
|
.\" You should have received a copy of the GNU General Public License
|
|
.\" along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
.\"
|
|
.\" Author: Petr Viktorin <pviktori@redhat.com>
|
|
.\"
|
|
.TH "ipa-test-task" "1" "Aug 29 2013" "FreeIPA" "FreeIPA Manual Pages"
|
|
.SH "NAME"
|
|
ipa\-test\-task \- Run a task for FreeIPA testing
|
|
.SH "SYNOPSIS"
|
|
ipa\-test\-task \-h
|
|
.br
|
|
ipa\-test\-task [global-options] TASK [task-options]
|
|
.SH "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.
|
|
|
|
.SH "GLOBAL OPTIONS"
|
|
.TP
|
|
\fB\-h\fR, \fB\-\-help\fR
|
|
Print out the command's usage and exit.
|
|
If given after a subcommand, prints that subcommand's usage message.
|
|
|
|
.TP
|
|
\fB\-\-with\-beakerlib\fR
|
|
Enable BeakerLib integration.
|
|
Log messages are reported via beakerlib(1) commands.
|
|
This option requires an active BeakerLib phase.
|
|
|
|
.SH "SUBCOMMANDS"
|
|
.TP
|
|
\fBipa\-test\-task install\-master [\-\-host HOST]\fR
|
|
Install an initial IPA server on the given host, or on the configured master
|
|
if \-\-host is not given.
|
|
|
|
.TP
|
|
\fBipa\-test\-task install\-replica [\-\-master MASTER] HOST\fR
|
|
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.
|
|
|
|
.TP
|
|
\fBipa\-test\-task install\-client [\-\-master MASTER] HOST\fR
|
|
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.
|
|
|
|
.TP
|
|
\fBipa\-test\-task connect\-replica HOST1 HOST2\fR
|
|
Create a replication agreement between two given replicas.
|
|
|
|
.TP
|
|
\fBipa\-test\-task disconnect\-replica HOST1 HOST2\fR
|
|
Remove a replication agreement between two given replicas.
|
|
|
|
.TP
|
|
\fBipa\-test\-task uninstall\-server [HOST [HOST ...]]\fR
|
|
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.
|
|
|
|
.TP
|
|
\fBipa\-test\-task uninstall\-client [HOST [HOST ...]]\fR
|
|
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.
|
|
|
|
.TP
|
|
\fBipa\-test\-task uninstall\-all\fR
|
|
Uninstall IPA from all configured master, replica and client hosts.
|
|
Equivalent to running uninstall\-server and uninstall\-client without
|
|
arguments.
|
|
|
|
.TP
|
|
\fBipa\-test\-task cleanup [HOST [HOST ...]]\fR
|
|
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.
|
|
|
|
.TP
|
|
\fBipa\-test\-task install-topo [\-\-skip\-master] [\-\-skip\-clients] [\-\-master M] [\-\-replicas R1 [R2...]] [\-\-clients C1 [C2 ...]] TOPO\fR
|
|
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.
|
|
|
|
.TP
|
|
\fBipa\-test\-task list-topos\fR
|
|
List the topologies available for the install-topo subcommand.
|
|
|
|
.TP
|
|
\fBipa\-test\-task install\-adtrust HOST\fR
|
|
Run ipa-adtrust-install on the IPA and generate SIDs for the entries in IPA.
|
|
|
|
.TP
|
|
\fBipa\-test\-task configure\-dns\-for\-trust HOST AD\fR
|
|
Based on the relationship of the domains configures the IPA DNS for trust.
|
|
AD DNS needs to be setup manually.
|
|
|
|
.TP
|
|
\fBipa\-test\-task establish\-trust\-with\-ad HOST AD\fR
|
|
Establishes trust with Active Directory. Trust type is detected depending on
|
|
the presence of SfU (Services for Unix) support on the AD.
|
|
|
|
.TP
|
|
\fBipa\-test\-task remove\-trust\-with\-ad HOST AD\fR
|
|
Removes trust with Active Directory. Also removes the associated ID range.
|
|
|
|
.TP
|
|
\fBipa\-test\-task configure\-auth\-to\-local\-rule HOST AD\fR
|
|
Configures auth_to_local rule in /etc/krb5.conf
|
|
|
|
.TP
|
|
\fBipa\-test\-task clear\-sssd\-cache HOST\fR
|
|
Clears SSSD cache by removing the cache files. Restarts SSSD.
|
|
|
|
.TP
|
|
\fBipa\-test\-task setup\-sssd\-debugging HOST\fR
|
|
Sets up SSSD debugging. Restarts SSSD.
|
|
|
|
.TP
|
|
\fBipa\-test\-task sync\-time HOST SERVER\fR
|
|
Syncs the time with the remote server. Please note that this function leaves
|
|
ntpd stopped.
|
|
|
|
.TP
|
|
\fBipa\-test\-task add\-a\-records\-in\-master\-domain MASTER\fR
|
|
Adds A records to the IPA master for all the hosts in the master domain.
|
|
|
|
.TP
|
|
\fBipa\-test\-task add\-a\-record MASTER HOST\fR
|
|
Adds an A record for the host to the IPA master.
|
|
|
|
.SH "EXIT STATUS"
|
|
0 if the command was successful
|
|
|
|
nonzero if an error occurred
|
|
|
|
.SH "REFERENCES"
|
|
A full description of the FreeIPA integration testing framework is available at
|
|
http://www.freeipa.org/page/V3/Integration_testing
|