Configuration

Préparation

Généralités

Vous devez être administrateur du serveur Web. Nous recommandons d'utiliser un compte administrateur local. Vous devez connaître :

  • Le chemin (destination) sur le serveur Web où sera installée l'application Web WorkflowGen

  • Le chemin (destination) sur le serveur Web où seront installés les services Windows de WorkflowGen

  • L'URL du serveur Web où sera installé WorkflowGen

  • Base de données du serveur MS SQL :

    • le nom du serveur MS SQL

    • les justificatifs d'identité du compte AS

    • le chemin vers les fichiers de données du serveur SQL sur l'ordinateur où réside le serveur SQL

  • Base de données Oracle :

    • un nom de source de données Oracle existante

    • les justificatifs d'identité du compte utilisateur de la base de données qui possède une permission de création sur l'instance Oracle spécifiée (référez-vous à la section suivante pour les paramètres d'installation de la base de données Oracle)

    • le nom ou l'adresse IP de la passerelle SMTP (nous recommandons d'utiliser la passerelle SMTP IIS; voir la section Utilisation de la passerelle SMTP IIS)

    • l'adresse email de l'expéditeur par défaut pour les notifications

    • la méthode d'authentification que vous désirez utiliser pour l'application Web de WorkflowGen

Installation sur la base de données

WorkflowGen et Oracle 10g sur le même serveur

  • National et Database Character Sets sont à UTF-8

  • Oracle Database 10g Release 2 (10.2.0.3/10.2.0.4) Standard

WorkflowGen et Oracle 10g sur des serveurs différents

  • National et Database Character Sets sont à UTF-8

  • Serveur Oracle : Oracle Database 10g Release 2 (10.2.0.3/10.2.0.4) Standard

  • Serveur WorkflowGen : Oracle Database 10g Client Release 2 (10.2.0.3)

WorkflowGen et Oracle 11g sur le même serveur

  • National et Database Character Sets sont à UTF-8

  • Oracle Database 11g Release 1 (11.1.0.6.0) Enterprise et l’application Client installée

WorkflowGen et Oracle 11g sur des serveurs différents

  • National et Database Character Sets sont à UTF-8

  • Serveur Oracle : Oracle Database 11g Release 1 (11.1.0.6.0) Enterprise

  • Serveur WorkflowGen : Oracle Database 11g Release 1 Client (11.1.0.6.0)

WorkflowGen et Oracle 12c sur le même serveur

  • National et Database Character Sets sont à UTF-8

  • Oracle Database 12c Release 1 (12.1.0.2.0) Standard

WorkflowGen et Oracle 12c sur des serveurs différents

  • National et Database Character Sets sont à UTF-8

  • Serveur Oracle : 12c Release 1 (12.1.0.2.0) Standard

  • Serveur WorkflowGen : Oracle Database 12c Release 1 (12.1.0.2.0) Client pour Microsoft Windows

Méthode d'authentification

Vérifiez que le paramètre SQLNET.AUTHENTICATION_SERVICES du fichier « DISQUE:\OraHome\network\ADMIN\SQLNET.ORA » est défini comme « NONE ». Ce fichier se trouve sur votre serveur Web.

Créer un nouvel ensemble de tables (si WorkflowGen est configuré sur un ensemble de tables vide)

  1. Dans DBA studio ou à partir de SQL Plus, créez un nouvel ensemble de tables appelé WFGEN avec une taille de fichier de 100 Mo minimum.

  2. Lorsque l'ensemble de tables est créé, vous devrez définir le paramètre Database and National Character Set à UTF-8.

  3. Créez un compte utilisateur avec les paramètres suivants :

    • ensemble de tables temporaire et par défaut : WFGEN.

    • rôle : DBA ou un accès plus restrictif. Initialement, l'utilisateur doit avoir des droits de création sur le schéma de structure (tables, index, contraintes, etc.). Mais, une fois la structure créée, seuls les droits de lecture/écriture sont nécessaires.

Configurations recommandées pour l’amélioration des performances sur Oracle

Mode « Optimizer »

Pour améliorer la performance de la base de données WorkflowGen, vérifiez le mode « Optimizer ». Si « optimizer_mode » est réglé sur choose (le mode par défaut sur Oracle 9i et 10g), vous devez analyser fréquemment toutes les tables de vos bases de données. Cette opération générera des statistiques qui seront utilisées par le « Optimizer » afin de choisir le meilleur mode (RULE au lieu de all_rows) pour exécuter une requête SQL. Une autre solution est de régler le mode « Optimizer » sur RULE.

Optimisation des tables systèmes

Le fournisseur de données System.Data.OracleClient utilisé par WorkflowGen génère des instructions SQL sur certaines tables systèmes (all_synonyms, all_cons_columns et all_constraints). Quand ces tables contiennent beaucoup de données (par exemple, quand la base de données WorkflowGen partage les mêmes instances Oracle avec d’autres bases de données), la performance peut être affectée quand vous lancez ou complétez une demande ou une action.

