1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
|
.\" A man page for ipa-test-config
.\" 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-config" "1" "Aug 29 2013" "FreeIPA" "FreeIPA Manual Pages"
.SH "NAME"
ipa\-test\-config \- Generate FreeIPA test configuration for use in Bash scripts
.SH "SYNOPSIS"
ipa\-test\-config [options]
.br
ipa\-test\-config [options] --global
.br
ipa\-test\-config [options] hostname
.SH "DESCRIPTION"
The FreeIPA integration test suite is configured by setting environment
variables.
The ipa\-run\-tests command reads these variables and prints detailed
configuration for shell-based scripts to standard output.
The output of ipa\-run\-tests consists of export statements that can be
sourced by Bash.
If run without arguments, it prints out configuration specific to the local
host.
Another host may be specified as an argument, or via the \-\-master,
\-\-replica, and \-\-client options.
With the --global option, it prints only configuration that is not specific to
any host.
.SH "OPTIONS"
.TP
\fB\-h\fR, \fB\-\-help\fR
Print out the command's usage and exit
.TP
\fB\-\-global\fR
Output global configuration.
.TP
\fB\-\-domain\fR
Output configuration for the given domain (environment).
May be given as an index or name.
By default, domain 1 is used.
.TP
\fB\-\-master\fR
Output configuration for the master
.TP
\fB\-\-replica\fR
Output configuration for the replica with the given number
.TP
\fB\-\-replica\fR
Output configuration for the client with the given number
.TP
\fB\-\-no\-simple\fR
Do not output Simple Vars.
These are normally included for backwards compatibility.
.SH "ENVIRONMENT VARIABLES"
.TP
Host configuration:
.TP
\fB$MASTER\fR
FQDN of the first IPA server
.TP
\fB$REPLICA\fR
FQDNs of other IPA servers (space-separated)
.TP
\fB$CLIENT\fR
FQDNs of IPA clients (space-separated)
.TP
\fB$MASTER_env2\fR, \fB$REPLICA_env2\fR, \fB$CLIENT_env2\fR, \fB$MASTER_env3\fR, ...
can be used for additional domains when needed
.TP
\fB$BEAKER\fR<role><num>\fB_IP_env\fR<e>, e.g. \fB$BEAKERREPLICA1_IP_env1\fR
the IP address of the given host
Default: resolved via gethostbyname (or DNS if $IPv6SETUP is set)
.TP
Basic configuration:
.TP
\fB$IPATEST_DIR\fR
Directory for test data on the remote hosts
Default: /root/ipatests
.TP
\fB$DNSFORWARD\fR
IP of a DNS forwarder
Default: 8.8.8.8
.TP
\fB$IPA_ROOT_SSH_PASSWORD\fR
root password for the remote machines
Used if $IPA_ROOT_SSH_KEY is not set.
.TP
\fB$IPA_ROOT_SSH_KEY\fR
name of a file containing the private RSA key for root on the remote machines
Default: ~/.ssh/id_rsa
.TP
Test customization:
.TP
\fB$DOMAIN\fR
IPA domain name
Default: taken from $MASTER
.TP
\fB$NISDOMAIN\fR
NIS domain name
Default: ipatest
.TP
\fB$NTPSERVER\fR
NIS domain name
Default: ipatest
.TP
\fB$IPv6SETUP\fR
Set to TRUE for IPv6-only connectivity
.TP
\fB$IPADEBUG\fR
Set to enable test debugging
.TP
\fB$ADMINID\fR
Admin username
Default: admin
.TP
\fB$ADMINPW\fR
Admin user password
Default: Secret123
.TP
\fB$ROOTDN\fR
Directory manager DN
Default: cn=Directory Manager
.TP
\fB$ROOTDNPWD\fR
Directory manager password
Default: Secret123
.SH "EXIT STATUS"
0 if the command was successful
1 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
|
