From c81849712f8888e6f12b7c2b7ebfcf5d2294addd Mon Sep 17 00:00:00 2001 From: Tomas Babej Date: Mon, 10 Jun 2013 14:43:24 +0200 Subject: Provide ipa-advise tool Provides a pluggable framework for generating configuration scriptlets and instructions for various machine setups and use cases. Creates a new ipa-advise command, available to root user on the IPA server. Also provides an example configuration plugin, config-fedora-authconfig. https://fedorahosted.org/freeipa/ticket/3670 --- install/tools/Makefile.am | 1 + install/tools/ipa-advise | 23 ++++++++++++++++++++++ install/tools/man/Makefile.am | 1 + install/tools/man/ipa-advise.1 | 44 ++++++++++++++++++++++++++++++++++++++++++ 4 files changed, 69 insertions(+) create mode 100755 install/tools/ipa-advise create mode 100644 install/tools/man/ipa-advise.1 (limited to 'install') diff --git a/install/tools/Makefile.am b/install/tools/Makefile.am index 659ce0a8..2cf66c6d 100644 --- a/install/tools/Makefile.am +++ b/install/tools/Makefile.am @@ -23,6 +23,7 @@ sbin_SCRIPTS = \ ipa-upgradeconfig \ ipa-backup \ ipa-restore \ + ipa-advise \ $(NULL) EXTRA_DIST = \ diff --git a/install/tools/ipa-advise b/install/tools/ipa-advise new file mode 100755 index 00000000..4ec3c48c --- /dev/null +++ b/install/tools/ipa-advise @@ -0,0 +1,23 @@ +#! /usr/bin/python -E +# Authors: Tomas Babej +# +# Copyright (C) 2013 Red Hat +# see file 'COPYING' for use and warranty information +# +# 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 . +# + +from ipaserver.advise.base import IpaAdvise + +IpaAdvise.run_cli() diff --git a/install/tools/man/Makefile.am b/install/tools/man/Makefile.am index b16d2b5c..33e8a9e4 100644 --- a/install/tools/man/Makefile.am +++ b/install/tools/man/Makefile.am @@ -21,6 +21,7 @@ man1_MANS = \ ipa-managed-entries.1 \ ipa-backup.1 \ ipa-restore.1 \ + ipa-advise.1 \ $(NULL) man8_MANS = \ diff --git a/install/tools/man/ipa-advise.1 b/install/tools/man/ipa-advise.1 new file mode 100644 index 00000000..4c494aab --- /dev/null +++ b/install/tools/man/ipa-advise.1 @@ -0,0 +1,44 @@ +.\" A man page for ipa-advise +.\" 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 . +.\" +.\" Author: Tomas Babej +.\" +.TH "ipa-advise" "1" "Jun 10 2013" "FreeIPA" "FreeIPA Manual Pages" +.SH "NAME" +ipa\-advise \- Provide configurations advice for various use cases. +.SH "SYNOPSIS" +ipa\-advise ADVICE +.SH "DESCRIPTION" +Provides customized advice for various IPA configuration issues. +.TP +For the list of possible ADVICEs available, run the ipa\-advise with no arguments. +.SH "OPTIONS" +.TP +\fB\-\-v\fR, \fB\-\-verbose\fR +Print debugging information +.TP +\fB\-d\fR, \fB\-\-debug\fR +Alias for \-\-verbose +.TP +\fB\-q\fR, \fB\-\-quiet\fR +Output only errors +.TP +\fB\-\-log\-file\fR=\fIFILE\fR +Log to the given file +.SH "EXIT STATUS" +0 if the command was successful + +1 if an error occurred \ No newline at end of file -- cgit