Configuration de Workflow Manager 1.0 pour SharePoint 2013 et ses soucis.
L’installation de ferme SharePoint 2013 est à ce jour, vraiment bien voir trop bien documenté.
Merci aussi à AutoSPinstaller et son GUI pour vous faciliter la vie.
Cependant, on trouve vraiment peu d’information dès que vous faites des installations “réelles” de production.
Je veux parler de plusieurs serveurs front avec plusieurs “back office” en topologie streamlined et index secondaire de recherche par exemple 
.
En résumé, pas des installations de dev ou mono machine sans AD
Récemment, j’ai du configurer une small farm avec en plus le Workflow Manager 1.0 pour un besoin simple : l’ajout de workflow 2013 avec SP Designer.
On peut oublier rapidement cette phase car elle n’est pas couverte lors d’une installation classique et encore moins par AutoSpInstaller si vous en êtes fan…
https://autospinstaller.codeplex.com/wikipage?title=Known%20Issues%20with%20SharePoint%202013
Après avoir fait le tour du Web, des documentations MS et des forums, j’ai procédé à l’installation à posteriori (la ferme était déjà en cours d’utilisation) le tout avec un outil CLM par dessus.
L’ensemble c’est relativement bien passé mais impossible d’avoir le choix de SharePoint 2013 workflow …
Je vous rassure, après quelques essais, tout est rentré en ordre. Et j’ai retrouvé l’envie de vous blogger le tout car effectivement, le soucis peut être ardu donc autant le partager au plus grand nombre (et en français)
Pour commencer quelques liens riches de contenu donc incontournables.
Installation
Les officiels
les guides avec screenshots
Introduction
Pour vous situer le contexte, les ferme SharePoint 2013 n‘utilise plus son propre moteur de workflow basé sur WF comme sous SP2010 (certains les appelaient les workslows d’ailleurs …). Désormais, il s’appuie sur un processus externe à sa ferme et son fonctionnement. il s’agit de Workflow manager.
Les serveurs front-end SharePoint utilise le Workflow Client pour communiquer avec le Manager via l’intermédiaire du Service Bus basé sur OAuth et REST.
Soit une plateforme plus moderne mais surtout scalable et performante.
Mais rien ne vous empêche de l’installer et la configurer sur l’un des serveurs de votre ferme.
Le post de Spencer Harbar résume bien son installation et surtout sa montée en charge avec un exemple bien réel.
http://www.harbar.net/articles/wfm2.aspx
Voici quelques règles à bien retenir
- le Workflow client doit être installé sur TOUS les serveurs front de votre ferme SP !
- le Manager n’a pas besoin d’être installer sur un serveur back de votre ferme.
- Le compte de service ne doit pas être un compte admin ou user de votre ferme SP
- N’oubliez pas d’utiliser un Alias SQL pour les DBs de workflows (3 pour le WF manager et 3 pour le service Bus). idéalement séparer les des DBs SharePoint
Installation
Je vous laisse suivre les liens des guides avec screenshots, pas vraiment d’intérêt à les recopier : ils sont clairs et précis !
Soit en résumé :
- Installer déjà les clients avant le manager
- Configurer le manager et son service bus
- Connecter la ferme SharePoint au Workflow Manager via un commande Shell
Et normalement, dans la page de gestion des service application, vous avez un nouveau proxy de workflow !
Et vous pouvez créer sans soucis de splendides et utiles Workflows 2013
>>> le test ultime : en fin de configuration, ouvrez SP Designer et regardez si vous pouvait créer un WF mode 2013
Enfin … si tout vas bien
Si tout ne vas pas bien !!!
Voici quelques erreurs et solution en cas de soucis. J’en ai vécu certaines donc les voici.
- Pensez à contrôler votre configuration !
Vérifier si tout est ok et qu’il n’y a pas d’erreur de port ou d’url ou d’association
soit vérifier le binding Http de IIS, les ports et ses protocoles ainsi que si le AppPool est en ligne.
- Oublie du paramètre allow HTTP si vous êtes en http
Rien de grave, relancer le manager, retirer votre serveur de la ferme puis supprimer les 6 DB Affiliés et reconfigurer
si jamais, pour écraser la configuration de votre connexion, le paramètre –force ignore les erreurs et écrase la config
(ne le faites pas par défaut, traitez l’erreur avant si besoin)
Register-SPWorkflowService -SPSite "http://xxxx" -WorkflowHostUri "http://xxxx:12291" – AllowOAuthHttp –Force
- Soucis de Register-SPWorkflowService
Les plus connus comme Register-SPWorkflowService : The remote server returned an error: (401)
Unauthorized.
http://sharepoint2013suresh.blogspot.ch/2014/03/installing-and-configuring-workflow-for.html
- Le plus hasardeux et embêtant : malgré tout, le choix de plateforme 2013 sous SPD n’est pas disponible !!!
Il y a plusieurs possibilités et peu de logs ou d’indicateur flagrant donc il faut tous les vérifier
A) par sécurité, il est bon de forcer le rafraichissement de vos configs de WF client et manager : redémarrez les pools ou un bon vieux IISRESET sur tous les serveurs WF et SP
=> souvent le bon remède
il n’est pas rare que le refresh ne soit pas automatique … J’ai du attendre 5 minutes et le choix est apparu. Avec un IISreset, jamais d’attente.
B) votre site collection utilise un template “empty” et la feature de Workflow n’est pas activée
il suffit d’activer la feature : Enable-SPFeature -Identity WorkflowServiceStore –Url $yourUrl
C) vérifier vos urls de Site Collection et de WorkflowHostUri dans votre connexion à SharePoint
si vous avez une erreur de port, de sécurité ou tout simplement une faute de frappe, vous risquez de tourner en rond !!! (si si, je parle d’expérience ).
En ce qui me concerne, on testait les Worflows sur la mauvaise collection de qualif, petit erreur de port …
D) il faut que le proxy de WF soit bien attaché à votre Web Application
Ici, des custom proxy groups avaient été créés et malheureusement, ne référençait pas notre proxy de workflow à la différence du group defaut …
Central Admin > Manage Web Application> …
Point de salut, si l’association n’est pas faite, pas de workflow !!!
Voila c’est tout (pour l’instant)
Oh dernier point, il n’est pas inutile de scripter votre configuration en powershell pour la rejouer sans soucis sur votre ferme de production.
Vous pouvez exporter les PS depuis votre installation depuis le manager au moment de valider !
ou sinon voici quelques exemples clés en main
Et bon courage à tous
Renaud Comte aka TheMit (Workslow un jour, workflow toujours )
Ce post vous a plu ? Ajoutez le dans vos favoris pour ne pas perdre de temps à le retrouver le jour où vous en aurez besoin :
