Pré-requis techniques de l'offre On Premise - 05/02/2024

View the English version

Préambule

Cet article décrit les préconisations à respecter sur les postes utilisateurs ou le réseau du client pour un fonctionnement optimal de la solution Timesquare On Premise hébergée chez le client.

Il est impératif que les personnes concernées prennent connaissance de ce chapitre, et s’assurent par tous les moyens de la compatibilité de la solution Timesquare avec les spécificités de l’infrastructure informatique du client.

Dans tous les cas, une étude technique de l’architecture à mettre en place est préférable pour une adaptation parfaite au projet.

Toutes les informations présentes dans ce chapitre sont fournies à titre indicatif et fondées sur notre expérience acquise chez la plupart des clients. Celles-ci sont susceptibles de modifications sans préavis de la part de Holy-Dis et ne peuvent en aucun cas engager la responsabilité de Holy-Dis.

En aucun cas la responsabilité de Holy-Dis ne pourra être engagée en cas de dysfonctionnement de la solution lié au non-respect des pré-requis techniques ici présentés.

Présentation de l’architecture Timesquare multi-tiers

Schéma technique de référence

Timesquare est conçu sur la nouvelle génération de l’architecture orientée web avec un focus tout particulier sur la scalabilité et l’expérience utilisateur (UX) :

• API First design
• Réactive SPA (Single-Page-Application)
• Scalabilité horizontale

Tous les composants de Timesquare peuvent être déployés sur multi-nœuds en mode cluster.

Schéma technique de référence Timesquare (TSQ-AT-R)

Mode de déploiement

Timesquare est conçu pour être déployé en mode cluster ou mode simplifié. Afin de bénéficier de la haute disponibilité et de la scalabilité de Timesquare, le mode de déploiement en mode cluster est préconisé (voir le schéma technique TSQ-AT-R).

Composants Timesquare

Timesquare est constitué de quatre composants logiques indissociables :

• T-WEB : Composant responsable des interactions avec l’utilisateur en utilisant les services fournis par T-API. Il ne contient que les éléments web (HTML, Javascript, CSS, Images, etc.) déployables sur un serveur web standard (ex : Apache HTTP, NGINX, etc.) ou même container de servlets (ex : Apache Tomcat).
• T-API : Composant fournissant les APIs responsables pour toutes les demandes métiers et aussi les contrôles de sécurité (ex : authentification et habilitation). Il contient des codes binaires Timesquare avec un serveur applicatif intégré et exécutable sur une JVM (Java Virtual Machine).
• T-BUS : Composant responsable de la coordination métier et technique entre les différentes instances de Timesquare.
• T-Moteur : Composant responsable du calcul d’optimisation des horaires et celui de la légalité des plannings.

Les deux composants suivants sont optionnels :

• T-Datamart : Timesquare Décisionnel / Datamart est une solution Java standalone avec une connexion JDBC à la base de données relationnelle Timesquare. Elle a pour but d’alimenter la base de données cible pour un usage décisionnel.
• T-Webservice : API webservice de Timesquare exposant une partie des services Timesquare aux applications tierces.

Les autres composants standards cités dans le schéma technique TSQ-AT-R ne sont pas inclus dans le produit Timesquare.

Pré-requis composants tiers

Composants tiers requis

Les composants standards ne sont pas inclus dans le livrable de Timesquare, mais ils sont indispensables pour le bon fonctionnement de la solution. Voici la liste des composants tiers exigés par Timesquare dans un déploiement classique :

