L'installation de l'Archive Portal peut être réalisé sur le serveur Windows après que le serveur Apache 2.4 eut été déployé. Cette étape va permettre de finaliser la configuration du serveur HTTP Apache et de déployer tous les fichiers utiles au portail d'archivage (CTGate.exe, CTServer.exe, …).

Prérequis logiciels

L'installation et la configuration de l'Archive Portal est facilité par l'utilisation d'un Wizard. Il faut vérifier que vous disposez bien des fichiers suivants sur la machine hébergeant le serveur Apache avant de lancer le processus d'installation :

• InstallWizard.exe : Il s'agit du Wizard d'installation de l'Archive Portal. Il vous a été envoyé par la société Cooperteam.
• Licence.xml : Il s'agit du fichier de Licence Utilisateur contenant la clé d'activation du Portail. Ce fichier vous a été envoyé par Cooperteam.
• Directory.xml : Il s'agit du fichier contenant l'export du Carnet d'Adresse de votre infrastructure Domino. Ce fichier est généré depuis l'Identity Station de votre AMF, en utilisant le bouton Build Directory.xml and Access.xml files depuis la vue Users / By Domino Mail Server :

• Access.xml : Il s'agit du fichier contenant la correspondance entre les identités Active Directory et les FullName Domino. Ce fichier est généré depuis l'Identity Station de votre AMF, en utilisant le bouton Build Directory.xml and Access.xml files depuis la vue Users / By Domino Mail Server. Il faut au moins sélectionner une personne qui aura les droits d'administration sur l'Archive Portal lors de la création du fichier Access.xml (Archive Portal Administrators) :

L'identité saisie dans le dernier champ doit être en adéquation avec le type de Login sélectionné (UPN, sAM Acount Name, e-Mail…).

Certificats SSL

Si vous souhaitez bénéficier du chiffrement SSL au niveau du serveur Apache, vous devez préparer les fichiers de certificats suivants :

• [archiveportal-cert].crt : Ce fichier contient le certificat SSL signé du serveur.
• [archiveportal-cert].key : Ce fichier contient la clé privée du serveur.

Authentification des utilisateurs

Le Wizard d'installation vous permettra de sélectionner le mode d'authentification des utilisateurs auprès du serveur Apache. Vous disposez de 3 possibilités :

• Authentification Simple via le fichier .htpasswd contenant les couples Login / mots de passe de Apache. Cette solution est à envisager si le portail d'archive est réservé à un petit nombre d'utilisateurs car la gestion des login / password du fichier .htpasswd sera de la responsabilité de l'administrateur du serveur Apache, via l'utilitaire htpasswd.exe.
• Authentification auprès de l'Active Directory du domaine Windows. L'utilisateur devra saisir son login / password à chaque connexion au portail d'archive. Cette solution permet à tout utilisateur connu dans l'annuaire Active Directory de pouvoir se connecter au portail en utilisant ses identifiants habituels. Il faudra néanmoins créer un compte de service (login / password) qui sera utilisé par Apache pour aller interroger l'annuaire Active Directory via une requête LDAP. Le login et le mot de passe de ce compte sera inscrit en clair dans le fichier de configuration Apache (httpd.conf). Ce compte n'a pas besoin de droits particuliers auprès de l'Active Directory. Il lui suffit d'un droit en lecture des fiches de l'annuaire. Il faudra contrôler la date d'expiration de ce compte de service afin de ne pas bloquer l'authentification des utilisateurs.
• Authentification SSO / NTML. L'utilisateur se connecte de façon transparente au serveur d'archive sans qu'aucun login / password ne lui soit demandé.

Installation de l'Archive Portal

Pour lancer l'installation de l'Archive Portail, veuillez exécuter le fichier InstallWizard.exe. Une première fenêtre s'ouvre :

Il vous suffit de sélectionner Install a new Instance et cliquer sur le bouton Next >.  Une nouvelle fenêtre s'ouvre :

Vous devez y renseigner :

• Le chemin où le serveur Apache a été installé
• Le chemin du fichier Access.xml
• Le chemin du fichier Directory.xml
• Le chemin du fichier Licence.xml

