Службы синхронизации каталогов, проверки подлинности пользователей и проверки подлинности Kerberos создают файлы журналов, которые можно использовать для устранения неполадок. Если необходимо сохранить больше журналов, чем сохранено по умолчанию, можно увеличить размер файлов, а также количество файлов, созданных до запуска журналов в оборот.

Все файлы журналов службы сохраняются в папке INSTALL_DIR\Workspace ONE Access\servicename\logs. Например, файлы журналов для службы синхронизации каталогов расположены в папке INSTALL_DIR\Workspace ONE Access\Directory Sync Service\logs.

Как правило, возникает необходимость увеличить размер и количество файлов журналов servicename-service.log и servicename-vertx-access.log.

Настройки для файлов журналов содержатся в приведенных ниже XML-файлах.

  • Файл INSTALL_DIR\Workspace ONE Access\servicename\servicename.xml содержит настройки для файлов servicename.err.log и servicename.out.log.
    Файл журнала Файл настроек Размер по умолчанию Количество файлов, сохраняемых по умолчанию
    DirectorySyncService.err.log INSTALL_DIR\Workspace ONE Access\Directory Sync Service\DirectorySyncService.xml 10 240 КБ 8
    DirectorySyncService.out.log INSTALL_DIR\Workspace ONE Access\Directory Sync Service\DirectorySyncService.xml 10 240 КБ 8
    UserAuthService.err.log INSTALL_DIR\Workspace ONE Access\User Auth Service\UserAuthService.xml 10 240 КБ 8
    UserAuthService.out.log INSTALL_DIR\Workspace ONE Access\User Auth Service\UserAuthService.xml 10 240 КБ 8
    KerberosAuthService.err.log INSTALL_DIR\Workspace ONE Access\Kerberos Auth Service\KerberosAuthService.xml 10 240 КБ 8
    KerberosAuthService.out.log INSTALL_DIR\Workspace ONE Access\Kerberos Auth Service\KerberosAuthService.xml 10 240 КБ 8
  • Файл INSTALL_DIR\Workspace ONE Access\servicename\conf\log4j2-override.xml содержит настройки для файлов servicename-service.log и servicename-vertx-access.log.
    Файл журнала Файл настроек Размер по умолчанию Количество файлов, сохраняемых по умолчанию
    eds-service.log INSTALL_DIR\Workspace ONE Access\Directory Sync Service\conf\log4j2-override.xml 50 МБ 5
    eds-vertx-access.log INSTALL_DIR\Workspace ONE Access\Directory Sync Service\conf\log4j2-override.xml 50 МБ 5
    eas-service.log INSTALL_DIR\Workspace ONE Access\User Auth Service\conf\log4j2-override.xml 50 МБ 5
    eas-vertx-access.log INSTALL_DIR\Workspace ONE Access\User Auth Service\conf\log4j2-override.xml 50 МБ 5
    eks-service.log INSTALL_DIR\Workspace ONE Access\Kerberos Auth Service\conf\log4j2-override.xml 50 МБ 5
    eks-vertx-access.log INSTALL_DIR\Workspace ONE Access\Kerberos Auth Service\conf\log4j2-override.xml 50 МБ 5
Примечание: Описание файлов журналов см. в разделе Доступ к файлам журнала соединителя Workspace ONE Access Connector. На этой странице также содержатся сведения о включении режима DEBUG и окончаниях файлов журналов.

Процедура

  1. Войдите на сервер Workspace ONE Access Connector.
  2. Чтобы изменить размер или количество файлов servicename.err.log и servicename.out.log службы, выполните приведенные ниже действия.
    1. а. Перейдите в папку INSTALL_DIR\Workspace ONE Access\servicename и откройте файл servicename.xml для внесения изменений. Например, для службы синхронизации каталогов внесите изменения в файл INSTALL_DIR\Workspace ONE Access\Directory Sync Service\DirectorySyncService.xml.
    2. б. Найдите следующую запись:
         <log mode="roll-by-size">
              <sizeThreshold>10240</sizeThreshold>
              <keepFiles>8</keepFiles>
          </log>
    3. в. Обновите размер файла в записи <sizeThreshold> и измените количество файлов, которые нужно хранить в записи <keepFiles> в соответствии со своими требованиями.
    4. г. Сохраните файл.
  3. Чтобы увеличить размер и количество файлов servicename-service.log и servicename-vertx-access.log службы, выполните приведенные ниже действия.
    1. а. Перейдите в папку INSTALL_DIR\Workspace ONE Access\servicename\conf и внесите изменения в файл log4j2-override.xml. Например, для службы синхронизации каталогов внесите изменения в файл INSTALL_DIR\Workspace ONE Access\Directory Sync Service\conf\log4j2-override.xml.
    2. б. Добавьте следующие строки в строках <Configuration …> и </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>
      Примечание: Раздел <RollingFile name="fileLogger"… предназначен для файла servicename-service.log, а раздел <RollingFile name="accessFileLogger"… — для файла servicename-vertx-access.log.
    3. в. Чтобы указать размер и количество для файла servicename-service.log, в добавленном разделе <RollingFile name="fileLogger"… внесите изменения в следующие строки:
      • <SizeBasedTriggeringPolicy size="50 MB" />, чтобы указать размер файла в зависимости от своих требований;
      • <DefaultRolloverStrategy max="5"/>, чтобы указать количество сохраняемых файлов в зависимости от своих требований.
    4. г. Чтобы указать размер и количество для файла servicename-vertx-access.log, в добавленном разделе <RollingFile name="accessFileLogger"… внесите изменения в следующие строки:
      • <SizeBasedTriggeringPolicy size="50 MB" />, чтобы указать размер файла в зависимости от своих требований;
      • <DefaultRolloverStrategy max="5"/>, чтобы указать количество сохраняемых файлов в зависимости от своих требований.
    5. д. Сохраните файл.