• Navigateur Web : Un navigateur moderne avec support HTML 5 et Javascript ES2015 au minimum est nécessaire. Holy-Dis supporte l'accès à ses logiciels à travers les navigateurs Edge, Firefox, Chrome et Safari aussi longtemps que la maintenance régulière (hors maintenance étendue) est assurée par leurs éditeurs. Dans la mesure où les mises à jour de ces navigateurs se font généralement de manière automatique, Holy-Dis préconise l'utilisation des versions majeures de ces solutions.
• ADC (Application Delivery Controller) : Ce composant est nécessaire pour l’équilibrage de charge, reverse-proxy, TLS terminaison, etc. dans le cas d'une URL unique ou en mode multi-instances.
• Serveur Web : Ce composant est nécessaire pour l’hébergement T-WEB, mais optionnel dans le mode de déploiement simplifié.
• Serveur de données : Ce composant est obligatoire pour le fonctionnement de Timesquare.
• Java runtime (JRE) : Ce composant obligatoire pour le fonctionnement de Timesquare.
• Kafka : Ce composant est indispensable pour le bon fonctionnement de Timesquare. Timesquare est compatible avec les versions de Kafka 2.0 ou supérieures. Kafka doit être installé sur un système d’exploitation Linux.
• Zookeeper : Ce composant est indispensable pour le bon fonctionnement de Kafka. Kafka fournit une version embarquée de Zookeeper dans son package et l’installe en même temps que Kafka. Cependant, il est préconisé d’installer la version standard de Zookeeper plutôt qu’utiliser la version embarquée par Kafka notamment pour l’utilisation de My Timesquare. Il est vivement recommandé que Zookeeper soit installé sur un système d’exploitation Linux.
• Certificat SSL : Obligatoire pour la sécurisation en TLS.
• Serveur SMTP interne à votre entreprise : Afin de paramétrer les notifications par email, il est nécessaire d’utiliser un serveur SMTP interne à votre propre infrastructure. Le paramétrage peut être effectué par votre équipe IT ou par nos soins (option payante). Le tableau ci-dessous détaille les propriétés à configurer :

Clé	Valeur
tsq.mail.collab.active	Notification par mail pour Collab (exemple : true)
spring.mail.host	Host de serveur mail (exemple : smtp.holydis.com)
spring.mail.username	Compte de mail d’envoi (exemple : [e-mail])
spring.mail.password	Mot de passe de compte d’envoi (exemple : ****)
spring.mail.properties.mail.transport.protocol	Protocole (exemple: smtp)
spring.mail.properties.mail.smtp.port	Port de serveur mail (exemple : 25)
spring.mail.properties.mail.smtp.auth	Authentification OUI/NON (exemple : true)
spring.mail.properties.mail.smtp.starttls.enable	Activer StartTLS protocole OUI/NON (exemple : true)
spring.mail.properties.mail.smtp.starttls.required	StartTLS protocole obligatoire OUI/NON (exemple : true)

Matrice de compatibilité

Voici la matrice de compatibilité des composants Timesquare avec les logiciels tiers (OS, Java, base de données, etc.).

	Systèmes d’exploitation (OS)	Java	Navigateurs	Bases de données
T-WEB	Windows Linux	N/A	Navigateurs avec support de ES2015 et HTML5	N/A
T-API	Windows Linux	JRE 17 / JDK 17	N/A	Oracle 19c MS-SQL Server 2012 - 2019  MySQL, MYSQL 8.0
T-BUS	Linux	JDK 17	N/A	N/A
T-Moteur	Windows	N/A	N/A	Oracle 19c MS-SQL Server 2012 - 2019  MySQL, MySQL 8.0
T-Datamart	Windows Linux	JRE 17 / JDK 17	N/A	Oracle 19c MS-SQL Server 2012 - 2019  MySQL, MySQL 8.0
T-Webservice	Windows Linux	JRE 17 / JDK 17		Oracle 19c MS-SQL Server 2012 - 2019  MySQL, MySQL 8.0

Important : Merci de contacter les équipes techniques en cas de mise à jour des OS Serveur et des versions de bases de données par rapport à la version validée par Holy-Dis au moment de l'installation.

Pré-requis poste client

Timesquare

Timesquare répond aux standards du flexible web design. La solution s’adapte à la diversité des environnements d’affichage. Les éléments changent de forme et de position sans compromettre l’intégrité de la conception globale de la page.

