bionic (1) fusiondirectory-setup.1.gz

NAME

       fusiondirectory-setup - FusionDirectory configuration management tool

DESCRIPTION

       This script is designed to perform multiple checks on your FusionDirectory/LDAP architecture, and fix
       usual misconfiguration.  Some extra features allow you to install FusionDirectory's plugins, and change
       destinations directories.

   Options
       --update-cache
           This option update the /var/cache/fusiondirectory/class.cache file. Which contain PHP classes used in
           FusionDirectory, and their location.

       --update-locales
           This option update internalization, by generating a new .mo locales file for each language, with
           every .po files it found.  Needs msgcat and msgfmt to be installed.

       --check-directories
           This option perform a check on all FusionDirectory's files or directories.

       --check-config
           This option perform a check on FusionDirectory's config file.

       --check-ldap
           This option check your LDAP tree. Looking for admin account, and groups or people branch. If one of
           those don't exists, the script will ask you what to do.

       --check-ids
           This option check your LDAP tree for duplicated uidNumber or gidNumber among users and groups.

       --migrate-users
           This option add FusionDirectory attributes to the people branch.

       --migrate-printers
           This option replace gosaPrinter objectClass by new fdPrinter objectClass.

       --migrate-dns
           This option moves DNS zones from systems branch to DNS branch, which is necessary for FusionDirectory
           1.0.10 and above.

       --migrate-dhcp
           This option moves DHCP configurations from systems branch to DHCP branch, which is necessary for
           FusionDirectory 1.0.17 and above.

       --migrate-acls
           This option will migrated old GOsa style acl from 1.0.7 into FusionDirectory acl roles in 1.0.8

       --delete-gosa-locks
           This option will delete old GOsa style lock tokens from 1.0.15 or older

       --install-plugins
           This option will install the plugin from a tar.gz of the plugin. This option is intended for people
           wanting to install from the sources.

       --encrypt-passwords
           This option will encrypt the password inside your fusiondirectory.conf file, it need the headers
           module to be activated in your apache to work.

       --show-version
           This option will parse the file variables_common.inc of FusionDirectory to find out which version of
           FusionDirectory is installed.

       --list_vars
           This option will list the variables you can change to install FusionDirectory on another set of
           directories. This option is intended for people wanting to install from the sources.

       --write-vars
           This option will write back the variables.inc file with the updated variables and is only useful with
           --set-VAR=variable and for people installing from sources.

       --set-VAR=variable
           This option will change the variable for the FusionDirectory installation. it is only useful with
           --install-directories and for people installing from sources.

       --list-deprecated
           This option will list the deprecated attributes and objectclasses still in your schemas and no longer
           used by FusionDirectory.

       --check-deprecated
           This option will list the dn of LDAP entries using deprecated attributes or objectclasses and no
           longer used by FusionDirectory.

       --ldif-deprecated
           This option will print an LDIF to allow you to remove deprecated attributes from you ldap server. Be
           careful and check before applying.

       --show-config
           This option will print a dump of the FusionDirectory configuration LDAP node.

       --set-config-VAR=value
           This option sets the value of a configuration field in the LDAP. The value needs to be in the correct
           LDAP format.  You cannot set multivalued field with this. The var name can be provided with or
           without the fd prefix.

       --yes
           This flag will answer "yes" to every yes/no question asked by the script

EXAMPLE

        benoit@catbert$ fusiondirectory-setup --update-cache --update-locales

        Update FusionDirectory class cache and update localization

        benoit@catbert$ fusiondirectory-setup --list-vars
        List possible vars to give --set
       locale_cache_dir        [locale]
       config_file             [fusiondirectory.conf]
       fd_cache                [/var/cache/fusiondirectory]
       fd_smarty_dir           [/usr/share/php/smarty3]
       fd_spool_dir            [/var/spool/fusiondirectory]
       fai_log_dir             [fai]
       tmp_dir                 [tmp]
       secrets_file            [fusiondirectory.secrets]
       template_dir            [template]
       locale_dir              [locale]
       class_cache             [class.cache]
       fd_config_dir           [/etc/fusiondirectory]
       fd_home [/var/www/fusiondirectory]

        benoit@catbert$ fusiondirectory-setup --set-class_cache=class.cache --write-vars

        update the class.cache name and write back the variables.inc file

BUGS

       Please report any bugs, or post any suggestions, to the fusiondirectory mailing list fusiondirectory-
       users or to <https://forge.fusiondirectory.org/projects/fdirectory/issues/new>

AUTHORS

       Benjamin Carpentier

       Come Bernigaud

LICENCE AND COPYRIGHT

       This code is part of FusionDirectory (http://www.fusiondirectory.org/)

       Copyright (C) 2011-2016  FusionDirectory

       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.