Vous pouvez ensuite cliquer sur le bouton Next >. La fenêtre de configuration principale s'ouvre. Elle se découpe en plusieurs zones  :

• Archive Portal :

Les paramètres suivants sont obligatoires pour l'installation de la solution Archive Portal :

• • • • Archive Portal folder path :  Chemin du répertoire où seront installés les fichiers de configuration de l'Archive Portal.
      • Archive Portal name : Nom interne du serveur Archive Portal. Si plusieurs serveurs Archive Portal devaient être installés sur la même machine, il faudrait veiller à saisir dans ce champ une valeur unique pour chaque instance.
      • Archive Portal administrator : il s'agit de l'identité d'une des personnes qui est déclarée comme Administrateur dans le fichier Access.xml. Si cette identité n'est pas trouvée dans le fichier Access.xml, une fenêtre d'erreur sera affichée.

• Serveur Apache :

Le Wizard d'installation de la solution Archive Portal a la possibilité de configurer automatiquement le serveur HTTP Apache en fonction des options d'authentification et de sécurité choisies. Pour cela il vous suffit ce cocher la case Update Apache Configuration et remplir les champs suivants :

• • • • Apache Server Name : URL d'accès au serveur Apache.
      • Apache Server Admin email : Adresse e-mail de l'administrateur du serveur Apache qui sera affichée sur les pages d'erreurs produites par le serveur Apache.

• Authentification Simple :

Si vous souhaitez activer l'authentification simple, il vous suffit de cocher la case Enable Basic Authentication et remplir les champs suivants :

• • • • Password file path : Chemin du fichier .htpasswd où Apache stocke les login / password.
      • Administrator password :  Mot de passe associé au Login Administrateur du portail (cf. Archive Portal administrator).

• Authentification Active Directory :

Si vous souhaitez activer l'authentification LDAP auprès de l'annuaire Active Directory, vous devez cocher la case Enable LDAP Authentication et remplir les champs suivants :

• • • • Authentication LDAP URL : URL d'accès à l'annuaire LDAP que Apache va utiliser pour valider l'authentification des utilisateurs. L'URL est composé de plusieurs sous-ensembles :
        • • ldap://active-directory-server:389/ : Hostname + Port du serveur Active Directory.
          • DC=test,DC=ideas,DC=com? : Chemin d'accès aux entrées Person de l'annuaire.
          • sAMAccountName,mail : Liste des attributs LDAP utilisés comme Login.
          • ?sub?(objectClass=*) : Critère de recherche.
      • Authentication LDAP Bind DN : DN du compte de service utilisé pour accéder à l'annuaire Active Directory (via LDAP) pour y lire les fiches Person des utilisateurs.
      • Authentication LDAP Bind Password : Mot de passe du compte de service.

• Authentification Single Sign-On :

Si vous souhaitez activer l'authentification SSO via NTLM, veuillez cocher la case Enable NTLM SSO Authentication.

• Certificats SSL :

Si vous souhaitez mettre en place une connexion chiffrée avec le serveur Apache, vous devez cocher la case Enable SSL et remplir les champs suivants : 

• • • • Signed Certificate file path : Chemin du fichier certificat SSL .crt
      • Private Key file path : Chemin du fichier certificat SSL .key

Une fois toutes les options sélectionnées, vous devez appuyer sur le bouton Install. Le processus d'installation démarre et la barre de progression affichée en bas de la fenêtre indique l'avancement des opérations. Une fois terminé, la fenêtre de fin d'installation est affichée :

Fichier de Log de l'installation

Afin d'obtenir des détails sur les opérations réalisées par le Wizard d'installation, vous pouvez consulter le fichier de Log d'installation (CTInstallWizardLog_*.txt) qui se trouve dans le répertoire temporaire de la machine :

Si des erreurs étaient survenues pendant le processus d'installation, vous retrouveriez dans ce fichier tous les détails. N'hésitez pas à le parcourir rapidement pour vérifier que tout s'est bien déroulé.