1ipactl(8)                      IPA Manual Pages                      ipactl(8)
2
3
4

NAME

6       ipactl - IPA Server Control Interface
7

SYNOPSIS

9       ipactl command
10

DESCRIPTION

12       A tool to help an administer control an IPA environment.
13
14       IPA glues several discrete services together to work in concert and the
15       order that these services are started and stopped is important.  ipactl
16       ensures that they are started and stopped in the correct order.
17
18       IPA  stores  the  available masters and the services configured on each
19       one. The first thing ipactl does is start (if it is  not  already  run‐
20       ning)  the  IPA 389-ds instance to query what services it controls. The
21       hostname used in the query needs to match the  hostname  of  the  value
22       stored  in  LDAP.  This  can  be  controlled  with  the  host option in
23       /etc/ipa/default.conf. This should be a fully-qualified hostname.
24

OPTIONS

26       start  Start all of the services that make up IPA
27
28       stop   Stop all of the services that make up IPA
29
30       restart
31              Stop then start all of the services that make up IPA
32
33       status Provides status of all the services that make up IPA
34
35       -d, --debug
36              Display debugging information
37
38       --skip-version-check
39              Skip version check
40
41       --ignore-service-failures
42              If any service start fails, do not rollback the  services,  con‐
43              tinue with the operation
44
45       -f, --force
46              Force  IPA  to  start.  Combine options --skip-version-check and
47              --ignore-service-failures
48

EXIT STATUS

50       All actions except status:
51
52       0 success
53
54       1 a generic error occurred
55
56       2 unknown or invalid argument(s)
57
58       4 user has insufficient privilege
59
60       6 IPA server is not configured
61
62       For the status action:
63
64       0 service is running
65
66       3 service is not running
67
68       4 service status is unknown (or unconfigured)
69
70       If not executed as root then the status action will return 4 for insuf‐
71       ficient privileges.
72
73       Some  services are socket activated and may show as STOPPED by the sta‐
74       tus action. These services include ipa-ods-exporter and ipa-otpd.
75
76
77
78IPA                               Mar 14 2008                        ipactl(8)