Вызов API archcheck Java из командной строки с помощью программы archcheck

Программа archcheck представляет собой выполняемый класс в файле archcheck.jar для вызова API archcheck Java из командной строки. В случае проверки соединения HTTPS сначала нужно сконфигурировать аутентификацию сервера и (необязательно) аутентификацию клиента.

Процедура

  1. Если вы хотите проверить соединение HTTP, пропустите этот шаг и начните с шага 2. Если вы хотите проверить соединение HTTPS, нужно сконфигурировать аутентификацию сервера. Выполните следующие действия:
    1. Экспорт сертификата Collector Server в файл
    2. Импортируйте сертификат на склад доверенных сертификатов на компьютере, где нужно запустить программу archcheck. Используйте процедуру, описанную на шаге 2 Импорт сертификатов SAP на доверенный склад SSL.
    3. Если вы хотите проверить соединение HTTPS с аутентификацией клиента, выполните следующие дополнительные действия:
      1. Создайте сертификат для компьютера, где нужно запустить программу archcheck.
      2. Экспортируйте сертификат в файл. Используйте процедуру, описанную в разделе Экспорт сертификата Collector Server в файл.
      3. Импортируйте сертификат на склад доверенных сертификатов SSL на компьютере, где надо запустить Collector Server. Используйте процедуру, описанную на шаге 2 Импорт сертификатов SAP на доверенный склад SSL.
  2. Скопируйте файл archcheck.jar на компьютер, где вы хотите запустить программу archcheck.
  3. Если вы хотите проверить соединение HTTPS, можно сохранить пароли для склада доверенных сертификатов и (необязательно) для склада ключей в файле паролей. Создайте этот файл в каталоге по вашему выбору и задайте пароли в этом файле следующим образом:
    trustStorePassword=пароль_склада_доверенных_сертификатов
    keyStorePassword=пароль_склада_ключей

    пароль_склада_доверенных_сертификатов и пароль_склада_ключей - это пароли для склада доверенных сертификатов и для склада ключей. Все символы после знака равно считаются частью пароля, включая любые начальные и конечные пробелы.

    Если этот файл не создан, вам предложат ввести эти пароли. Пароли не показываются при их вводе.

  4. Откройте командную строку на компьютере, где работает программа archcheck.
  5. В зависимости от того, хотите ли вы проверить соединение HTTP или соединение HTTPS, введите соответствующую команду. Подробные описания этих команд смотрите в разделе archcheck.
  6. Файл журнала, куда записывается ход выполнения требования, генерируется автоматически в папке checkLogs каталога экземпляра Collector Server. У файла журнала следующее имя по умолчанию:
    id_архива_гггг_мм_дд_чч_мм_сс_мс.log

    Файл журнала создаётся каждый раз при запуске программы archcheck. Хронология файлов журнала полезна, например, если Collector Server не может больше соединиться с архивом, а вы хотите узнать, когда эта ошибка возникла впервые.

    Если вы предпочитаете записывать ход выполнения только последнего требования, добавьте следующий параметр в вашу команду:
    -log имя_файла

    имя_файла означает имя файла журнала. Путь к файлу журнала изменить нельзя.

    Файл журнала перезаписывается каждый раз при запуске программы archcheck.

Результаты

В случае успешного выполнения программы archcheck она возвращает код обработчика 0 и записывает на консоль следующее сообщение:
Требование тип_соединения для архива id_архива успешно обработано.

тип_соединения - это HTTP или HTTPS.

В случае неудачного выполнения программы archcheck она возвращает код обработчика больше 0 и записывает на консоль сообщение:
  • 1 Требование тип_соединения для архива id_архива обработано неудачно с кодом ответа номер: (текст).
  • 2 Требование тип_соединения для архива id_архива обработано неудачно. Требование было отправлено на Collector Server, но Collector Server не возвратил ответ.
  • 3 Требование тип_соединения для архива id_архива обработано неудачно. Не удалось установить соединение с Collector Server.
  • 4 Команда недопустима.
  • 5 Для этого кода обработчика никакие сообщения не выводятся. Вместо этого выводится версия и информация справки для команды archcheck.