Timesquare est donc multi-devices : il peut être indifféremment affichée sur un PC ou une tablette (en mode paysage).

Voici la liste des composants exigés par Timesquare :

• Navigateur Web : Un navigateur moderne avec support HTML 5 et Javascript ES2015 au minimum est nécessaire. Holy-Dis supporte l'accès à ses logiciels à travers les navigateurs Edge, Firefox, Chrome et Safari aussi longtemps que la maintenance régulière (hors maintenance étendue) est assurée par leurs éditeurs. Dans la mesure où les mises à jour de ces navigateurs se font généralement de manière automatique, Holy-Dis préconise l'utilisation des versions majeures de ces applications.
• Tableur et lecteur PDF : Pour les tableaux de reporting au format XLSX et les éditions au format PDF. Timesquare est compatible avec Microsoft Excel et Adobe Acrobat pour l'affichage / la lecture de documents produits par la solution aussi longtemps que la maintenance régulière (hors maintenance étendue) est assurée par leurs éditeurs respectifs. 

Note : Il est important de noter que certains logiciels antivirus et/ou leurs paramétrages sont susceptibles de bloquer des flux nécessaires au bon fonctionnement de certaines fonctionnalités. A titre d’exemple, les flux HTTP temps réel peuvent être mal gérés par certains logiciels antivirus, flux qui sont essentiels au bon fonctionnement du système de notifications de Timesquare.

La configuration minimale requise est indiquée dans le tableau ci-dessous.

Systèmes d’exploitation	Microsoft / Linux / Apple OSX
Processeur	4 CPU
Mémoire	8 Go
Résolution d’affichage	1280 x 768 et au-delà

A ce jour, Chromebook et par extension Chrome OS ne font pas partie des systèmes d’exploitation testés compatibles avec Timesquare.

Note : Concernant la résolution des écrans, il est important de noter que la technologie « Retina » dont disposent certains modèles d’appareils de la marque Apple, multiplie le nombre de pixels pour une résolution similaire sur un écran standard. Ainsi, pour un nombre pixels plus élevés, on dispose d’une résolution moindre. C’est pourquoi il est possible que l’affichage de Timesquare sur ces supports ne soit pas optimisé.

Les options « Javascript » et « Téléchargement de fichiers » doivent être activées.

Pour accéder au centre d’aide, il est nécessaire d’avoir une connexion internet, celui-ci étant hébergé par Zendesk, une solution SaaS externe aux serveurs Timesquare.

Concernant le processeur et la mémoire requises, ces informations sont fournies à titre indicatif. Dans tous les cas, les performances d'affichage dépendent également de la charge du navigateur, ainsi que de l’utilisation globale de l’environnement de travail.

Au quotidien, il est vivement recommandé de travailler sur une seule page/onglet Timesquare à la fois. Plus particulièrement, j'évite de travailler sur le même élément (personne, tâche, etc.) sur plusieurs pages/onglets simultanément. En effet, ceci peut engendrer des problèmes de synchronisation, notamment en cas de validation ou d'enregistrement de données.

Pour rappel, une page/onglet correspond à une session utilisateur.

My Timesquare

My Timesquare est la solution dédiée aux collaborateurs. Elle répond aux standards du responsive design. Elle ajuste automatiquement l’affichage de la page web à la taille de l’écran du terminal utilisé.

My Timesquare est donc multi-devices : il peut être indifféremment affichée sur un PC, une tablette (en mode portrait ou paysage), un smartphone.

Voici la liste des composants exigés par My Timesquare :

• Navigateur Web : Un navigateur moderne avec support HTML 5 et Javascript ES2015 au minimum est nécessaire. Holy-Dis supporte l'accès à ses logiciels à travers les navigateurs Edge, Firefox, Chrome et Safari aussi longtemps que la maintenance régulière (hors maintenance étendue) est assurée par leurs éditeurs. Dans la mesure où les mises à jour de ces navigateurs se font généralement de manière automatique, Holy-Dis préconise l'utilisation des versions majeures de ces applications.
• Tableur et lecteur PDF : Pour les tableaux de reporting au format XLSX et les éditions au format PDF. Timesquare est compatible avec Microsoft Excel et Adobe Acrobat pour l'affichage / la lecture de documents produits par la solution aussi longtemps que la maintenance régulière (hors maintenance étendue) est assurée par leurs éditeurs respectifs. 

