Installation manuelle

Aperçu

La procédure suivante s'applique à l'installation à l'aide du pack d'installation manuelle de WorkflowGen.

Les prérequis du serveur Web et du serveur de base de données doivent être satisfaits avant de procéder à l'installation suivante.

Pack d’installation

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

Architecture des fichiers et dossiers 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.

  1. Copiez le contenu du dossier source Inetpub dans votre dossier de destination DISQUE:\Inetpub\wwwroot\wfgen.

  2. 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).

Création de la base de données

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.

Création de la base de données MS SQL Server

Option 1 : Créez la base de données manuellement avec le script SQL create.sql

  1. Ouvrez l'outil SQL Server Management Studio et connectez-vous à votre serveur de base de données avec un compte administrateur (ex. : SA).

  2. Créez une nouvelle base de données (ex. : WFGEN).

  3. Créez un nouveau compte utilisateur SQL Server (ex. : WFGEN_USER).

  4. Accordez à cet utilisateur les autorisations db_datawriter et db_datareader pour la base de données WFGEN.

  5. 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.

Option 2 : Créez la base de données manuellement avec des scripts SQL

  1. Ouvrez l'outil MS SQL Server Management Studio et connectez-vous à votre instance MS SQL Server avec un compte administrateur (ex. : SA).

  2. Créez une nouvelle base de données (ex. : WFGEN).

  3. Créez un nouveau compte utilisateur SQL Server (ex. : WFGEN_USER).

  4. Accordez à cet utilisateur les autorisations db_datawriter et db_datareader pour la base de données WFGEN.

  5. 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.

Configuration de la base de données SQL Azure

La base de données SQL Azure doit être créée et configurée manuellement. Voir la section Configuration de la base de données SQL Azure dans le guide WorkflowGen pour Azure pour obtenir des instructions sur la façon de procéder.

Configuration de la base de données PostgreSQL

À partir de la version 10.0.2, WorkflowGen supporte PostgreSQL 17.5 en tant que moteur de base de données. Pour créer une nouvelle base de données WorkflowGen sur votre serveur PostgreSQL, suivez d’abord les instructions de la documentation PostgreSQL (disponible en anglais uniquement), puis suivez les instructions ci-dessous en fonction du système d’exploitation sur lequel vous hébergez la base de données.

Le package d’installation manuelle est spécifique à PostgreSQL sous Windows. Si vous hébergez PostgreSQL sur une autre plateforme, installez la version appropriée de l’extension pgvector (requise par les fonctionnalités de recherche sémantique et d’IA de WorkflowGen 10 pour la prise en charge du type de données vector) adaptée à votre environnement. Elle doit être installée et activée avant la création de la base de données WorkflowGen. Consultez les instructions pour les environnements autres que Windows ci-dessous.

Environnements Windows

Si vous utilisez PostgreSQL sous Windows, téléchargez l’extension pgvector v0.8.0 depuis pgvector_pgsql_windows 0.8.0_17.3, puis installez-la et activez-la.

Environnements autres que Windows

Si vous utilisez PostgreSQL sous Linux, macOS ou dans un conteneur Docker, installez l’extension pgvector à l’aide du gestionnaire de paquets de votre environnement ou à partir du dépôt officiel sur GitHub. Pour ce faire, suivez les instructions ci-dessous en fonction de votre environnement :

sudo apt install postgresql-server-dev-all
git clone https://github.com/pgvector/pgvector.git
cd pgvector
make && sudo make install

Une fois installée, activez l’extension dans votre base de données WorkflowGen :

CREATE EXTENSION IF NOT EXISTS vector;

Configurez la base de données WorkflowGen

  1. Initialisez le schéma WorkflowGen en exécutant les scripts suivants dans l’ordre :

    1. Databases\PostgreSQL\Create_WFG_SQL_Tables.sql

    2. Databases\PostgreSQL\Create_WFG_SQL_PKeys.sql

    3. Databases\PostgreSQL\Create_WFG_SQL_FKeys.sql

    4. Databases\PostgreSQL\Create_WFG_SQL_Indexes.sql

    5. Databases\PostgreSQL\Create_WFG_SQL_Triggers.sql

    6. Databases\PostgreSQL\Create_WFG_SQL_Const.sql

  2. Créez un nouvel utilisateur PostgreSQL (p.ex. : wfgen_user) et accordez-lui les droits de lecture et d’écriture sur la base de données WorkflowGen.

  3. Configurez WorkflowGen pour qu’il se connecte à PostgreSQL en mettant à jour la chaîne de connexion dans le fichier \wfgen\web.config. 📌 Exemple :

    <connectionStrings>
    <add name="MainDbSource" connectionString="Host=localhost;Username=wfgen_user;Password=[wfgen_user_password];Database=[workflowgen_db_name];" providerName="Npgsql" />
