Mise à jour vers la version 3.20.0

Configuration : paramètres en base de données

À partir de cette version, la plupart des réglages qui figuraient dans config.properties sont enregistrés en base de données.

À prévoir lors d’une mise à jour

Au premier démarrage après passage à cette version, la migration des paramètres du fichier vers la base de données est automatique :

• RAC/M Identity copie config.properties vers config.properties.old, enregistre en base de données les valeurs migrées, puis supprime du config.properties les entrées concernées.
• Si config.properties.old existe déjà, la migration ne s’exécute pas : la sauvegarde existante ne doit pas être écrasée (à traiter avant de relancer, par exemple en renommant ou en archivant l’ancien fichier .old).

Ce qui reste dans config.properties

La liste ci-dessous recense les propriétés qui restent dans le fichier config.properties. Celles indiquées comme (facultatif) peuvent être omises si les valeurs par défaut conviennent.

Sources de données — pour chaque préfixe datasource.config, datasource.data et datasource.workflow :

• {prefix}.driver, {prefix}.url, {prefix}.username, {prefix}.password
• (facultatif) {prefix}.timeBetweenEvictionRunsMillis, {prefix}.testWhileIdle, {prefix}.validationQuery, {prefix}.validationQueryTimeout, {prefix}.maxTotal, {prefix}.maxWaitMillis, {prefix}.maxConnLifetimeMillis, {prefix}.testOnBorrow, {prefix}.minEvictableIdleTimeMillis

Serveur web (SSL / Jetty)

• webserver.ssl, webserver.ssl.protocol_excludes, webserver.ssl.protocol, webserver.ssl.cypher_excludes
• webserver.ssl.keystore, webserver.ssl.keystore.password, webserver.ssl.trustore, webserver.ssl.trustore.password
• (facultatif) webserver.ssl.port, webserver.kerberos.display.sso

Courriel sortant (SMTP / OAuth2 côté fichier)

• mail.server.host, mail.server.port, mail.server.user, mail.server.timeout.ms, mail.server.retry.count
• (facultatif) mail.auth.protocol, mail.server.starttls.enable, mail.server.password, mail.oauth2.token.url, mail.oauth2.client.id, mail.oauth2.client.secret, mail.oauth2.scopes

ICF

• icf.folder, run.icf.server, icf.server.keystore.password, icf.server.truststore.path, icf.server.truststore.password
• (facultatif) icf.server.port, icf.server.start.wait.millis

Connecteur / files d’attente C2 (préfixes de cartes de propriétés)

• Préfixes : c2.app.category., c2.app.reqtype., c2.appGroup.category., c2.appGroup.reqtype.
• Propriétés simples : mail.admin.c2, c2.queue.id
• (facultatif) mail.provisioning.c2RequesterUsedAsSender, mail.request.automatic.provisioning.account.notification, mail.request.automatic.provisioning.profile.notification

Amorçage par serveur (séquences / engin de workflow)

Ces clés restent dans config.properties car chaque serveur d’application d’un cluster peut nécessiter une valeur différente. Les modifier exige un redémarrage du serveur.

• (facultatif) scheduler.enable — lorsque true, les séquences automatiques s’exécutent sur ce serveur (défaut true). Affiché sous Configuration → Configurations globales.
• (facultatif) workflow.engine.enable — lorsque true, ce serveur traite les rappels et escalades de workflow planifiés (défaut true). Affiché sous Configuration → Configurations globales (panneau Tâche / Workflow). En configuration haute disponibilité, définissez cette valeur à true sur un seul serveur afin d’éviter l’envoi en double des courriels de rappel et d’escalade. La notification d’attribution de tâche (actionnable) est toujours envoyée, sur le serveur qui a créé la tâche, peu importe ce paramètre.
• (facultatif) workflow.deadline.reload.interval.seconds — fréquence à laquelle le serveur qui exécute l’engin de workflow réanalyse la base de données de workflow partagée pour trouver les échéances de tâches créées par les autres serveurs, afin que leurs rappels soient tout de même envoyés (défaut 60). Utilisé uniquement lorsque workflow.engine.enable est true. Affiché sous Configuration → Configurations globales (panneau Tâche / Workflow, lorsque l’engin de workflow est activé). Absent du fichier de configuration livré ; l’ajouter dans config.properties pour remplacer la valeur par défaut.

Tous les autres paramètres, une fois migrés en base de données, ne sont plus lus depuis config.properties.

Connecteur RSA Authentication Manager

Le connecteur ICF RSA Authentication Manager (rsa-8.4) n’est plus inclus dans la distribution par défaut de RAC/M Identity.

Si vous utilisez ce connecteur :

• Conservez le fichier JAR existant sous [Répertoire d'installation]/server/ICF/server/connectors lors de la mise à jour, ou
• Obtenez le connecteur auprès du support OKIOK et installez-le comme décrit dans Ajout des fichiers de connecteur à la solution.

Voir RSA Authentication Manager pour les détails de configuration.

Connecteur LDAP et Active Directory

Cette version est livrée avec une nouvelle version du connecteur LDAP (3.0.0), qui remplace les versions 1.x distribuées avec les versions précédentes de RAC/M Identity. Les versions 1.x ne sont plus prises en charge : utilisez la version 3.0.0 ou une version ultérieure.

À prévoir lors d’une mise à jour

La mise à jour installe la nouvelle version du connecteur, mais elle ne retire pas les anciennes et ne modifie pas les connecteurs déjà configurés. Tant qu’un connecteur ICF de type LDAP ou Active Directory n’utilise pas la version 3.0.0 ou une version ultérieure, ou tant que les fichiers des versions 1.x demeurent installés, ses imports peuvent échouer.

Remarque

L’anomalie ne se manifeste pas nécessairement dès le premier essai. Un import qui ne rapporte qu’un petit nombre d’entrées peut se terminer normalement, alors qu’un import d’un annuaire volumineux s’interrompt en cours de route : la séquence se termine en erreur après trois tentatives et seule une partie des entrées a été traitée. Une validation faite sur un annuaire de test peu peuplé peut donc laisser croire que tout fonctionne.

Marche à suivre :

1. Sous CONFIGURATION → Connecteurs ICF, créer un nouveau connecteur pour chaque connecteur LDAP ou Active Directory, en sélectionnant la version 3.0.0 ou une version ultérieure dans le champ Type (le type ne peut pas être modifié sur un connecteur déjà enregistré), puis rediriger les tâches concernées vers ce nouveau connecteur.
2. Retirer les fichiers des anciennes versions (connector-ldap-okiok-1.*.jar) du répertoire [Répertoire d'installation]/server/ICF/server/connectors.
3. Redémarrer le serveur ICF.
4. Relancer un import complet et vérifier que le nombre d’entrées traitées correspond au contenu de l’annuaire.

Voir LDAP pour les détails de configuration.