Les services Synchronisation d'annuaire, Authentification utilisateur et Authentification Kerberos 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\Workspace ONE Access\servicename\logs. Par exemple, les fichiers journaux du service Synchronisation d'annuaire se trouvent dans le dossier INSTALL_DIR\Workspace ONE Access\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 INSTALL_DIR\Workspace ONE Access\servicename\servicename.xml contient des 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\Workspace ONE Access\Directory Sync Service\DirectorySyncService.xml 10 240 Ko 8
    DirectorySyncService.out.log INSTALL_DIR\Workspace ONE Access\Directory Sync Service\DirectorySyncService.xml 10 240 Ko 8
    UserAuthService.err.log INSTALL_DIR\Workspace ONE Access\User Auth Service\UserAuthService.xml 10 240 Ko 8
    UserAuthService.out.log INSTALL_DIR\Workspace ONE Access\User Auth Service\UserAuthService.xml 10 240 Ko 8
    KerberosAuthService.err.log INSTALL_DIR\Workspace ONE Access\Kerberos Auth Service\KerberosAuthService.xml 10 240 Ko 8
    KerberosAuthService.out.log INSTALL_DIR\Workspace ONE Access\Kerberos Auth Service\KerberosAuthService.xml 10 240 Ko 8
  • Le dossier INSTALL_DIR\Workspace ONE Access\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\Workspace ONE Access\Directory Sync Service\conf\log4j2-override.xml 50 Mo 5
    eds-vertx-access.log INSTALL_DIR\Workspace ONE Access\Directory Sync Service\conf\log4j2-override.xml 50 Mo 5
    eas-service.log INSTALL_DIR\Workspace ONE Access\User Auth Service\conf\log4j2-override.xml 50 Mo 5
    eas-vertx-access.log INSTALL_DIR\Workspace ONE Access\User Auth Service\conf\log4j2-override.xml 50 Mo 5
    eks-service.log INSTALL_DIR\Workspace ONE Access\Kerberos Auth Service\conf\log4j2-override.xml 50 Mo 5
    eks-vertx-access.log INSTALL_DIR\Workspace ONE Access\Kerberos Auth Service\conf\log4j2-override.xml 50 Mo 5
Note : Pour obtenir une description des fichiers journaux, reportez-vous à la section Accès aux fichiers journaux de Workspace ONE 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 Workspace ONE Access Connector.
  2. Pour modifier la taille ou le nombre des fichiers servicename.err.log et servicename.out.log, suivez ces étapes.
    1. Accédez au fichier INSTALL_DIR\Workspace ONE Access\servicename et ouvrez le fichier servicename.xml à des fins de modification. Pour le service Synchronisation d'annuaire, par exemple, modifiez le fichier INSTALL_DIR\Workspace ONE Access\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 de fichiers servicename-service.log et servicename-vertx-access.log d'un service, suivez les étapes suivantes.
    1. Accédez au dossier INSTALL_DIR\Workspace ONE Access\servicename\conf et modifiez le fichier log4j2-override.xml. Par exemple, pour le service Synchronisation d'annuaire, modifiez le fichier INSTALL_DIR\Workspace ONE Access\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>
      Note : La section <RollingFile name="fileLogger"… s'applique au fichier servicename-service.log et la section <RollingFile name="accessFileLogger"… s'applique au fichier servicename-vertx-access.log.
    3. Pour spécifier la taille et le nombre de fichiers servicename-service.log, dans la section <RollingFile name="fileLogger"… que vous avez ajoutée, modifiez les lignes suivantes :
      • <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, dans la section <RollingFile name="accessFileLogger"… que vous avez ajoutée, modifiez les lignes suivantes :
      • <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.