* @copyright Copyright (c) 2018, Branko Kokanovic * * @author Branko Kokanovic * * @license GNU AGPL version 3 or any later version * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU Affero 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 Affero General Public License for more details. * * You should have received a copy of the GNU Affero General Public License * along with this program. If not, see . * */ namespace OCA\FaceRecognition\BackgroundJob\Tasks; use OCP\Util as OCP_Util; use OCA\FaceRecognition\BackgroundJob\FaceRecognitionBackgroundTask; use OCA\FaceRecognition\BackgroundJob\FaceRecognitionContext; use OCA\FaceRecognition\Helper\Imaginary; use OCA\FaceRecognition\Helper\MemoryLimits; use OCA\FaceRecognition\Helper\Requirements; use OCA\FaceRecognition\Model\IModel; use OCA\FaceRecognition\Model\ModelManager; use OCA\FaceRecognition\Model\Exceptions\UnavailableException; use OCA\FaceRecognition\Service\SettingsService; /** * Check all requirements before we start engaging in lengthy background task. */ class CheckRequirementsTask extends FaceRecognitionBackgroundTask { /** @var ModelManager Model Manader */ private $modelManager; /** @var SettingsService Settings service */ private $settingsService; /** @var Imaginary imaginary helper */ private $imaginaryHelper; /** * @param ModelManager $modelManager Model Manager * @param SettingsService $settingsService Settings service * @param Imaginary $imaginaryHelper imaginary helper */ public function __construct(ModelManager $modelManager, SettingsService $settingsService, Imaginary $imaginaryHelper) { parent::__construct(); $this->modelManager = $modelManager; $this->settingsService = $settingsService; $this->imaginaryHelper = $imaginaryHelper; } /** * @inheritdoc */ public function description() { return "Check all requirements"; } /** * @inheritdoc */ public function execute(FaceRecognitionContext $context) { $this->setContext($context); $system = php_uname("s"); $this->logDebug("System: " . $system); $systemMemory = MemoryLimits::getSystemMemory(); $this->logDebug("System memory: " . ($systemMemory > 0 ? $systemMemory : "Unknown")); $phpMemory = MemoryLimits::getPhpMemory(); $this->logDebug("PHP Memory Limit: " . ($phpMemory > 0 ? $phpMemory : "Unknown")); $this->logDebug("Clustering backend: " . (Requirements::pdlibLoaded() ? "pdlib" : "PHP (Not recommended.)")); if ($this->imaginaryHelper->isEnabled()) { $this->logDebug("Image Backend: Imaginary"); $version = $this->imaginaryHelper->getVersion(); if ($version) { $this->logDebug("Imaginary version: " . $version); } else { $imaginaryUrl = $this->imaginaryHelper->getUrl(); $error_message = "An Imaginary service (" . $imaginaryUrl . ") was configured to manage temporary images, but it is inaccessible." . "Check out the service, or set the 'preview_imaginary_url' key appropriately."; $this->logInfo($error_message); return false; } } else { $this->logDebug("Image Backend: Imagick"); } if (!Requirements::hasEnoughMemory()) { $error_message = "Your system does not meet the minimum of memory requirements.\n" . "Face recognition application requires at least " . OCP_Util::humanFileSize(SettingsService::MINIMUM_SYSTEM_MEMORY_REQUIREMENTS) . " of system memory.\n" . "See https://github.com/matiasdelellis/facerecognition/wiki/Performance-analysis-of-DLib%E2%80%99s-CNN-face-detection for more details\n\n" . "Fill an issue here if that doesn't help: https://github.com/matiasdelellis/facerecognition/issues"; $this->logInfo($error_message); return false; } $model = $this->modelManager->getCurrentModel(); if (is_null($model)) { $error_message = "Seems there are no installed models.\n" . "Please read the documentation about this: https://github.com/matiasdelellis/facerecognition/wiki/Models#install-models\n" . "and install them with the 'occ face:setup --model MODEL_ID' command.\n\n" . "Fill an issue here if that doesn't help: https://github.com/matiasdelellis/facerecognition/issues"; $this->logInfo($error_message); return false; } $model_message = ''; if (!$model->meetDependencies($model_message)) { $error_message = "Seems that don't meet the dependencies to use the model " . $model->getId() . ": " . $model->getName() . "\n". "Resume: " . $model_message . "\n" . "Please read the documentation for this model to continue: " . $model->getDocumentation() . "\n\n" . "Fill an issue here if that doesn't help: https://github.com/matiasdelellis/facerecognition/issues"; $this->logInfo($error_message); return false; } $imageArea = $this->settingsService->getAnalysisImageArea(); if ($imageArea < 0) { $error_message = "Seems that still don't configured the image area used for temporary files.\n" . "Please read the documentation about this: https://github.com/matiasdelellis/facerecognition/wiki/Settings#temporary-files\n" . "and then configure it in the admin panel to continue\n\n" . "Fill an issue here if that doesn't help: https://github.com/matiasdelellis/facerecognition/issues"; $this->logInfo($error_message); return false; } try { $model->open(); } catch (UnavailableException $e) { $this->logInfo("Error accessing the model to get required information: " . $e->getMessage()); return false; } $maxImageArea = $model->getMaximumArea(); if ($imageArea > $maxImageArea) { $error_message = "There are inconsistencies between the configured image area (" . $imageArea. " pixels^2) which is\n" . "greater that the maximum allowed by the model (". $maxImageArea . " pixels^2).\n" . "Please check and fix it in the admin panel to continue.\n\n" . "Fill an issue here if that doesn't help: https://github.com/matiasdelellis/facerecognition/issues"; $this->logInfo($error_message); return false; } return true; } }