8.2.7.2. Configuration / fichiers utiles

Les fichiers de configuration sont gérés par les procédures d’installation ou de mise à niveau de l’environnement VITAM. Se référer au DIN.

Les fichiers de configuration sont définis sous /vitam/conf/functional-administration.

8.2.7.2.1. Fichier functional-administration.conf

ce fichier permet de définir l’URL d’accès au access server.

#jinja2: lstrip_blocks: True
# Configuration MongoDB
mongoDbNodes:
{% for host in groups['hosts_mongos_data'] %}
- dbHost: {{ hostvars[host]['ip_service'] }}
  dbPort: {{ mongodb.mongos_port }}
{% endfor %}
dbName: masterdata
dbAuthentication: {{ mongodb.mongo_authentication }}
dbUserName: {{ mongodb['mongo-data'].functionalAdmin.user }}
dbPassword: {{ mongodb['mongo-data'].functionalAdmin.password }}

#Basic Authentication
adminBasicAuth:
- userName: {{ admin_basic_auth_user }}
  password: {{ admin_basic_auth_password }}

jettyConfig: jetty-config.xml
workspaceUrl: {{vitam.workspace | client_url}}
processingUrl: {{vitam.processing | client_url}}

# ElasticSearch
clusterName: {{ vitam_struct.cluster_name }}
elasticsearchNodes:
{% for host in groups['hosts_elasticsearch_data'] %}
- hostName: {{ hostvars[host]['ip_service'] }}
  httpPort: {{ elasticsearch.data.port_http }}
{% endfor %}

# ElasticSearch tenant indexation
elasticsearchTenantIndexation:
  default_config:
    number_of_shards: {{ vitam_elasticsearch_tenant_indexation.default_config.masterdata.number_of_shards | default('1') }}
    number_of_replicas: {{ vitam_elasticsearch_tenant_indexation.default_config.masterdata.number_of_replicas | default('2') }}

{% for collection in ["accesscontract", "accessionregisterdetail", "accessionregistersummary", "accessionregistersymbolic", "agencies", "archiveunitprofile", "context", "fileformat", "filerules", "griffin", "ingestcontract", "managementcontract", "ontology", "preservationscenario", "profile", "securityprofile"] %}
  {% if vitam_elasticsearch_tenant_indexation.masterdata[collection] is defined %}
  {{ collection }}:
    {% if vitam_elasticsearch_tenant_indexation.masterdata[collection].number_of_shards is defined %}
    number_of_shards: {{ vitam_elasticsearch_tenant_indexation.masterdata[collection].number_of_shards }}
    {% endif %}
    {% if vitam_elasticsearch_tenant_indexation.masterdata[collection].number_of_replicas is defined %}
    number_of_replicas: {{ vitam_elasticsearch_tenant_indexation.masterdata[collection].number_of_replicas }}
    {% endif %}
  {% endif %}
{% endfor %}

# ExternalId configuration
listEnableExternalIdentifiers:
{% if vitam_tenants_usage_external is iterable %}
  {% for tenant in vitam_tenants_usage_external %}
    {% if tenant.identifiers is defined %}
  {{ tenant.name }}:
      {% for external in tenant.identifiers %}
    - {{ external }}
      {% endfor %}
    {% endif %}
  {% endfor %}
{% endif %}

listMinimumRuleDuration:
{% if vitam_tenant_rule_duration is iterable %}
  {% for tenant in vitam_tenant_rule_duration %}
  {{ tenant.name }}:
    {% for rule in tenant.rules %}
      {% for key, value in rule.items() %}
    {{ key }}: {{ value }}
      {% endfor %}
    {% endfor %}
  {% endfor %}
{% endif %}

accessionRegisterSymbolicThreadPoolSize: {{ vitam.functional_administration.accessionRegisterSymbolicThreadPoolSize | default(16) }}
ruleAuditThreadPoolSize: {{ vitam.functional_administration.ruleAuditThreadPoolSize | default(16) }}

