Installation manuelle
Dernière mise à jour
Dernière mise à jour
La procédure suivante s'applique à l'installation à l'aide du pack d'installation manuelle de WorkflowGen.
Les prérequis et doivent être satisfaits avant de procéder à l'installation suivante.
Commencez par extraire le pack d’installation manuelle (.zip) dans un dossier temporaire du serveur Web de WorkflowGen (ex. : DISQUE:\temp).
Contenu du pack d’installation :
Databases contient les scripts d’installation de bases de données pour MS SQL Server
Inetpub contient les fichiers de l’application WorkflowGen
Program Files contient les fichiers des applications des services Windows de WorkflowGen
La structure recommandée du répertoire physique pour les fichiers et dossiers de l’application Web WorkflowGen devrait être sous DISQUE:\Inetpub\wwwroot\wfgen. Ce dossier contient les ressources statiques comme les images, les fichiers HTML, les données des processus et les applications utilisés par WorkflowGen.
Copiez le contenu du dossier source Inetpub dans votre dossier de destination DISQUE:\Inetpub\wwwroot\wfgen.
Copiez le contenu du dossier source Program Files\Advantys dans votre dossier de destination DISQUE:\Program Files (ex. : DISQUE:\Program Files\Advantys\WorkflowGen\Services\bin).
✏️ Note : Si vous avez déjà une autre version de WorkflowGen installée sur le même serveur et que vous voulez préserver vos services WorkflowGen antérieurs, nous vous suggérons de choisir un autre répertoire pour la version 9 (ex. : DISQUE:\Program Files\Advantys\WorkflowGen v9).
WorkflowGen ne supporte pas le classement sensible à la casse. Vous devez donc configurer la base de données pour qu'elle soit insensible à la casse afin d'éviter les erreurs.
create.sqlOuvrez l'outil SQL Server Management Studio et connectez-vous à votre serveur de base de données avec un compte administrateur (ex. : SA).
Créez une nouvelle base de données (ex. : WFGEN).
Créez un nouveau compte utilisateur SQL Server (ex. : WFGEN_USER).
Accordez à cet utilisateur les autorisations db_datawriter et db_datareader pour la base de données WFGEN.
Ouvrez le dossier source DISQUE:\temp\manual\Databases\MsSQLServer et exécutez le script create.sql sur la nouvelle instance de base de données.
Ouvrez l'outil MS SQL Server Management Studio et connectez-vous à votre instance MS SQL Server avec un compte administrateur (ex. : SA).
Créez une nouvelle base de données (ex. : WFGEN).
Créez un nouveau compte utilisateur SQL Server (ex. : WFGEN_USER).
Accordez à cet utilisateur les autorisations db_datawriter et db_datareader pour la base de données WFGEN.
Ouvrez le dossier source DISQUE:\temp\pack\Databases\MsSQLServer et exécutez le script de création de base de données create.sql sur la nouvelle instance de la base de données.
WorkflowGen nécessite un compte Windows NT ou Active Directory valide. Ce compte sera utilisé pour administrer WorkflowGen mais ne nécessite pas de droit d’administration NT ou Active Directory.
Ouvrez et éditez le fichier de configuration de WorkflowGen DRIVE:\Inetpub\wwwroot\wfgen\web.config.
Mettez à jour la chaîne de connexion à la base de données.
MS SQL Server :<add name="MainDbSource" connectionString="Data Source=localhost;Initial Catalog=WFGEN;User ID=WFGEN_USER;Password=Admin123!;" providerName="System.Data.SqlClient" />
Mettez à jour le nom d’utilisateur du compte WorkflowGen Administrator pour autoriser l’accès au panneau de configuration (ex. : <add key="ApplicationConfigAllowedUsersLogin" value="wfgen_admin" />).
Mettez à jour l'URL de l'application (ex. : <add key="ApplicationUrl" value="http://votresite/wfgen" />).
Ajoutez une clé de cryptage alphanumérique à 32 caractères (ex. : <add key="ApplicationSecurityPasswordSymmetricEncryptionKey" value="XXXXXXXXXXXXXXXXXXX....." />).
L’utilisateur ou l’identité utilisé pour exécuter les services Windows de WorkflowGen doit être un administrateur, faire partie du groupe d’administrateurs, ou être un compte système de Windows (par exemple, Local System). Pour vérifier cela, exécutez services.msc.
Si vous avez spécifié un chemin d’installation personnalisé, vous devez changer le chemin dans le script DISQUE:\Program Files\Advantys[CustomWorkflowGen]\Services\bin\winsvc-install.cmd (ex. : %windir%\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe /i "C:\Program Files\Advantys\Custom WorkflowGen]^\Services\bin\WfgDirectoriesSyncService.exe").
Éditez le fichier de configuration du service moteur DISQUE:\Program Files\Advantys\WorkflowGen\Services\bin\WfgWorkflowEngineService.exe.config.
Indiquez le chemin du fichier de configuration de WorkflowGen (ex. : <add key="WebConfigPath" value="DISQUE:\inetpub\wwwroot\wfgen\web.config"/>).
Éditez le fichier de configuration du service de synchronisation d’annuaire DISQUE:\Program Files\Advantys\WorkflowGen\Services\bin\WfgDirectoriesSyncService.exe.config.
Indiquez le chemin du fichier de configuration de WorkflowGen (ex : <add key="WebConfigPath" value="DISQUE:\inetpub\wwwroot\wfgen\web.config"/>).
✏️ Note : Il se peut que WfgWorkflowEngineService.exe et WfgDirectoriesSyncService.exe soient bloqués. Pour vérifier, faites un clic droit sur eux et choisissez Propriétés. Si la section Sécurité est affichée en bas dans l’onglet Général, ces exécutables sont bloqués; dans ce cas, cliquez sur Débloquer.
Exécutez le fichier DISQUE:\Program Files\Advantys\WorkflowGen\Services\bin\winsvc-install.cmd.
On recommande d’isoler WorkflowGen d’autres applications en créant son propre groupe d’applications et en associant toutes les applications déclarées avec le nouveau groupe d’applications.
Dans IIS Manager, cliquez sur Application pools. Dans le volet de droite, faites un clic droit sur Add application pool, sélectionnez-le et donnez-lui un nom (ex. : WorkflowGen).
Sélectionnez la version .NET Framework 4.
Sélectionnez Integrated pipeline mode.
Cliquez sur OK.
Lancez IIS Manager et déployez l'arborescence sous le nom du serveur IIS sur lequel sera créé le nouveau site.
Faites un clic droit sur l'icône Sites et sélectionnez Add Web Site. Inscrivez le nom du site, sélectionnez son groupe d'applications (s'il ne s'agit pas du groupe par défaut), et inscrivez le chemin du répertoire racine (cliquez sur Browse et sélectionnez le dossier \wwwroot, habituellement DISQUE:\Inetpub\wwwroot\wfgen).
Sélectionnez le lien comme http ou https (https nécessite un certificat SSL). Sélectionnez un port (80 par défaut) et (ou) un port hôte. Veuillez contacter l'administrateur IIS pour revoir vos options pour la configuration appropriée du site Web.
Le type de document par défaut default.aspx doit être créé s'il n'existe pas. Par défaut, ce document devrait exister sur un serveur IIS exécutant .NET.
Pour vérifier ceci, cliquez sur l'icône du site, et assurez-vous que le volet de droite affiche Features view (un onglet au bas du volet vous permet de basculer entre Features et Content). Double-cliquez sur l'icône Default document. Si default.aspx est absent de la liste, ajoutez-le au début de la liste à séparations par virgules affichées. Pour améliorer les performances, vous pouvez déplacer default.aspx vers le haut de la liste, s'il n'y est pas déjà.
Cliquez sur l'icône du site, et assurez-vous que le volet de droite affiche Features view.
Double-cliquez sur l'icône Authentication.
Faites un clic droit sur Anonymous authentication et sélectionnez Disable.
Dans IIS Manager, ouvrez le répertoire \wwwroot, faites un clic droit sur wfgen et sélectionnez Convert to application.
Sélectionnez le groupe d'applications WorkflowGen s'il n'est pas la valeur par défaut, puis cliquez sur OK.
Les applications \wfgen\ws et \wfgen\WfApps\WebForms doivent être créées. Répétez les étapes que vous avez suivi pour \wfgen dans la section précédente.
Si vous utilisez IIS 8 ou supérieur et si votre groupe d’applications est configuré en mode Classic Managed Pipeline, assurez-vous que ASP.NET v4.0.30319 est réglé sur Allowed dans la liste ISAPI and CGI Restrictions dans IIS.
Les droits des fichiers peuvent être configurés de la manière suivante pour les utilisateurs de WorkflowGen :
Répertoire DRIVE:\Inetpub\wwwroot\wfgen : permission de modification pour tous les utilisateurs
Les utilisateurs Windows correspondants
L'identité de l'application groupe ASP.NET ou IIS
wfgenSi vous souhaitez que votre site Web racine WorkflowGen (p.ex, https://serveur) se redirige automatiquement vers l'application Web https://serveur/wfgen, suivez la procédure ci-dessous.
Créez ou mettez à jour le fichier web.config dans le dossier racine de votre site Web (p.ex. DISQUE:\inetpub\wwwroot\web.config).
⚠️ Attention : Il ne s'agit pas du même fichier web.config que le fichier web.config principal de WorkflowGen (situé dans DISQUE:\inetpub\wwroot\wfgen\web.config).
Définissez le nœud de la règle de réécriture comme indiqué ci-dessous (configuration / system.webServer / <rewrite> / <rules> / <rule>) :
Pour utiliser les API GraphQL, Webhooks entrants, OpenID Connect Auth et SCIM facultatives, vous devez d'abord installer les prérequis suivants :
Dans IIS, convertissez /wfgen/graphql en application avec un pool d’applications en .NET 4 (mode pipeline intégré).
Configurez le mode d’authentification de l’application GraphQL :
Pour l’authentification Windows ou de base : Activez l’authentification de base.
Pour l’authentification applicative WorkflowGen :
Assurez-vous que l’authentification applicative WorkflowGen est déjà appliquée à l’application Web /wfgen
Appliquez l’authentification anonyme.
Dans IIS, convertissez /wfgen/hooks en application avec un pool d’applications en .NET 4 (mode pipeline intégré), et ensuite configurez l’application webhook en mode d’authentification anonyme.
Dans IIS, convertissez /wfgen/auth en application avec un pool d’applications en .NET 4 (mode pipeline intégré), et ensuite configurez l’application webhook en mode d’authentification Anonyme.
Dans IIS, convertissez /wfgen/scim en application avec un pool d’applications en .NET 4 (mode pipeline intégré), et ensuite configurez l’application webhook en mode d’authentification Anonyme.
La base de données SQL Azure doit être créée et configurée manuellement. Voir la section dans le guide pour obtenir des instructions sur la façon de procéder.
Base de données Azure SQL : Voir la section dans le guide .
Pour plus d'informations sur les autres paramètres de configuration, voir l'annexe .
Si vous installez ces services avec des services WorkflowGen antérieurs sur le même serveur, vous devez spécifier un nouveau nom pour le service (ex. : WorkflowGenEngineServiceV7) pour les services Engine et Directory dans leurs fichiers de configuration ([WfgWorkflowEngineService.exe].config : <add key="ServiceName" value="WorkflowGenEnginerServiceV7"></add>) et fichiers script (winsvc-install.cmd : renommez toutes les instances de [WorkflowGenEngineService] à [WorkflowGenEngineServiceV7]). (Voir la section pour plus de renseignements et des instructions pour configurer plusieurs instances de WorkflowGen sur le même serveur.)
Faites un clic droit sur Basic authentication et sélectionnez Enable. Vous pourrez changer la méthode d'authentification en suivant les instructions de la section .
Selon votre méthode d'authentification (voir la section ), l'identité de l'application WorkflowGen peut être :
Assurez-vous que l'outil est déjà installé sur votre serveur WorkflowGen.
✏️ Note : Cette bibliothèque est requise si vous rencontrez l'erreur Le module spécifié est introuvable (The specified module could not be found) concernant les bibliothèques edge et edge-js lors de l'accès aux applications Web /wfgen/graphql/, /wfgen/hooks ou /wfgen/scim.