Le mode Mobile s’active automatiquement pour des résolutions en deçà de 992px à l’horizontale, donc pour un smartphone ou une tablette en mode portrait par exemple.

Les pré-requis techniques du mode Desktop sont identiques à ceux de la solution Timesquare.

Le mode Mobile est adapté aux smartphones du marché fonctionnant sous IOS ou Android ayant une résolution minimum de 375 x 600px.

La connexion à My Timesquare se fait à partir de la même page de login que Timesquare.

Pré-requis serveurs

Serveur Web

Le composant T-WEB est déployable sur les serveurs web standard tels que :

• Apache HTTP
• NGINX

La configuration minimale requise est indiquée dans le tableau ci-dessous.

Espace disque	10 Go
RAM / CPU	A qualifier selon le choix du serveur
Connexion réseau	A qualifier selon le nombre d’utilisateurs et l’intensité d’usage
Système d’exploitation	OS supporté par le serveur web choisi (ex : Windows Server 2019 ou Linux Server récent)
Serveur web	Apache HTTP, NGINX, etc.

Serveur T-API

Timesquare T-API est fourni avec un serveur applicatif intégré. Les hosts hébergés T-API doivent satisfaire les exigences minimales indiquées dans le tableau ci-dessous.

Espace disque	20 Go
RAM/CPU	A qualifier selon le nombre d’utilisateurs et l’intensité d’usage
Connexion réseau	A qualifier selon le nombre d’utilisateurs et l’intensité d’usage
Système d’exploitation	·     Windows Server 2012 à 2019 ·     Linux 64-bit Server avec support JAVA 17
Logiciel	Java Runtime 17 (JRE ou JDK 17)

Serveur T-BUS

Les hosts hébergés T-BUS doivent satisfaire les exigences minimales requises indiquées dans le tableau ci-dessous.

Espace disque	40 Go, SSD recommandé
RAM/CPU	A qualifier selon le nombre d’utilisateurs et l’intensité d’usage
Connexion réseau	A qualifier selon le nombre d’utilisateurs et l’intensité d’usage
Système d’exploitation	Linux 64-bit Server
Logiciel	Java Runtime 17 (JRE ou JDK 17)

Serveur T-Moteur

Timesquare répartit les charges de calcul sur les différentes instances du moteur. En fonction des types de requêtes, le moteur réalise des traitements synchrones (calcul de légalité pour une personne) ou des traitements asynchrones (calcul d’optimisation des horaires).

La configuration minimale requise est indiquée dans le tableau ci-dessous.

Espace disque	10 Go
RAM/CPU	A qualifier selon le nombre d’utilisateurs et l’intensité d’usage
Connexion réseau	A qualifier selon le nombre d’utilisateurs et l’intensité d’usage
Système d’exploitation	Windows Server 2012 à 2019
Logiciel	N/A

Serveur de base de données

Le serveur de base de données héberge toutes les données de la solution. La configuration minimale requise est indiquée dans le tableau ci-dessous.

Espace disque	A qualifier selon la volumétrie des données
RAM/CPU	A qualifier selon le nombre d’utilisateurs et l’intensité d’usage
Connexion réseau	A qualifier selon le nombre d’utilisateurs et l’intensité d’usage
Logiciel	·     Oracle 19c ·     MS SQL Server 2012 à MS SQL Server 2019 ·     MySQL 8.0
Encodage du texte	Unicode

