Augmentation de la taille et du nombre de fichiers journaux d'Omnissa Access Connector

Les services de synchronisation d'annuaire, d'authentification utilisateur, d'authentification Kerberos et d'applications virtuelles créent chacun des fichiers journaux que vous pouvez utiliser pour résoudre des problèmes. Si vous souhaitez enregistrer plus de journaux que ceux enregistrés par défaut, vous pouvez augmenter la taille des fichiers ainsi que le nombre de fichiers créés avant la rotation des journaux.

Tous les fichiers journaux d'un service sont enregistrés dans le dossier INSTALL_DIR\Access Connector\servicename\logs. Par exemple, les fichiers journaux du service de synchronisation d'annuaire se trouvent dans le dossier INSTALL_DIR\Access Connector\Directory Sync Service\logs.

Généralement, les fichiers journaux pour lesquels vous devrez augmenter la taille et le nombre sont les fichiers servicename-service.log et servicename-vertx-access.log.

Les fichiers XML suivants contiennent les paramètres des fichiers journaux :

• Le fichier The INSTALL_DIR\Access Connector\servicename\servicename.xml contient les paramètres des fichiers servicename.err.log et servicename.out.log.

  Fichier journal	Fichier de paramètres	Taille par défaut	Nombre de fichiers par défaut enregistrés
  DirectorySyncService.err.log	INSTALL_DIR\Access Connector\Directory Sync Service\DirectorySyncService.xml	10 240 Ko	8
  DirectorySyncService.out.log	INSTALL_DIR\Access Connector\Directory Sync Service\DirectorySyncService.xml	10 240 Ko	8
  UserAuthService.err.log	INSTALL_DIR\Access Connector\User Auth Service\UserAuthService.xml	10 240 Ko	8
  UserAuthService.out.log	INSTALL_DIR\Access Connector\User Auth Service\UserAuthService.xml	10 240 Ko	8
  KerberosAuthService.err.log	INSTALL_DIR\Access Connector\Kerberos Auth Service\KerberosAuthService.xml	10 240 Ko	8
  KerberosAuthService.out.log	INSTALL_DIR\Access Connector\Kerberos Auth Service\KerberosAuthService.xml	10 240 Ko	8
  VirtualAppService.err.log	INSTALL_DIR\Access Connector\Virtual App Service\VirtualAppService.xml	10 240 Ko	8
  VirtualAppService.out.log	INSTALL_DIR\Access Connector\Virtual App Service\VirtualAppService.xml	10 240 Ko	8

• INSTALL_DIR\Access Connector\servicename\conf\log4j2-override.xml contient les paramètres des fichiers servicename-service.log et servicename-vertx-access.log.

  Fichier journal	Fichier de paramètres	Taille par défaut	Nombre de fichiers par défaut enregistrés
  eds-service.log	INSTALL_DIR\Access Connector\Directory Sync Service\conf\log4j2-override.xml	50 Mo	5
  eds-vertx-access.log	INSTALL_DIR\Access Connector\Directory Sync Service\conf\log4j2-override.xml	50 Mo	5
  eas-service.log	INSTALL_DIR\Access Connector\User Auth Service\conf\log4j2-override.xml	50 Mo	5
  eas-vertx-access.log	INSTALL_DIR\Access Connector\User Auth Service\conf\log4j2-override.xml	50 Mo	5
  eks-service.log	INSTALL_DIR\Access Connector\Kerberos Auth Service\conf\log4j2-override.xml	50 Mo	5
  eks-vertx-access.log	INSTALL_DIR\Access Connector\Kerberos Auth Service\conf\log4j2-override.xml	50 Mo	5
  eis-service.log	INSTALL_DIR\Access Connector\Virtual App Service\conf\log4j2-override.xml	50 Mo	5
  eis-vertx-access.log	INSTALL_DIR\Access Connector\Virtual App Service\conf\log4j2-override.xml	50 Mo	5

Remarque : pour obtenir une description des fichiers journaux, reportez-vous la section Accès aux fichiers journaux d'Omnissa Access Connector. Cette page fournit également des informations sur l'activation du mode DEBUG et de l'examen des fichiers journaux.

Procédure

1. Connectez-vous au serveur d'Omnissa Access Connector.

2. Pour modifier la taille ou le nombre des fichiers servicename.err.log et servicename.out.log d'un service, procédez comme suit.

   1. Accédez au dossier INSTALL_DIR\Access Connector\servicename et ouvrez le fichier servicename.xml pour le modifier. Par exemple, pour le service de synchronisation d'annuaire, modifiez le fichier INSTALL_DIR\Access Connector\Directory Sync Service\DirectorySyncService.xml.

   2. Localisez l'entrée suivante :

         <log mode="roll-by-size">
              <sizeThreshold>10240</sizeThreshold>
              <keepFiles>8</keepFiles>
          </log>
      

   3. Mettez à jour la taille des fichiers dans l'entrée <sizeThreshold> et le nombre de fichiers à conserver dans l'entrée <keepFiles> selon la configuration requise.

   4. Enregistrez le fichier.

3. Pour augmenter la taille et le nombre des fichiers servicename-service.log et servicename-vertx-access.log d'un service, procédez comme suit.

   1. Accédez au dossier INSTALL_DIR\Access Connector\servicename\conf et modifiez le fichier log4j2-override.xml. Par exemple, pour le service de synchronisation d'annuaire, modifiez le fichier INSTALL_DIR\Access Connector\Directory Sync Service\conf\log4j2-override.xml.

   2. Ajoutez les lignes suivantes dans les lignes <Configuration …> et </Configuration> :

      <Appenders>
      <RollingFile name="fileLogger" fileName="${logFilePathAndNamePrefix}.log"
      filePattern="${logFilePathAndNamePrefix}-%i.log">
      
      <PatternLayout pattern="${defaultLayout}" />
      
      <Policies>
      <SizeBasedTriggeringPolicy size="50 MB" />
      </Policies>
      <DefaultRolloverStrategy max="5"/>
      </RollingFile>
      
      <!-- Rolling file appender, used by vertx access log -->
      <RollingFile name="accessFileLogger" fileName="${accessLogFilePathAndNamePrefix}.log"
      filePattern="${accessLogFilePathAndNamePrefix}-%i.log">
      
      <PatternLayout pattern="${accessLogLayout}" />
      
      <Policies>
      <SizeBasedTriggeringPolicy size="50 MB" />
      </Policies>
      <DefaultRolloverStrategy max="5"/>
      </RollingFile>
      </Appenders>
      

      Remarque : la section <RollingFile name="fileLogger"… concerne le fichier servicename-service.log et la section <RollingFile name="accessFileLogger"… est destinée au fichier servicename-vertx-access.log.

   3. Pour spécifier la taille et le nombre de fichiers servicename-service.log, modifiez les lignes suivantes dans la section <RollingFile name="fileLogger"… que vous avez ajoutée :

      • <SizeBasedTriggeringPolicy size="50 MB" /> pour spécifier la taille du fichier selon la configuration requise
      • <DefaultRolloverStrategy max="5"/> pour spécifier le nombre de fichiers à conserver selon la configuration requise

   4. Pour spécifier la taille et le nombre de fichiers servicename-vertx-access.log, modifiez les lignes suivantes dans la section <RollingFile name="accessFileLogger"… que vous avez ajoutée :

      • <SizeBasedTriggeringPolicy size="50 MB" /> pour spécifier la taille du fichier selon la configuration requise
      • <DefaultRolloverStrategy max="5"/> pour spécifier le nombre de fichiers à conserver selon la configuration requise

   5. Enregistrez le fichier.