ILIAS\Setup\CLI\InstallCommand Class Reference

Installation command. More...

Inheritance diagram for ILIAS\Setup\CLI\InstallCommand:

Collaboration diagram for ILIAS\Setup\CLI\InstallCommand:

Public Member Functions
	__construct (AgentFinder $agent_finder, ConfigReader $config_reader, array $preconditions)

Data Fields
const	IMPORT = "import"

Protected Member Functions
	configure ()
	execute (InputInterface $input, OutputInterface $output)
	prepareILIASInstallation (InputInterface $input, OutputInterface $output)
	preparePluginInstallation (InputInterface $input, OutputInterface $output)
	createTempDir ()

Protected Attributes
const	TMP_DIR = "tmp_dir"
array	$preconditions = []
	var Objective[] More...

Static Protected Attributes
static	$defaultName = "install"

Detailed Description

Installation command.

Definition at line 40 of file InstallCommand.php.

Constructor & Destructor Documentation

__construct()

ILIAS\Setup\CLI\InstallCommand::__construct	(	AgentFinder	$agent_finder,
		ConfigReader	$config_reader,
		array	$preconditions
	)

Definition at line 59 of file InstallCommand.php.

References ILIAS\Setup\CLI\InstallCommand\$preconditions, and ILIAS\GlobalScreen\Provider\__construct().

    {
        parent::__construct();
        $this->agent_finder = $agent_finder;
        $this->config_reader = $config_reader;
        $this->preconditions = $preconditions;
    }

Here is the call graph for this function:

Member Function Documentation

configure()

ILIAS\Setup\CLI\InstallCommand::configure ( )

protected

Definition at line 67 of file InstallCommand.php.

References ILIAS\Setup\CLI\configureCommandForPlugins(), and null.

                                  : void
    {
        $this->setDescription("Creates a fresh ILIAS installation based on the config");
        $this->addArgument("config", InputArgument::OPTIONAL, "Configuration file for the installation");
        $this->addOption("config", null, InputOption::VALUE_OPTIONAL | InputOption::VALUE_IS_ARRAY, "Define fields in the configuration file that should be overwritten, e.g. \"a.b.c=foo\"", []);
        $this->addOption("yes", "y", InputOption::VALUE_NONE, "Confirm every message of the installation.");
        $this->addOption("import-file", "i", InputOption::VALUE_REQUIRED, "Path to zip file to import from.");
        $this->configureCommandForPlugins();
    }

Here is the call graph for this function:

createTempDir()

ILIAS\Setup\CLI\InstallCommand::createTempDir ( )

protected

Definition at line 206 of file InstallCommand.php.

References $path, and null.