L'utilisation d'un autre SGBDR (Système de Gestion de Bases de Données Relationnelles) devra faire l'objet d'une vérification de compatibilité avec la norme JDBC 4 et de l'existence de pilotes DBExpress pour la connectivité avec les moteurs. Elle devra être ensuite validée par les services techniques de Holy-Dis.

Timesquare doit disposer d'un schéma propre et d'un utilisateur dédié disposant des autorisations propriétaire sur ce schéma.

Pour plus d’informations sur le dimensionnement recommandé, se reporter à la section Dimensionnement de la base de données. 

Configurations matérielles recommandées

Dimensionnement des serveurs Timesquare

La configuration matérielle nécessaire au bon fonctionnement de la solution dépend de plusieurs facteurs :

• Nombre d'utilisateurs de la solution
• Nombre de personnes à planifier
• Exigences sur la disponibilité
• Périmètre fonctionnel

Configuration TYPE 1 (Mono-host)

Dans le cas d’usage simple (jusqu’à 50 utilisateurs, 500 personnes planifiées, pas d’exigence sur la haute disponibilité), les composants Timesquare^® peuvent être déployés sur une seule machine host. Celle-ci peut être une VM ou une machine physiqe dédiée.

Composants Timesquare concernés :

• T-WEB
• T-API
• T-BUS
• T-Moteur

La configuration minimale requise est indiquée dans le tableau ci-dessous.

Espace disque	60 Go, SSD recommandé
RAM/CPU	8 Go RAM, 4 CPU 2GHz+
Connexion réseau	Selon l’intensité d’usage

Configuration TYPE 2 (Multi-hosts)

Timesquare est conçu pour le déploiement en mode cluster avec de multiples hosts comme préconisé dans le schéma technique TSQ-AT-R. Dans ce mode de déploiement, les composants suivants peuvent être déployés sur plusieurs hosts en formant 4 clusters distincts :

• Cluster T-WEB en mode active / active
• Cluster T-API en mode active / active
• Cluster T-BUS en mode active / active
• Cluster T-Moteur en mode master / slave

Ces 4 clusters pourront partager les mêmes hosts pour optimiser l’utilisation des ressources. Pour des périmètres d'utilisation plus importants, veuillez contacter Holy-Dis qui fera une proposition d'architecture personnalisée.

Dimensionnement de la base de données

Un serveur séparé hébergeant la base de données est préconisé pour les installations Timesquare.

Celui-ci pourra éventuellement être mutualisé.

La volumétrie dépend de l'utilisation de la solution, du volume de personnel à planifier ainsi que de l'historique à conserver.

Connectivité et réseau

Le client est responsable de la connectivité et du réseau de son installation.

Installation et configuration

Lors de la mise en œuvre de la solution, Holy-Dis intervient pour l’installation et la configuration des composants logiciels Timesquare.

Il revient au client d’assurer les services d’installation, de configuration du matériel et des « Composants Tiers » requis cités dans les chapitres précédents ainsi que les configurations de sécurité telles que la liaison TLS et les Firewalls.

Télémaintenance

Afin d’optimiser les actions de support de nos équipes et garantir la maîtrise de la solution, Holy Dis demande un accès pour prendre le contrôle à distance des serveurs Timesquare. Cette autorisation est essentielle durant la période de recette du produit.

Les moyens techniques suggérés, et généralement employés, sont :

• Un client TSE, accès par un compte aux privilèges limités
• Un client sFTP configuré avec un compte Holy-Dis, permettant un accès sécurisé au serveur sFTP du réseau Holy-Dis et réservé à nos clients
• Un logiciel d’accès à distance : Teamviewer

Datamart : Configuration dédiée minimum

Pour plus d’informations sur la configuration requise, veuillez-vous reporter à l'article Configuration et pré-requis techniques du Datamart.

Intégration vers des Systèmes Tiers

Web Services

Pour plus d’informations sur la configuration requise, veuillez-vous reporter au chapitre Web Services.

Imports / Exports

Pour plus d’informations sur les interfaces disponibles, veuillez-vous reporter au chapitre Imports / Exports.