</connectionStrings>

Notes supplémentaires

  • Portée de l’aperçu : Le support de PostgreSQL est actuellement en aperçu (preview) et peut faire l’objet de modifications. Il est recommandé de l’utiliser uniquement à des fins de test et d’évaluation.

  • Compatibilité .NET : WorkflowGen utilise le fournisseur de données Npgsql pour se connecter à PostgreSQL. Assurez-vous que votre runtime .NET et vos bibliothèques sont compatibles avec Npgsql.

  • Sensibilité à la casse : PostgreSQL traite par défaut les identifiants non entre guillemets comme des minuscules. Soyez cohérent dans l’utilisation de la casse et utilisez des guillemets doubles si vous personnalisez le schéma ou exécutez des requêtes manuelles.

  • Parité fonctionnelle : Certaines fonctionnalités de WorkflowGen peuvent se comporter différemment sous PostgreSQL en raison de différences de syntaxe SQL, de fonctions disponibles ou de caractéristiques de performance. La parité complète avec MS SQL Server est en cours d’évaluation pendant cette phase d’aperçu.

  • Recommandation de test : Pour les besoins d’évaluation, installez WorkflowGen avec PostgreSQL dans un environnement de test distinct afin d’éviter tout impact sur les systèmes de production.

Création du compte administrateur de WorkflowGen

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.

  • Vous pouvez utiliser un compte existant ou en créer un nouveau (ex. : Domain\wfgen_admin).

  • Si vous utilisez un compte différent que wfgen_admin, vous devrez modifier sa valeur dans la base de données pour l’utilisateur WorkflowGen Administrator. Ouvrez le contenu de la table Users, retrouvez l’enregistrement avec la valeur wfgen_admin pour la colonne USERNAME, puis changez sa valeur avec le nom d’utilisateur que vous aurez choisi.

Configuration Web de WorkflowGen

  1. Ouvrez et éditez le fichier de configuration de WorkflowGen DRIVE:\Inetpub\wwwroot\wfgen\web.config.

  2. Mettez à jour la chaîne de connexion à la base de données.

  3. 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" />).

  4. Mettez à jour l'URL de l'application (ex. : <add key="ApplicationUrl" value="http://votresite/wfgen" />).

  5. Ajoutez une clé de cryptage alphanumérique à 32 caractères (ex. : <add key="ApplicationSecurityPasswordSymmetricEncryptionKey" value="XXXXXXXXXXXXXXXXXXX....." />).

Pour plus d'informations sur les autres paramètres de configuration, voir l'annexe Paramètres de configuration Web et d'application.

Installation des services Windows de WorkflowGen

Notes

  • 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").

  • 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 Configuration de plusieurs instances de WorkflowGen pour plus de renseignements et des instructions pour configurer plusieurs instances de WorkflowGen sur le même serveur.)

Installation

  1. Éditez le fichier de configuration du service moteur DISQUE:\Program Files\Advantys\WorkflowGen\Services\bin\WfgWorkflowEngineService.exe.config.

  2. Indiquez le chemin du fichier de configuration de WorkflowGen (ex. : <add key="WebConfigPath" value="DISQUE:\inetpub\wwwroot\wfgen\web.config"/>).

  3. Éditez le fichier de configuration du service de synchronisation d’annuaire DISQUE:\Program Files\Advantys\WorkflowGen\Services\bin\WfgDirectoriesSyncService.exe.config.

  4. 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.

  5. Exécutez le fichier DISQUE:\Program Files\Advantys\WorkflowGen\Services\bin\winsvc-install.cmd.

Configuration de IIS

Création du groupe d'applications

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.

Les utilisateurs du domaine et les comptes Windows utilisés pour exécuter le pool d'applications IIS WorkflowGen et le service de moteur doivent disposer des permissions de lecture et d'écriture pour le dossier \wfgen\app_data.

  1. 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).

  2. Sélectionnez la version .NET Framework 4.

  3. Sélectionnez Integrated pipeline mode.

  4. Cliquez sur OK.