Une solution pour améliorer le temps de réponse est de rediriger ces instructions SQL vers des vues/tables de portée locale, qui sont des copies filtrées de ces tables systèmes. Ces changements sont transparents pour WorkflowGen.

Pour ce faire, exécutez les instructions SQL ci-dessous (en remplaçant WFGEN_USER avec le nom du compte utilisé pour se connecter à votre base de données WorkflowGen. (Si le compte contient d’autres tables utilisées par d'autres applications, vous pouvez toujours suivre cette procédure si ces tables n’utilisent pas des synonymes.)

Note : Nous vous suggérons de supprimer (« DROP ») ces vues et tables existantes (all_synonyms, all_cons_columns et all_constraints) de votre base de données avant chaque mise à jour de WorkflowGen, et ensuite les recréer après la procédure de mise à jour.

create or replace force view WFGEN_USER.all_synonyms (owner, synonym_name, table_owner, table_name, db_link) as select null, null, null, null, null from dual;

create table WFGEN_USER.all_cons_columns as select * from sys.all_cons_columns where owner = 'WFGEN_USER';

create table WFGEN_USER.all_constraints as select owner, constraint_name, constraint_type, table_name, r_owner, r_constraint_name, delete_rule, status, deferrable, deferred, validated, generated, bad, rely, last_change, index_owner, index_name, invalid, view_related from sys.all_constraints where owner = 'WFGEN_USER'

Installation PowerShell de WorkflowGen

La procédure suivante s'applique à l'installation PowerShell de WorkflowGen, qui est compatible avec MS SQL Server (via authentification SQL Server), Windows Server 2012 R2, Windows Server 2016 et Windows 10. Pour la base de données Oracle et / ou d'autres systèmes d'exploitation, utilisez soit la procédure d'installation InstallShield Wizard ou la procédure d'installation manuelle.

Vous devez avoir une connexion internet active pour effectuer cette installation à moins que vous aviez déjà téléchargé les dépendances par l'exécution du script avec l'indicateur (« script flag ») -DownloadOnly.

Notes

  • Par défaut, l'installation PowerShell installera la version la plus récente de WorkflowGen. Pour installer une version antérieure de WorkflowGen, remplacez l'URL de téléchargement du pack d'installation manuel la plus récente (dans scripts\settings.json sous WFGManualZipPath) par le numéro de version de WorkflowGen dans le format x-x-x. Par exemple, pour télécharger le pack d'installation de la version 7.2.0 de WorkflowGen, l'URL serait http://download.workflowgen.com/product/7-2-0/manual.zip.

  • L'installation PowerShell installera la version 6.11.5 de Node.js, iisnode et IIS Url Rewrite.

Installation

  1. Ouvrez config.json dans un éditeur de texte et configurez les paramètres pour votre installation de WorkflowGen (voir Paramètres de configuration de l'installation PowerShell ci-dessous pour des informations sur chaque paramètre).

  2. Ouvrez une instance de PowerShell en tant qu'administrateur.

  3. Exécutez .\install.ps1 (avec les indicateurs de script facultatifs listés dans Indicateurs de script PowerShell facultatifs ci-dessous).

Notes

  • Assurez-vous que la stratégie d'exécution est bien réglé (voir https://technet.microsoft.com/en-us/library/ee176961.aspx; disponible en Anglais suelement). Si vous préférez ne pas modifier la stratégie d'exécution, vous pouvez la contourner en exécutant le script d'installation de WorkflowGen comme suit : PowerShell.exe -ExecutionPolicy Bypass -File .\install.ps1.

  • Vous pouvez suspendre la sortie en cliquant sur le shell pendant l'exécution. Vous pouvez modifier cette option dans les options de PowerShell, ou appuyez sur la touche ENTRÉE pour recommencer la sortie (ceci ne suspendera pas le script, qui continuera à exécuter en arrière-plan).

Indicateurs de script PowerShell facultatifs

Paramètre

Description

DownloadOnly

Exemple : .\install.ps1 -DownloadOnly Cette option terminera les scripts une fois que tous les paquets seront téléchargés. Ceci est utile si vous voulez installer WorkflowGen sur un réseau qui n'est pas connecté à l'internet.

SkipParamInput

Exemple : .\install.ps1 -SkipParamInput Cette option sautera les invites à vérifier les paramètres avant l'exécution du script d'installation, si par exemple vous voulez exécuter le script install.ps1 via un autre script.

Paramètres de configuration de l'installation PowerShell

Paramètre

Description

LicenseType

Valeurs possibles : free ou full (par défaut : free) Ce paramètre spécifie la licence par lequel vous installez WorkflowGen : full remplira le paramètre SerialNumber dans le fichier web.config; free incluera la licence gratuite et sa CLUF (EULA). Note : Si vous installez par la licence complète de WorkflowGen, vous devrez copier le fichier de licence dans le dossier \bin de WorkflowGen manuellement (p.ex. : C:\Inetpub\wwwroot\wfgen\bin).

SerialNumber

Si vous installez par la licence complète, saissisez le numéro de série qui vous a été fourni

WebAppPath

L'emplacement physique où le site WorkflowGen sera situé (par défaut : C:\Inetpub\wwwroot\wfgen) Note : Ce chemin doit se terminer par \wfgen.

ServicesPath

L'emplacement physique où les services WorkflowGen seront situés (par défaut : C:\Program Files\Advantys\WorkflowGen\Services)

NodeJSPath

L'emplacement physique où Node.js sera installé; ce paquet est requis pour certaines fonctionnalités de WorkflowGen telles que GraphQL et les webhooks

SQLServerInstance

Le nom ou l'emplacement de l'instance de la base de données SQL Server Note : Si le serveur de la base de données est le même que le serveur de l'application WorkflowGen, vous pouvez utiliser (local).

SQLLoginID et SQLPassword

Les informations d'identification de connexion qui seront utilisées uniquement pour la création de la base de données WorkflowGen; elles doivent avoir le niveau d'accès requis Note : Vous pouvez laisser ces paramètres vides si le paramètre SQLServerInstance déjà fourni a une base de données WorkflowGen entièrement fonctionnelle et à jour (y compris les utilisateurs SQL).

DBName

Le nom de la base de données WorkflowGen à utiliser ou à créer (par défaut : WFGEN) Note : Si le nom de la base de données est déjà utilisé, aucune base de données ne sera créée, et l'installation supposera que la base de données fournie est entièrement fonctionnelle et à jour (y compris les utilisateurs SQL).

DBFilePath et DBLogPath

L'emplacement physique où la nouvelle base de données sera créée (applicable uniquement lors de la création d'une nouvelle base de données); si vous laissez ce chemin vide, une base de données sera créée dans le chemin par défaut de l'environnement Note : Si ces paramètres sont fournis, l'identité pour le serveur SQL doit également avoir les permissions pour ce dossier.

DBLoginID et DBPassword

Utilisateur de base de données standard (avec les permissions lecture et écriture) utilisé par l'application WorkflowGen (par défaut : WFGEN_USER); l'utilisateur de base de données est créé seulement si une nouvelle base de données est créée Note : Si vous utilsez une base de données existante, ces paramètres seront utilisés dans la chaîne de connexion du web.config, assurez-vous alors que ceux-ci correspondent à l'utilisateur et au login existants. Si vous créez une nouvelle base de données, assurez-vous que ce login n'existe pas déjà (p.ex. par une autre base de données).

IISSiteName

Le nom du site Web IIS dans lequel l'application WorkflowGen sera emplacée; un site Web IIS sera créé s'il n'existe pas déjà (par défaut : WorkflowGen)

IISApppoolName

Le nom du pool d'application de WorkflowGen; un pool d'application sera créé s'il n'existe pas déjà (par défaut : WorkflowGenAppPool)

IISBinding

L'adresse IP qui sera liée à WorkflowGen; la valeur * représente toutes les adresses IP non attribuées (par défaut : *)

IISPort

Le port TCP/IP de WorkflowGen (par défaut : 80)

IISAuthentication

Indique quel mode d'authentification à utiliser pour l'installation initiale de WorkflowGen; les valeurs possibles sont Windows, WorkflowGen et Basic WorkflowGen utilise le module d’authentification personnalisé de WorkflowGen, qui stocke les informations d’identification dans la base de données WorkflowGen. Si cette option est sélectionnée, le mot de passe initial pour le compte spécifié dans WFGAdminUserName sera réglé sur Passw0rd! et devrait être changé immédiatement. Basic utilise l'authentification IIS selon la configuration Windows courante. Avec cette option, vous pouvez créer un nouvel utilisateur Windows (WFGAdminUsername) avec un mot de passe spécifique ou bien utiliser un compte Windows existant. Windows utilise l'authentification IIS selon la configuration de Windows courante comme l'authentification Basic, mais vous devez être connecté avec le compte spécifié dans WFGAdminUsername.

WFGAdminUsername, WFGAdminPassword et WFGAdminDomain

Le premier compte d'administrateur WorkflowGen (par défaut : wfgen_admin); selon la méthode d'authentification, ce compte pourrait nécessiter un compte Windows correspondant. Un mot de passe est requis uniquement si le compte sera créé lors de l'installation.

WebsiteURL

L'URL où WorkflowGen sera accessible; cette valeur est remplie dans le web.config (par défaut : http://localhost/wfgen)

SMTPServer

L'emplacement du serveur SMTP pour WorkflowGen; cette valeur est remplie dans le web.config (par défaut : smtp.mycompany.com)

DefaultEmailSender

L’adresse email par défaut qui sera utilisé en tant qu’émetteur des notifications WorkflowGen; cette valeur est remplie dans le web.config (par défaut : workflowgen@mycompany.com)

Notes importantes

  • En format JSON, les barres obliques inverses (\) doivent être échappées comme suit :

      {
         "param" : "C:\\valid\\windows\\path"
      }
  • Vous pouvez terminer le script en tout temps en appuyant sur CTRL+C. Si effectué lors d'un téléchargement ou une procédure d'extraction, il se peut que les dossiers créés doivent être supprimés (p.ex. : \package\); sinon, le script détectera leur présence et présumera qu'ils sont complets.

Installation InstallShield Wizard de WorkflowGen

Présentation

Les procédures qui suivent s’appliquent au pack d’installation utilisant l’InstallShield Wizard de WorkflowGen. Pour démarrer l’installation, double-cliquez sur le fichier d’exécution setup et suivez les instructions à l'écran. L’installation peut être annulée à tout moment en cliquant sur Cancel.

L’InstallShield Wizard réalisera les actions suivantes :

  • Installation de l’application Web

  • Installation des services Windows

    Note : 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 ».

  • Création de la structure et des contenus de la base de données SQL Serveur et du compte utilisateur associé de la base de données si MS SQL Serveur est choisi

  • Création de la structure et des contenus de la base de données Oracle si Oracle est choisi

  • Création du compte utilisateur Windows NT ou Domaine (Administrateur WorkflowGen par défaut)

  • Création d’un fichier de log dans l’annuaire où le fichier d’installation du set-up WorkflowGen est localisé. En cas de problème, l’erreur sera détaillée dedans. Nous recommandons le lancement du programme d’installation depuis votre serveur web.

Note : Pour la procédure d’installation manuelle, passez à la section Installation manuelle de WorkflowGen.

Écran d'accueil

Cliquer sur Next pour continuer. Le programme d’installation vous suggérera d’arrêter les services IIS et toutes applications antivirus avant le démarrage de l’installation.

Architecture des dossiers et des fichiers de WorkflowGen

Il est suggéré que les fichiers et dossiers statiques résident sous le répertoire DISQUE:\Inetpub\wwwroot\wfgen qui contient les ressources telles que les images, les fichiers html et les données des process.

Cliquez sur Next pour continuer.

Espace disque requis

L’application vous demandera de définir le disque physique local pour l’installation de WorkflowGen. Un espace disque minimal de 71 Mo est requis.

Vérifiez l’espace disponible sur le disque de destination et cliquez sur Next pour continuer.

Spécification du fichier d'application Web

Définissez le chemin pour le dossier racine de l'application Web. Par défaut, le chemin suggéré est DISQUE:\Inetpub\wwwroot\wfgen.

  1. Spécifiez le chemin des fichiers et dossier racine de l'application Web. Assurez-vous de spécifier le sous-dossier \wfgen.

  2. Cliquez sur Change pour choisir un autre dossier de destination. Une nouvelle boîte de dialogue s’ouvrira pour vous permettre de choisir un autre dossier de destination.

  3. Cliquez sur Next pour continuer.

  4. Spécifiez le nom du dossier de destination. Assurez-vous de spécifier le sous-dossier \wfgen.

  5. Cliquez sur OK pour confirmer.

Spécification du dossier des services WorkflowGen

Définissez le chemin pour le dossier des services WorkflowGen. Par défaut, le chemin suggéré est DISQUE:\Program Files\Advantys\WorkflowGen.

Note : Cette installation écrasera vos services WorkflowGen existants si vous avez déjà une autre version de WorkflowGen installée sur le même serveur. Si vous voulez préserver vos services WorkflowGen antérieurs, nous vous suggerons de choisir un autre répertoire pour la version 7 (ex. : DISQUE:\Program Files\Advantys\WorkflowGen v7). Quand cette installation est terminée, voir la section Configuration de plusieurs instances de WorkflowGen afin d’obtenir les instructions sur la façon de réinstaller les services antérieurs sur le même serveur.

  1. Spécifiez le chemin pour les fichiers et dossier des services Windows. Assurez-vous d'inclure le sous-dossier \wfgen.

  2. Cliquez sur Change pour choisir un autre dossier de destination. Une bpôte de dialogue s'ouvrira pour vous permettre de choisir un autre dossier de destination.

  3. Cliquez sur Next pour poursuivre.

Configuration de la base de données

Sélectionnez MS SQL Server ou Oracle, puis cliquez sur Next.

Configuration de MS SQL Server

Important : Si vous choisissez de créer une nouvelle base de données avec le nom d’une base de données existante, toutes les données seront supprimées et écrasées avec une base de données vierge. Pour éviter la perte de données involontaire, assurez-vous de choisir un nom unique pour la base de données. D’ailleurs, vous devriez sauvegarder votre base de données existante avant de continuer avec l’installation.

Prérequis MS SQL Server

  • Vous ne pouvez pas utiliser l’InstallShield Wizard avec SQL Server en mode d’authentification Windows.

  • Le serveur SQL doit prendre en charge l'authentification SQL. Si ce n'est déjà fait, activez ce paramètre de sécurité dans votre configuration de serveur SQL.

Authentification MS SQL Server

Paramètre

Définition

Créer une nouvelle instance de base de données

Cette option créera une nouvelle structure et contenu de la base de données

Installez une instance de base de données créée précédemment

Cette option créera seulement le contenu dans la structure d’une base de données existante et vide

MS SQL Server

Nom du serveur MS SQL

Login ID

Ouverture de session de l’administrateur du SGDB

Mot de passe

Mot de passe de l’administrateur du SGBD

Nom de base de données

Nom de la base de données à utiliser / créer

  1. Choisissez de créer une nouvelle base de données ou d’installer sur une base de données créée précédemment.

    Important : Si vous utilisez le même nom de base de données qu’un base de données existante, l’installation supprimera toutes les données existantes.

  2. Spécifiez le nom du serveur SQL ou cliquez sur Browse pour choisir parmi une liste de serveurs SQL.

  3. Par défaut, le nom du serveur est nom de la machine\nom de l’instance. Spécifiez le nom d’utilisateur et le mot de passe pour le compte SA et le nom de l’instance de la base de données.

    Important : Dans SQL Server, il est important que le mot de passe de tous les utilisateurs de la base de données respecte la stratégie de mot de passe du serveur. Dans le cas contraire, une erreur 5110 est lancée.

  4. Cliquez sur Next pour continuer.

Note : L'ID utilisateur WFGEN_USER (mot de passe : Admin123!) sera créé automatiquement avec les rôles datareader et datawriter et incorporé à la base de données WorkflowGen. Ces paramètres seront utilisés dans la chaîne de caractères de connexion pour accéder à la base de données WorkflowGen.

Configuration des fichiers de donées et journal WorkflowGen

Spécifiez les paramètres Data File (fichier de données) et Log File (fichier de journal).

Important :

  • Le chemin que vous inscrivez pour le fichier de données et le fichier journal doit être le chemin local vers le serveur SQL, même si le serveur SQL est éloigné du serveur Web sur lequel s'exécute l'installation.

  • Le chemin spécifié doit déjà exister, sinon vous recevrez un message d'erreur Error 5110: An error occurred while connecting to database ‘WFGEN’ (une erreur est survenue pendant la connexion à la base de données « WFGEN »).

Paramètre

Définition

Nom du fichier

Nom du fichier

Chemin

Chemin physique dans lequel le fichier est stocké

Taille

Taille initiale du fichier créé (en Mo)

Taille maximale

Taille maximale du fichier (en Mo)

Croissance des fichiers

Pas d’incrémentation de la taille du fichier (en Mo)

Important : Le chemin physique par défaut de SQL Server est DISQUE:\Program Files\Microsoft SQL Server\MSSQL[X]\MSSQL\Data.

Spécifiez les paramètres pour les fichiers de données et log (nom du fichier, chemin, taille, taille maximale et taille de croissance). Cliquez sur Next pour continuer.

Configuration Oracle

Note : L’instance de la base de données utilisée ici ne sera pas créée. Vous devez donc la créer préalablement à l’utilisation du pack. Référez-vous à la section Installation sur la base de données Oracle.

Paramètre

Définition

Data source

Nom de l’instance Oracle

ID utilisateur

Login d’un compte utilisateur ayant des droits de création sur l’instance choisie

Mot de passe

Mot de passe d’un compte utilisateur ayant des droits de création sur l’instance choisie

  1. Spécifiez le nom de l’instance de la base de données Oracle.

  2. Spécifiez le nom d’utilisateur et le mot de passe pour le compte administrateur.

  3. Cliquez sur Next pour continuer.

Installation de configuration du compte de l’administrateur WorkflowGen

WorkflowGen requiert un compte Windows NT ou Active Directory valide. Ce compte est utilisé par l’administrateur WorkflowGen, mais il n’a pas forcément le profil administrateur NT sur le serveur.

  1. Spécifiez le nom du domaine si le compte de l’administrateur WorkflowGen qui sera créé fera partie d’un domaine. Sinon ce compte sera créé sur la machine locale.

  2. Spécifiez le nom d’utilisateur et le mot de passe pour le compte administrateur WorkflowGen.

  3. Choisissez de créer le compte NT pour l’administrateur WorkflowGen ou de ne pas faire la création en utilisant un compte existant (le nom d’utilisateur et le mot de passe sont requis).

  4. Cliquez sur Next pour continuer.

Configuration générale

Paramètre

Définition

Data source

Nom de l’instance Oracle

ID utilisateur

Login d’un compte utilisateur ayant des droits de création sur l’instance choisie

Paramètre

Définition

URL du site Web

L’URL de base à partir de laquelle l’URL complète de WorkflowGen sera générée

SMTP Server

Le serveur SMTP, pour l’envoi des notifications

Par défaut Email Sender

L’email utilisé en tant qu’émetteur lors des notifications automatiques

  1. Spécifiez l'URL du site web WorkflowGen, le serveur SMTP et l’adresse d’email de l’expéditeur par défaut.

  2. Cliquez sur Next pour continuer.

Prêt pour l’installation

WorkflowGen est maintenant prêt à installer. S’il y a des changements à faire avant l’installation, vous pouvez toujours revenir à chaque étape précédemment visualisée.

Cliquez sur Install pour démarrer l’installation.

Installation terminée

Cliquez sur Finish pour quitter le programme d’installation.

L’installation est terminée. Un fichier journal « WorkflowGen-7-3-setup.txt » retraçant les étapes a été généré dans le même répertoire où se situe le programme d’installation.

Installation manuelle de WorkflowGen

Présentation

La procédure suivante s'applique à l'installation à l'aide du pack d'installation manuelle de WorkflowGen. Vous pouvez vous procurer le pack d'installation manuelle en le demandant à votre fournisseur WorkflowGen.

Note : Pour l’installation avec l’InstallShield Wizard, réferez-vous à la section Installation InstallShield Wizard de WorkflowGen.

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 SQL Server et Oracle

  • 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 suggerons de choisir un autre répertoire pour la version 7 (ex. : DISQUE:\Program Files\Advantys\WorkflowGen v7).

Création de la base de données{creation-base-de-donnees}

WorkflowGen ne supporte pas le classement sensible à la casse. Vous devez donc configurer la base de données pour qu'elle soit sensible à la casse afin d'éviter les erreurs.

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

Script CreateWFGSQLDatabase.vbs

  1. Exécutez le script VBS de création de la base de données « DRIVE:\temp\pack\Databases\MsSQLServer\CreateWFGSQLDatabase.vbs ».

  2. Cliquez sur Yes pour confirmer la création de la base de données.

  3. Cliquez sur No si vous souhaitez utiliser SQL Server 2005/2008/2008 R2/2012.

  4. Cliquez sur Yes pour SQL Server 2005 ou No pour SQL Server 2008/2008 R2/2012.

  5. Cliquez sur Yes pour SQL Server 2008 ou No for SQL Server 2008 R2/2012.

  6. Cliquez sur Yes pour SQL Server 2008 R2 ou No pour SQL Server 2012.

  7. Saisissez le nom de l’instance MS SQL Server.

  8. Saisissez le nom du catalogue (ex : WFGEN).

  9. Saisissez le nom d’utilisateur d’un compte administrateur MS SQL Server (ex : SA).

  10. Saississez son mot de passe.

  11. Saisissez le chemin pour les fichiers de données (« .mdf ») et les logs (« .ldf ») (ex. : DISQUE:\Program Files\Microsoft SQL Server\MSSQL[X]\MSSQL\DATA).

  12. Saisissez la taille maximale des fichiers de données et des logs (ex. : 1000). Il est conseillé de modifier cette valeur plus tard dans MS SQL Server Management Studio pour ne pas limiter la taille.

  13. Cliquez OK pour lancer la création de la base de données.

Note : Un compte utilisateur SQL server nommé WFGEN_USER avec le mot de passe Admin123! sera créé. Ce compte possèdera les permissions db_datareader et db_datawriter sur la base de données de WorkflowGen. Il sera utilisé par la chaine de connexion de l’application WorkflowGen pour se connecter à la base de données.

Manuel

  1. Ouvrez une console MS SQL Server Management Studio.

  2. Connectez-vous à votre instance MS SQL Server avec un compte administrateur.

  3. Dans l’arborescence de gauche, faites un clic droit sur Base de données et sélectionnez Nouvelle base de données.

  4. Saisissez le nom de la base de données (ex. : WFGEN).

  5. Choisissez une croissance automatique pour les données et les logs.

  6. Cliquez OK pour créer la base de données.

  7. Dans l’arborescence de gauche, ouvrez Sécurité. Sur Connexions, faites un clic droit sur Nouvelle connexion… et saisissez un nom (ex. : WFGEN_USER).

  8. Choisissez Windows authentication (vous devrez avoir un compte local ou de domaine valide) ou SQL Server authentication.

  9. Si vous avez choisi une authentification SQL Server, saisissez son mot de passe (ex. : Admin123!).

  10. Dans Mappage de l’utilisateur, cochez la nouvelle base de données WFGEN.

  11. Assignez les permissions db_datareader et db_datawriter à cet utilisateur.

  12. Cliquez OK pour créer l’utilisateur.

  13. Ouvrez le dossier DISQUE:\temp\pack\Databases\MsSQLServer puis exécutez les scripts ci-dessous sur la nouvelle base de données dans l’ordre suivant :

    1. Create_WFG-V7-0_SQL_Tables.sql

    2. Create_WFG-V7-0_SQL_PKeys.sql

    3. Create_WFG-V7-0_SQL_FKeys.sql

    4. Create_WFG-V7-0_SQL_Indexes.sql

    5. Create_WFG-V7-0_SQL_Triggers.sql

    6. Create_WFG-V7-0_SQL_Const.sql

Création de la base de données Oracle

Note : Le script fourni ne crée pas l’instance Oracle. Vous devez créer préalablement une base de données. Référez-vous à la section Installation sur la base de données Oracle.

Script CreateWFGOracleDatabase.vbs

  1. Lancez le script « DRIVE:\temp\pack\Databases\Oracle\CreateWFGOracleDatabase.vbs ».

  2. Cliquez Yes pour confirmer la création de la base de données.

  3. Saisissez l’instance Oracle (ex. : WFGEN).

  4. Saisissez le compte administrateur (ex. : WFGEN_USER).

  5. Saisissez son mot de passe.

  6. Cliquez OK pour lancer la création de la base de données.

Manuel

  1. Ouvrez DBA studio, SQL Plus ou SQL Developer.

  2. Connectez vous à l’instance Oracle avec le compte administrateur que vous avez créé.

  3. Ouvrez le dossier DISQUE:\temp\pack\Databases\Oracle et exécutez les scripts dans l’ordre suivant :

    1. Create_WFG-V7-0_Oracle_Crebas.sql

    2. Create_WFG-V7-0_Oracle_Const.sql

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.

Fichier de configuration 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.

    • MS SQL Server :<add name="MainDbSource" connectionString="Data Source=localhost;Initial Catalog=WFGEN;User ID=WFGEN_USER;Password=Admin123!;" providerName="System.Data.SqlClient" />

    • Oracle : <add name="MainDbSource" connectionString="Data Source=WFGEN;User ID=WFGEN_USER;Password=Admin123!;" providerName="System.Data.OracleClient" />

  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. Indiquez un serveur SMTP ou la passerelle SMTP (ex. : <add key="ApplicationSmtpServer" value="smtpservername" />).

  5. Indiquez l’adresse de l’application (ex. : <add key="ApplicationUrl" value="http://yoursite/wfgen" />).

  6. Indiquez une adresse par défaut pour l’expéditeur des notifications (ex. : <add key="EngineNotificationDefaultSender" value="workflowgen@company.com" />).

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 servur, vous devez spécifier un nouveau nom pour le servce (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.)

  1. Éditez le fichier de configuration du service Engine « 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 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

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.

IIS 7 / 7.5 / 8.0

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

IIS 7 / 7.5 / 8.0

  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

IIS 7 / 7.5 / 8.0

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

IIS 7 / 7.5 / 8.0

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

Configuration du site Web racine de WorkflowGen pour une redirection automatique vers l'application Web wfgen

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

  1. Assurez-vous que l'outil URL Rewrite est déjà installé sur votre serveur WorkflowGen.

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

  3. Définissez le nœud de la règle de redirection comme indiqué ci-dessous (configuration / system.webServer / <rewrite> / <rules> / <rule>) :

    <?xml version="1.0" encoding="UTF-8"?>
    <configuration>
        <system.webServer>
            <rewrite>
                <rules>
                    <rule name="Root to wfgen" stopProcessing="true">
                        <match url="^$" />
                        <action type="Redirect" url="/wfgen/" />
                    </rule>
                </rules>
            </rewrite>
        </system.webServer>
    </configuration>

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 7 ou plus 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.

Applications Web basées sur Node.js

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

  • 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/ ou /wfgen/hooks.

Note : 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.

Pour activer 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.

Pour activer les 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.

Note : 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.

Pour l'authentification applicative WorkflowGen :

<system.webServer> 
    <modules>
        <remove name="ApplicationSecurityAuthenticationModule" />
    </modules>
</system.webServer>

Pour l'authentification personnalisée :

<system.webServer>  
    <modules>  
         <remove name="MyCustomAuthModule" /> 
    </modules> 
</system.webServer>

Services Windows WorkflowGen

Service du moteur WorkflowGen

L'exécution automatique des tâches (par exemple, la gestion des exceptions et notifications de retard) est assurée par ce service Windows. Ce service est installé par l’InstallShield Wizard d’installation et il est démarré automatiquement après l’installation. (Référez-vous à la section Installation des services Windows de WorkflowGen en cas d’utilisation de la procédure manuelle d’installation.)

Si des erreurs ont lieu pendant l'exécution du service, ces erreurs se trouveront dans l'Event Viewer de Windows (source : WorkflowGenEngineService), lequel est accessible sous Administrative Tools de Windows. Tous les messages relatifs à ce service seront affichés dans la section Windows Logs / Application.

Pour gérer l'exécution de ce service Windows, ouvrez Administrative Tools / Services, puis choisissez et ouvrez WorkflowGen Engine (WorkflowGenEngineService).

Service de synchronisation des annuaires WorkflowGen

La synchronisation automatique des utilisateurs et groupes est assurée par ce service Windows. Ce service est installé par l’InstallShield Wizard d’installation et il est démarré automatiquement après l’installation. (Référez-vous à la section Installation des services Windows de WorkflowGen en cas d’utilisation de la procédure manuelle d’installation.)

Si des erreurs ont lieu pendant l'exécution du service, ces erreurs se trouveront dans l'Event Viewer de Windows (source : WorkflowGenEngineService), lequel est accessible sous Administrative Tools de Windows. Tous les messages relatifs à ce service seront affichés dans la section Windows Logs / Application.

Pour gérer l'exécution de ce service Windows, ouvrez Administrative Tools / Services, puis choisissez et ouvrez WorkflowGen Directory Sync (WorkflowGenDirSyncService).

Activation de la licence

Aperçu

Il vous faudra une licence d’essai, Développeur ou Entreprise pour activer la licence de WorkflowGen.

Il vous faudra un numéro de série pour activer les versions Développeur et Entreprise de WorkflowGen. Si vous n'en disposez pas, veuillez contacter votre revendeur.

Comment activer WorkflowGen

Installer le fichier de licence

  1. Supprimez tous les fichiers « .lic » existants du dossier DISQUE:\Inetpub\wwwroot\wfgen\bin.

  2. Copiez votre fichier « .lic » dans le dossier DISQUE:\Inetpub\wwwroot\wfgen\bin.

  3. Assurez-vous que le fichier « .lic » hérite des paramètres de sécurité.

Ajouter le numéro de série au fichier « web.config »

Pour les versions Développeur et Entreprise de WorkflowGen, vous devez modifier le fichier « web.config » qui se trouve dans le répertoire DRIVE:\Inetpub\wwwroot\wfgen.

  1. Modifiez le fichier « \inetpub\wwwroot\wfgen\web.config ».

  2. Inscrivez votre numéro de série sous la valeur du paramètre ApplicationSerialNumber.

Licence par utilisateur

Si vous avez une licence par utilisateur, vous ne pouvez pas dépasser le nombre d’utilisateurs supporté par votre licence sinon un message d’erreur sera affiché, mais la gestion des utilisateurs du module d’administration est toujours accessible.

Dans le cas où vous souhaiteriez importer des utilisateurs depuis votre annuaire d’entreprise (Active Directory, LDAP, etc...) et parce qu’uniquement les utilisateurs avec le statut Actif sont prises en compte, vous pouvez choisir selon les différents cas de figure ci-dessous :

  • Si votre annuaire d’entreprise contient moins d’utilisateurs que le maximum d’utilisateurs supportés par votre licence WorkflowGen, alors vous pouvez importer tous vos utilisateurs avec l’option Statut par défaut d’un nouvel utilisateur définit comme Actif.

  • Si votre annuaire d’entreprise contient plus d’utilisateurs que le maximum d’utilisateurs supportés par votre licence WorkflowGen, alors vous pouvez importer tous vos utilisateurs avec l’option Statut par défaut d’un nouvel utilisateur définit comme Inactif et décider d’opter pour l’une des deux options suivantes :

    • Si vous désirez activer manuellement les utilisateurs autorisés à utiliser WorkflowGen, vous devez décocher l’option Auto-activation. Dans ce cas, aucun utilisareur ne sera capable d’accéder à WorkflowGen tant que son compte ne sera pas activé depuis le module d’admnistration de WorkflowGen.

    • Si vous ne voulez pas vous soucier de l’activation des comptes, vous pouvez laisser l’option Auto-activation cochée. Dans ce cas, les utilisateurs qui se connecteront pour la première fois seront activés jusqu’à ce que le maximum d’utilisateurs autorisés par la licence WorkflowGen ne soit atteint.

Tests

Adresses Web App

Vérifiez si les liens suivants aboutissent avec le compte utilisateur wfgen_admin :

  • Portail utilisateur : http://[votresite]/wfgen

  • Module d’administration : http://[votresite]/wfgen/admin

S'il ne vous est pas possible d'ouvrir une session, vérifiez le fichier « web.config » dans le dossier racine de l'application WorkflowGen (habituellement DISQUE:\Inetpub\wwwroot\wfgen) et validez que la chaîne de caractères de connexion MainDbSource comporte les informations de connexion correctes de la base de données, y compris le serveur, le nom de la base de données, l'ID utilisateur et le mot de passe.

Essai d'exemples de processus

Vous pouvez créer un nouveau processus à partir des exemples de processus intégrés.

Paramétrages supplémentaires

Vous pouvez modifier la configuration de la sécurité (comme la méthode d’authentification) en suivant la section Sécurité de ce document.

Notes

  • Tous les paramètres de configuration requis de WorkflowGen ne sont pas définis dans cette configuration. Il est recommandé de mettre à jour tous les autres paramètres dans le panneau de configuration de WorkflowGen via le module d'administration après cette installation. Pour plus de renseignements, référez-vous au guide de référence du module d’administration WorkflowGen.

  • Vous pouvez configurer le fuseau horaire et la langue des nouveaux utilisateurs via le panneau de configuration du module d'administration. Vous pouvez également accéder à la configuration des modules directement via l'URL http://[VOTRESITE]/wfgen/admin/Config.aspx une fois l'installation terminée.

  • Le fuseau horaire affecté aux nouveaux utilisateurs peut être modifié depuis l’onglet Général du Panneau de configuration de WorkflowGen.

  • La langue par défaut des nouveaux utilisateurs peut être modifiée depuis l’onglet Administration du Panneau de configuration de WorkflowGen.

Dernière mise à jour