{% if primary_site | lower != "true" %}
# Reconstruction cache duration (in minutes)
reconstructionMetricsCacheDurationInMinutes: {{ vitam.functional_administration.reconstructionMetricsCacheDurationInMinutes | default(15) }}
{% endif %}

8.2.7.2.2. Passage des identifiants des référentiels en mode esclave

La génération des identifiants des référentiels est gérée par Vitam quand il fonctionne en mode maître.

Par exemple :

  • Préfixé par PR- our les profils
  • Préfixé par IC- pour les contrats d’entrée
  • Préfixé par AC- pour les contrats d’accès

Si vous souhaitez gérer vous-même les identifiants sur un service référentiel, il faut qu’il soit en mode esclave.

Note

Cette modification de comportement est réalisable post-installation. Une interruption temporaire de service est à prévoir (redémarrage du service vitam-functional-administration.

Par défaut, tous les services référentiels de VITAM fonctionnent en mode maître. Pour désactiver le mode maître de Vitam, il faut modifier le fichier de configuration /vitam/conf/functional-administration/functional-administration.conf.

# ExternalId configuration

listEnableExternalIdentifiers:
 0:
   - INGEST_CONTRACT
   - ACCESS_CONTRACT
 1:
   - INGEST_CONTRACT
   - ACCESS_CONTRACT
   - PROFILE
   - SECURITY_PROFILE
   - CONTEXT

Depuis la version 1.0.4, la configuration par défaut de Vitam autorise des identifiants externes (ceux qui sont dans le fichier json importé).

  • pour le tenant 0 pour les référentiels : contrat d’entrée et contrat d’accès.
  • pour le tenant 1 pour les référentiels : contrat d’entrée, contrat d’accès, profil, profil de sécurité et contexte.

La liste des choix possibles, pour chaque tenant, est :

  • INGEST_CONTRACT : contrats d’entrée
  • ACCESS_CONTRACT : contrats d’accès
  • PROFILE : profils SEDA
  • SECURITY_PROFILE : profils de sécurité (utile seulement sur le tenant d’administration)
  • CONTEXT : contextes applicatifs (utile seulement sur le tenant d’administration)
  • ARCHIVE_UNIT_PROFILE : profils d’unités archivistiques

Note

se référer au métier pour ces choix.

Avertissement

Cette modification implique le redémarrage du/des composants (si mono-instance ou multi-instances du composant).

Prudence

En mode « esclave », il est fortement recommandé de faire débuter les référentiels avec d’autres chaînes de caractères que celle définies en mode « maître ».

Prudence

Ne pas oublier de répercuter cette modification sur le site secondaire

8.2.7.2.3. Paramétrage du batch de calcul pour l’indexation des règles héritées

La paramétrage du batch de calcul pour l’indexation des règles héritées peut être réalisé dans le fichier /group_vars/all/advanced/vitam_vars.yml.

La section suivante du fichier vitam_vars.yml permet de paramétrer la fréquence de passage du batch :

vitam_timers:
    metadata:
        - name: vitam-metadata-computed-inherited-rules
          frequency: "*-*-* 02:30:00"

La section suivante du fichier vitam_vars.yml permet de paramétrer la liste des tenants sur lequels s’exécute le batch :

vitam:
  worker:
        # api_output_index_tenants : permet d'indexer les règles de gestion, les chemins des règles et les services producteurs
        api_output_index_tenants: [0,1,2,3,4,5,6,7,8,9]
        # rules_index_tenants : permet d'indexer les règles de gestion
        rules_index_tenants: [0,1,2,3,4,5,6,7,8,9]

8.2.7.2.4. Configuration du Functional administration

functional-administration.conf : Fichier Yaml de configuration du server worker. Il possède une propriété :

  • listMinimumRuleDuration: la durée minimum de chaque type de règle par tenant
listMinimumRuleDuration:
  2:
    AppraisalRule : 1 year