Referenced by ILIAS\Setup\CLI\InstallCommand\prepareILIASInstallation().

                                      : ?string
    {
        $path = rtrim(sys_get_temp_dir(), DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR . mt_rand() . microtime(true);
        if (mkdir($path)) {
            return $path;
        }
        return null;
    }

Here is the caller graph for this function:

execute()

ILIAS\Setup\CLI\InstallCommand::execute ( InputInterface  $input, OutputInterface  $output  )

protected

Definition at line 77 of file InstallCommand.php.

References Vendor\Package\$e, ILIAS\Setup\NoConfirmationException\getRequestedConfirmation(), ILIAS\Setup\CLI\InstallCommand\prepareILIASInstallation(), and ILIAS\Setup\CLI\InstallCommand\preparePluginInstallation().

                                                                              : int
    {
        // ATTENTION: This is a hack to get around the usage of the echo/exit pattern in
        // the setup for the command line version of the setup. Do not use this.
        if (!defined("ILIAS_SETUP_IGNORE_DB_UPDATE_STEP_MESSAGES")) {
            define("ILIAS_SETUP_IGNORE_DB_UPDATE_STEP_MESSAGES", true);
        }

        if ($input->hasOption('legacy-plugin') && $input->getOption('legacy-plugin') != "") {
            list($objective, $environment, $io) = $this->preparePluginInstallation($input, $output);
        } else {
            list($objective, $environment, $io) = $this->prepareILIASInstallation($input, $output);
        }
        try {
            $this->achieveObjective($objective, $environment, $io);
            if ($input->hasOption("import-file") && $input->getOption("import-file") != "") {
                $io->inform("Please ensure that all ILIAS directories (webdir/datadir/Customizing) have the right owner after import process.");
            }
            $io->success("Installation complete. Thanks and have fun!");
        } catch (NoConfirmationException $e) {
            $io->error("Aborting Installation, a necessary confirmation is missing:\n\n" . $e->getRequestedConfirmation());
        }

        return 0;
    }

Here is the call graph for this function:

prepareILIASInstallation()

ILIAS\Setup\CLI\InstallCommand::prepareILIASInstallation ( InputInterface  $input, OutputInterface  $output  )

protected

Definition at line 103 of file InstallCommand.php.

References ILIAS\Setup\CLI\addAgentConfigsToEnvironment(), ILIAS\Setup\CLI\InstallCommand\createTempDir(), MysqlIfsnopDumper\FILE_NAME, ILIAS\Setup\CLI\getRelevantAgent(), ILIAS\Setup\CLI\readAgentConfig(), ILIAS\Setup\Environment\RESOURCE_ADMIN_INTERACTION, and ILIAS\Setup\Environment\RESOURCE_CLIENT_ID.

Referenced by ILIAS\Setup\CLI\InstallCommand\execute().

                                                                                               : array
    {
        $io = new IOWrapper($input, $output);
        $io->printLicenseMessage();
        $io->title("Install ILIAS");

        $environment = new ArrayEnvironment([
            Environment::RESOURCE_ADMIN_INTERACTION => $io
        ]);

        if ($input->hasOption("import-file") && $input->getOption("import-file") != "") {
            if ($input->getArgument("config") == "") {
                throw new \InvalidArgumentException("Missing configuration file.");
            }
            $import_file = $input->getOption("import-file");
            if (!is_file($import_file)) {
                throw new \InvalidArgumentException("Can't find import file '$import_file'.");
            }

            if (pathinfo($import_file)["extension"] != "zip") {
                throw new \InvalidArgumentException("Wrong file format for import file. 'zip' is expected.");
            }

            $tmp_dir = $this->createTempDir();
            if (is_null($tmp_dir)) {
                throw new \RuntimeException("Can't create temporary directory!");
            }
            $environment = $environment
                ->withConfigFor(self::IMPORT, $input->getOption("import-file"))
                ->withConfigFor(self::TMP_DIR, $tmp_dir)
            ;
            $dump_path = $tmp_dir . DIRECTORY_SEPARATOR . MysqlIfsnopDumper::FILE_NAME;
            $input->setOption(
                "config",
                array_merge($input->getOption("config"), ["database.path_to_db_dump=$dump_path"])
            );
        }

        $agent = $this->getRelevantAgent($input);

        $config = $this->readAgentConfig($agent, $input);

        $objective = new ObjectiveCollection(
            "Install and Update ILIAS",
            false,
            $agent->getInstallObjective($config),
            $agent->getUpdateObjective($config)
        );
        if ($this->preconditions !== []) {
            $objective = new ObjectiveWithPreconditions(
                $objective,
                ...$this->preconditions
            );
        }

        $environment = $this->addAgentConfigsToEnvironment($agent, $config, $environment);
        // ATTENTION: This is bad because we strongly couple this generic command
        // to something very specific here. This can go away once we have got rid of
        // everything related to clients, since we do not need that client-id then.
        // This will require some more work, though.
        $common_config = $config->getConfig("common");
        $environment = $environment->withResource(
            Environment::RESOURCE_CLIENT_ID,
            $common_config->getClientId()
        );

        return [$objective, $environment, $io];
    }

Here is the call graph for this function:

Here is the caller graph for this function:

preparePluginInstallation()

ILIAS\Setup\CLI\InstallCommand::preparePluginInstallation ( InputInterface  $input, OutputInterface  $output  )

protected

Definition at line 172 of file InstallCommand.php.

References ILIAS\Setup\CLI\addAgentConfigsToEnvironment(), ILIAS\Setup\CLI\getRelevantAgent(), ILIAS\Setup\CLI\readAgentConfig(), and ILIAS\Setup\Environment\RESOURCE_ADMIN_INTERACTION.

Referenced by ILIAS\Setup\CLI\InstallCommand\execute().

                                                                                                : array
    {
        $io = new IOWrapper($input, $output);
        $io->printLicenseMessage();
        $io->title("Install ILIAS Plugin");

        $agent = $this->getRelevantAgent($input);

        $config = $this->readAgentConfig($agent, $input, $input->getOption("legacy-plugin"));

        $objective = new ObjectiveCollection(
            "Install and Update ILIAS Plugin",
            false,
            $agent->getInstallObjective($config),
            $agent->getUpdateObjective($config)
        );
        if ($this->preconditions !== []) {
            $objective = new ObjectiveWithPreconditions(
                $objective,
                ...$this->preconditions
            );
        }

        $environment = new ArrayEnvironment([
            Environment::RESOURCE_ADMIN_INTERACTION => $io
        ]);

        if (!is_null($config)) {
            $environment = $this->addAgentConfigsToEnvironment($agent, $config, $environment);
        }

        return [$objective, $environment, $io];
    }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$defaultName

ILIAS\Setup\CLI\InstallCommand::$defaultName = "install"

staticprotected

Definition at line 49 of file InstallCommand.php.

$preconditions

array ILIAS\Setup\CLI\InstallCommand::$preconditions = []

protected

var Objective[]

Definition at line 54 of file InstallCommand.php.

Referenced by ILIAS\Setup\CLI\InstallCommand\__construct().

IMPORT

const ILIAS\Setup\CLI\InstallCommand::IMPORT = "import"

Definition at line 46 of file InstallCommand.php.

TMP_DIR

const ILIAS\Setup\CLI\InstallCommand::TMP_DIR = "tmp_dir"

protected

Definition at line 47 of file InstallCommand.php.

---

The documentation for this class was generated from the following file:

• components/ILIAS/Setup/src/CLI/InstallCommand.php