Création du site Web (si WorkflowGen est configuré sur un nouveau site Web)

  1. Lancez IIS Manager et déployez l'arborescence sous le nom du serveur IIS sur lequel sera créé le nouveau site.

  2. 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).

  3. 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.

Configuration du site Web

Document par défaut

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à.

Authentification

  1. Cliquez sur l'icône du site, et assurez-vous que le volet de droite affiche Features view.

  2. Double-cliquez sur l'icône Authentication.

  3. Faites un clic droit sur Anonymous authentication et sélectionnez Disable.

  4. 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 Sécurité.

Création de l'application WorkflowGen

  1. Dans IIS Manager, ouvrez le répertoire \wwwroot, faites un clic droit sur wfgen et sélectionnez Convert to application.

  2. Sélectionnez le groupe d'applications WorkflowGen s'il n'est pas la valeur par défaut, puis cliquez sur OK.

Création d'applications et de services de workflow

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.

Restrictions ISAPI et CGI

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.

Configuration des droits d’accès aux fichiers

Droits des fichiers

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

Selon votre méthode d'authentification (voir la section Sécurité), l'identité de l'application WorkflowGen peut être :

  • Les utilisateurs Windows correspondants

  • L'identité de l'application groupe ASP.NET ou IIS

Applications Web basées sur Node.js

Pour utiliser les API GraphQL, Webhooks entrants, OpenID Connect Auth et SCIM facultatives, vous devez d'abord installer les prérequis suivants :

  • Node.js v18.20.7 LTS

  • iisnode

  • IIS URL Rewrite

  • Visual C ++ Redistributable ✏️ 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.

Après l’activation des applications Web basées sur Node.js, les DLL de WorkflowGen seront utilisés par Node.js et ils seront donc verrouillés et ne pourront pas être modifiés. Si vous voulez les modifier, il sera nécessaire d’arrêter IIS.

Activation de GraphQL

  1. Dans IIS, convertissez /wfgen/graphql en application avec un pool d’applications en .NET 4 (mode pipeline intégré).

  2. 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.

Activation des webhooks entrants

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.

Si votre WorkflowGen est configuré avec l’authentification applicative WorkflowGen ou une authentification personnalisée, vous devez supprimer le module d’authentification du fichier /hooks/web.config en définissant un nœud <location> dans le nœud <configuration>, comme suit :

Pour l'authentification applicative WorkflowGen :

<location path="hooks" inheritInChildApplications="false">
    <system.webServer>
        <modules>
            <remove name="ApplicationSecurityAuthenticationModule" />
        </modules>
    </system.webServer>
</location>

Pour l'authentification personnalisée : 

<location path="hooks" inheritInChildApplications="false">
    <system.webServer>
        <modules>
            <remove name="MyCustomAuthModule" />
        </modules>
    </system.webServer>
</location>

Activation d'OpenID Connect Auth

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.

Si votre WorkflowGen est configuré avec l’authentification applicative WorkflowGen ou une authentification personnalisée, vous devez supprimer le module d’authentification du fichier /auth/web.config en définissant un nœud <location> dans le nœud <configuration>, comme suit :

Pour l'authentification applicative WorkflowGen :

<location path="auth" inheritInChildApplications="false">
    <system.webServer>
        <modules>
            <remove name="ApplicationSecurityAuthenticationModule" />
        </modules>
    </system.webServer>
</location>

Pour l'authentification personnalisée :

<location path="auth" inheritInChildApplications="false">
    <system.webServer>
        <modules>
            <remove name="MyCustomAuthModule" />
        </modules>
    </system.webServer>
</location>

Activation de SCIM

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.

Si votre WorkflowGen est configuré avec l’authentification applicative WorkflowGen ou une authentification personnalisée, vous devez supprimer le module d’authentification du fichier /scim/web.config en définissant un nœud <location> dans le nœud <configuration>, comme suit :

Pour l'authentification applicative WorkflowGen :

<location path="scim" inheritInChildApplications="false">
    <system.webServer>
        <modules>
            <remove name="ApplicationSecurityAuthenticationModule" />
        </modules>
    </system.webServer>
</location>

Pour l'authentification personnalisée :

<location path="scim" inheritInChildApplications="false">
    <system.webServer>
        <modules>
            <remove name="MyCustomAuthModule" />
        </modules>
    </system.webServer>
</location>
PrécédentInstallation PowerShellSuivantServices Windows WorkflowGen et activation de la licence

Mis à jour