Введение

Этот документ описывает как установить Axiom JDK на компьютеры под управлением Microsoft Windows, Linux и macOS. Тип установки, который вы выберете, зависит от ваших требований и платформы используемой вами.

Существует несколько вариантов дистрибутива Axiom JDK:

  • JDK Standard — дистрибутив для запуска, компиляции и отладки приложений или создания собственной среды выполнения Java с подмножеством модулей Java;

  • JDK Full — включает JavaFX и расширенный набор виртуальных машин;

  • JDK Lite — компактный, но полнофункциональный дистрибутив JDK;

  • JRE Standard — дистрибутив для запуска Java-приложений;

  • JRE Full — включает JavaFX и расширенный набор виртуальных машин для запуска Java-приложений.

Вы можете загрузить Axiom JDK либо из Центра загрузок Axiom JDK, либо по ссылке на портале поддержки. Доступ к этому порталу предоставляется клиентам с активным договором поддержки. После входа на портал поддержки, если у вас есть несколько активных проектов, выберите нужный проект из выпадающего списка “Выберите проект” вверху страницы под именем пользователя. В зависимости от выбранного проекта вам будет доступна прямая ссылка на запрошенную вами версию продукта в разделе “Технологии”. Если вы используете страницу центра загрузки Axiom JDK, прокрутите вниз и выберите ОС, тип пакета и вариант дистрибутива (JDK/JRE). После завершения загрузки вы можете проверить загруженный файл, сравнив его размер на вашем диске с размером на странице загрузок.

Вы также можете использовать командную строку для загрузки необходимых пакетов установки, как описано далее в этом документе.

Далее следуют инструкции по установке для каждой ОС. Обратите внимание, что Axiom JDK используется во всех приведенных ниже примерах, но при необходимости вы можете заменить его на Axiom JRE.

Microsoft Windows

Установка Axiom JDK с помощью MSI-инсталлятора

Для установки Axiom JDK с помощью файла инсталлятора выполните следующие действия:

  1. Найдите и дважды кликните по скаченному exe или msi-файлу инсталлятора.

  2. Следуйте инструкциям на экране окна инсталлятора.

    Окно установщика

  3. После завершения установки нажмите “Finish”, чтобы выйти из мастера установки Axiom JDK.

Приведенные примеры экранов установщика могут различаться в разных версиях.

Автоматическая установка с использованием MSI-инсталлятора

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

msiexec /i axiomjdk-jdk-pro8u402+7-windows-amd64.msi /qn /quiet /norestart /l*v "Axiom_install.log"

Описание использованных опций:

  • /i - установить указанное ПО;

  • /qn - без пользовательского интерфейса;

  • /quiet - тихий режим без вмешательства пользователя;

  • /norestart - не перезагружать компьютер после завершения установки;

  • /l*v "Axiom_install.log" - подробная регистрация всех сообщений в указанный файл журнала.

Чтобы просмотреть список флагов и параметров установки, запустите msiexec /help из командной строки.

Используйте учетную запись администратора для запуска установки в автоматическом режиме.

Установка Axiom JDK из архива через PowerShell

  1. Чтобы установить Axiom JDK как отдельный пакет на свой компьютер, загрузите файл пакета .zip и распакуйте его в папку. Вы также можете использовать Windows PowerShell для загрузки и распаковки ZIP-файла следующим образом:

    Invoke-WebRequest "https://download.axiomjdk.ru/axiomjdk-pro/8u402+7/axiomjdk-jdk-pro8u402+7-windows-amd64.zip"
    Expand-Archive axiomjdk-jdk-pro8u402+7-windows-amd64.zip -DestinationPath .
    

    Приведенные выше команды загружают архив из общедоступного домена BELLSOFT и распаковывают Axiom JDK в текущий каталог. Если вы являетесь клиентом с активным договором поддержки, войдите на портал поддержки, скопируйте ссылку на продукт Axiom JDK в разделе “Технологии” и вставьте эту ссылку в команду Invoke-WebRequest выше.

  2. Добавьте путь к <каталог установки Axiom JDK>/bin в PATH и <каталог установки Axiom JDK> в переменные среды JAVA_HOME следующим образом.

    1. В поисковой строке меню «Пуск» введите env и выберите пункт Edit the system environment variables.

    2. Кликните по кнопке Environment Variables…​.

    3. В нижней части окна под секцией System Variables, найдите строку со значением Path в первом столбце. Затем нажмите кнопку Edit.

    4. В окне Edit environment variable нажмите кнопку New и введите путь к подкаталогу /bin, например:

      C:/axiomjdk8/bin/
      

      В данном окне можно также отредактировать или упорядочить пути. Нажмите OK, когда закончите.

    5. Выберите строку ‘JAVA_HOME’ в System variables и нажмите Edit.

    6. Удалите текущее значение переменной и введите путь к каталогу установки <Axiom JDK>. Обратите внимание: если у вас нет переменной JAVA_HOME, нажмите New в разделе System variables введите JAVA_HOME в качестве имени переменной в поле Variable name и введите путь в Variable value.

    7. Нажмите ОК в открытых диалоговых окнах, чтобы сохранить изменения.

После применения изменений в настройке переменных окружения возможно потребуется перезапуск приложений (например, приложения PoweShell). Рекомендуется перезагрузить всю операционную систему, чтобы гарантировать, что все приложения запустились с новым значением переменной окружения PATH. Для проверки текущего значения переменной окружения PATH выполните следующую команду в PowerShell:

$env:PATH

Чтобы запустить ваше приложение, используйте следующую команду:

java -jar <имя_приложения>.jar

Проверка корректности установки

Чтобы проверить правильно ли установлена Axiom JDK, откройте интерфейс командной строки, например PowerShell или cmd, и выполните следующую команду:

java -version

При необходимости укажите полный путь к исполняемому файлу Java. Пример:

C:\Program Files\BellSoft\AxiomJDK8\bin\java -version

В консоли должна отобразиться информация о текущей версии JDK, похожая на следующую:

openjdk version "1.8.0_402"
OpenJDK Runtime Environment (build 1.8.0_402-b07)
OpenJDK 64-Bit Server VM (build 25.402-b07, mixed mode)

Удаление Axiom JDK

Установщик Windows

Для деинсталляции Axiom JDK удалите продукт через стандартный механизм деинсталляции Windows.

Установка из zip

Если использовалась установка из zip, удалите директорию размещения Axiom JDK и измените значение связанных переменных окружения.

Apple macOS

Установка Axiom JDK

Выполните следующие действия, чтобы установить Axiom JDK:

  1. Запустите программу установки, дважды щелкнув загруженный файл .dmg.

  2. Дважды щелкните значок Install Axiom JDK pkg, чтобы запустить мастер установки.

    Установочный файл Axiom JDK

  3. Нажмите ‘Continue’ на экране приветствия.

  4. Нажмите ‘Install’ чтобы продолжить установку по умолчанию.

    Тип установке

    При желании вы можете изменить место установки, нажав ‘Change Install Location’ на экране Installation Type и выбрав место для установки Axiom JDK.

    Если вы решили изменить место установки, выберите диск и нажмите ‘Continue’.

  5. Подтвердите установку нового программного обеспечения. Копирование файла начинается немедленно.

    Ввод аутентификационной информации

  6. Наблюдайте за ходом установки.

  7. После завершения установки нажмите ‘Close’, чтобы выйти из мастера установки.

Установка пакета из архива

Чтобы установить Axiom JDK как отдельный пакет, загрузите ZIP-файл и распакуйте его, как показано в следующем примере.

wget https://download.axiomjdk.ru/axiomjdk-pro/8u402+7/axiomjdk-jdk-pro8u402+7-macos-amd64.zip
unzip axiomjdk-jdk-pro8u402+7-macos-amd64.zip

Приведенные выше команды загружают архив из общедоступного домена BELLSOFT и распаковывают Axiom JDK в текущий каталог. Если вы являетесь клиентом с активным договором поддержки, войдите на портал поддержки, скопируйте ссылку на продукт Axiom JDK в разделе “Технологии” и вставьте эту ссылку в команду wget выше.

Включите путь к подкаталогу установки <Axiom JDK>/bin при запуске приложения Java, как показано в следующем примере:

/Library/Java/JavaVirtualMachines/axiomjdk-jdk-1.8.0_402.jdk/bin/java -jar <имя_приложения>.jar

Вы можете добавить подкаталог <каталог установки Axiom JDK>/bin в $PATH и <каталог установки Axiom JDK> в переменные среды JAVA_HOME для текущего сеанса терминала, если это необходимо.

export PATH=<каталог установки Axiom JDK>/bin:$PATH
export JAVA_HOME=<каталог установки Axiom JDK>

Теперь вы можете запускать Axiom JDK следующим образом.

java -jar <имя_приложения>.jar

Проверка корректности установки

Чтобы проверить правильно ли установлена Axiom JDK, откройте терминал и выполните следующую команду:

java -version

В терминале должна отобразиться информация о текущей версии JDK, похожая на следующую:

openjdk version "1.8.0_402"
OpenJDK Runtime Environment (build 1.8.0_402-b07)
OpenJDK 64-Bit Server VM (build 25.402-b07, mixed mode)

Удаление Axiom JDK

Установщик пакетов

Чтобы удалить Axiom JDK с помощью установщика пакетов, выполните следующие действия:

  1. Запустите программу установки, дважды щелкнув загруженный файл .dmg.

  2. Дважды щелкните значок Uninstall Axiom.app.

    Состав установочного пакета

  3. Нажмите ‘Continue’ на экране приветствия.

    Деинсталлятор Axiom JDK

  4. Выберите установку Axiom JDK, которую хотите удалить, и нажмите Continue.

  5. При необходимости укажите информацию для аутентификации и нажмите OK. После завершения удаления нажмите ‘Exit’, чтобы выйти из мастера установки.

Командная строка

Чтобы удалить приложение Axiom JDK с помощью терминала, выполните следующие действия (при условии, что вы установили Axiom JDK, используя расположение по умолчанию на загрузочном томе (/)).

  • Чтобы удалить Axiom JRE, выполните в терминале следующие команды:

    sudo pkgutil --volume / --forget com.axiomjdk.jre.1.8.0_402
    sudo rm -rf /Library/Java/JavaVirtualMachines/axiomjdk-jre-1.8.0_402.jre
    
  • Чтобы удалить Axiom JDK, выполните в терминале следующие команды:

    sudo pkgutil --volume / --forget com.axiomjdk.jdk.1.8.0_402
    sudo rm -rf /Library/Java/JavaVirtualMachines/axiomjdk-jdk-1.8.0_402.jdk
    

Для версий lite или full добавьте к имени -lite или -full соответственно, например axiomjdk-jdk-1.8.0_402-full.jdk.

Установка из архива

Чтобы удалить отдельный пакет Axiom JDK, удалите его каталог. Связанные переменные среды, установленные с помощью команды export, действительны только для текущего сеанса терминала, и они автоматически удаляются после закрытия терминала.

Linux

В большинстве версий Linux вы можете установить новое программное обеспечение, используя репозиторий, который представляет собой место хранения, размещенное на удаленных серверах, откуда система скачивает и устанавливает программное обеспечение и обновления. Если репозиторий недоступен или по каким-то другим причинам, вы можете загрузить и установить новое программное обеспечение вручную.

Установка вручную

Команды, приведенные в примерах ниже, загружают архив из общедоступного домена BELLSOFT. Если вы являетесь клиентом с активным договором поддержки, войдите на портал поддержки, скопируйте ссылку на продукт Axiom JDK в разделе “Технологии” и вставьте эту ссылку в команду wget.

Alpine Linux

Чтобы установить Axiom JDK, загрузите файл .apk и установите его с помощью следующих команд в терминале.

  1. Загрузите файл .apk с помощью следующей команды в терминале.

    wget https://download.axiomjdk.ru/axiomjdk-pro/8u402+7/axiomjdk-jdk-pro8u402+7-linux-x64-musl.apk
    

    Или откройте страницу загрузок в браузере, прокрутите вниз и загрузите нужный пакет.

  2. Установите официальный ключ BELLSOFT, как показано в следующем примере.

    sudo wget -P /etc/apk/keys/ https://apk.axiomjdk.ru/info@bell-sw.com5fea454e.rsa.pub
    
  3. Установите пакет как показано ниже.

    apk add axiomjdk-jdk-pro8u402+7-linux-x64-musl.apk
    

Чтобы запустить ваше приложение, используйте следующую команду:

java -jar <имя_приложения>.jar

Ubuntu и другие ОС на базе DEB

Чтобы установить Axiom JDK, загрузите файл .deb и установите его с помощью следующей команды в терминале.

wget https://download.axiomjdk.ru/axiomjdk-pro/8u402+7/axiomjdk-jdk-pro8u402+7-linux-amd64.deb
sudo apt install ./axiomjdk-jdk-pro8u402+7-linux-amd64.deb

Чтобы запустить ваше приложение, используйте следующую команду:

java -jar <имя_приложения>.jar

Эта команда автоматически включает зависимости JavaFX или DeviceIO, если они скомпилированы в JDK.

Red Hat Linux и другие ОС на основе RPM, использующие менеджер пакетов yum

Чтобы установить Axiom JDK, загрузите файл .rpm и запустите инструмент yum, как показано в следующем примере.

wget https://download.axiomjdk.ru/axiomjdk-pro/8u402+7/axiomjdk-jdk-pro8u402+7-linux-amd64.rpm
sudo yum install ./axiomjdk-jdk-pro8u402+7-linux-amd64.rpm

Приведенные выше команды устанавливают пакет Axiom JDK 8, включая JavaFX.

Чтобы запустить ваше приложение, используйте следующую команду:

java -jar <имя_приложения>.jar

Эта команда автоматически включает зависимости JavaFX или DeviceIO, если они скомпилированы в JDK.

Ручная установка пакета RPM

  1. Получите официальный GPG-ключ BELLSOFT, а затем импортируйте его, как показано в следующем примере. Добавление ключа GPG требуется только один раз на компьютере.

    wget -q -O - https://download.axiomjdk.ru/pki/GPG-KEY-axiom
    sudo rpm --import GPG-KEY-axiom
    
  2. Загрузите пакет с помощью команды «wget» и установите его как показано ниже.

    wget https://download.axiomjdk.ru/axiomjdk-pro/8u402+7/axiomjdk-jdk-pro8u402+7-linux-amd64.rpm
    sudo rpm --install axiomjdk-jdk-pro8u402+7-linux-amd64.rpm
    

Чтобы запустить ваше приложение, используйте следующую команду:

java -jar <имя_приложения>.jar

Установка отдельного пакета JDK из архива в GNU/Linux

Чтобы установить Axiom JDK, загрузите файл .tar.gz и распакуйте его следующим образом.

wget https://download.axiomjdk.ru/axiomjdk-pro/8u402+7/axiomjdk-jdk-pro8u402+7-linux-amd64.tar.gz
tar -zxf axiomjdk-jdk-pro8u402+7-linux-amd64.tar.gz

Приведенные выше команды распаковывают Axiom JDK в текущий каталог. Чтобы запустить приложение Java, используйте следующую команду:

<каталог установки Axiom JDK>/bin/java -jar <имя_приложения>.jar

Вы можете добавить подкаталог <каталог установки Axiom>/bin в $PATH и <каталог установки Axiom JDK> в переменные среды JAVA_HOME для текущего сеанса терминала, если это необходимо.

export PATH=<каталог установки Axiom JDK>/bin:$PATH
export JAVA_HOME=<каталог установки Axiom JDK>

Теперь вы можете запускать Axiom JDK следующим образом.

java -jar <имя_приложения>.jar

Проверка корректности установки

Чтобы проверить правильно ли установлена Axiom JDK, откройте терминал и выполните следующую команду:

java -version

В терминале должна отобразиться информация о текущей версии JDK, похожая на следующую:

openjdk version "1.8.0_402"
OpenJDK Runtime Environment (build 1.8.0_402-b07)
OpenJDK 64-Bit Server VM (build 25.402-b07, mixed mode)

Удаление Axiom JDK

Alpine Linux

Выполните следующую команду.

sudo apk del <axiomjdk-package-name>

Ubuntu and other DEB-based OS’s

Выполните следующую команду.

sudo apt remove <axiomjdk-package-name>

Red Hat Linux and other RPM-based OS’s

Выполните следующую команду.

sudo yum remove <axiomjdk-package-name>

Удаление установленных вручную самостоятельных пакетов

Чтобы удалить отдельный пакет Axiom JDK, удалите его каталог. Связанные переменные среды, установленные с помощью команды export, действительны только для текущего сеанса терминала, и они автоматически удаляются после закрытия терминала.

Solaris

Установка отдельного пакета в Solaris

Чтобы установить Axiom JDK, загрузите файл .tar.gz и распакуйте его следующим образом.

wget https://download.axiomjdk.ru/axiomjdk-pro/8u402+7/axiomjdk-jdk-pro8u402+7-solaris-x64.tar.gz
tar -zxf axiomjdk-jdk-pro8u402+7-solaris-x64.tar.gz

Приведенные выше команды распаковывают Axiom JDK в текущий каталог. Чтобы запустить приложение Java, используйте следующую команду:

<каталог установки Axiom JDK>/bin/java -jar <имя_приложения>.jar

Удаление Axiom JDK

Чтобы удалить Axiom JDK, удалите его каталог.

Проверка загруженных файлов

Мы рекомендуем всегда проверять загруженный установочный файл, сравнив его размер на вашем диске с размером на странице Центр загрузок Axiom JDK.

Более продвинутый подход — получить контрольную сумму загруженного файла в интерфейсе командной строки и сравнить ее с той, которую вы можете найти рядом со ссылкой на установочный файл Axiom JDK на странице Центр загрузок Axiom JDK. Ниже приведены команды для получения контрольной суммы для каждой ОС.

Windows

Чтобы получить контрольную сумму загруженного файла в командной строке, выполните следующую команду в Windows PowerShell. Чтобы запустить PowerShell, откройте меню Пуск или нажмите клавишу Windows + R, введите powershell в диалоговом окне Run и нажмите ОК.

(Get-FileHash .\axiomjdk-jdk-pro8u402+7-windows-amd64.msi -Algorithm SHA1).Hash

Apple macOS

Чтобы получить контрольную сумму загруженного файла, используйте следующую команду.

shasum -a 1 axiomjdk-jdk-pro8u402+7-macos-amd64.dmg

Linux

Чтобы получить контрольную сумму загруженного файла, используйте следующую команду. Расширение установочного файла зависит от версии Linux.

shasum -a 1 axiomjdk-jdk-pro8u402+7-linux-amd64.apk

Устранение неполадок

В этом разделе содержатся инструкции по устранению некоторых наиболее распространенных проблем при установке.

Проверка системных требований

Код Java может работать на ряде платформ с использованием разных компиляторов и инструментов сборки. Мы рекомендуем проверить совместимость вашей системы и требования на странице Поддерживаемые системные конфигурации перед установкой продукта Axiom.

Предупреждения от Microsoft Defender SmartScreen

Для обеспечения безопасности компьютера пользователя фильтр SmartScreen от Microsoft Defender иногда предотвращает запуск загруженных файлов и выдает предупреждения при установке программного обеспечения.

Если фильтр SmartScreen не позволяет установить продукт Axiom JDK и отображает сообщение, подобное приведенному ниже, следуйте инструкциям в этом разделе.

Предупреждения SmartScreen от Microsoft Defender

  1. Проверьте загруженный установочный файл Axiom, как описано в главе Проверка загруженных файлов.

  2. Убедитесь, что установочный файл подписан BELLSOFT, проверив сведения о цифровых подписях в свойствах установочного файла в разделе Digital Signatures.

    Цифровая подпись установочного файла

  3. В зависимости от результатов проверки в пунктах 1 и 2 выполните следующие действия:

    • Если размер и контрольная сумма загруженного файла совпадают с указанными на странице Центр загрузок Axiom JDK и файл подписан BELLSOFT, нажмите More info в окне Microsoft Defender SmartScreen, а затем нажмите Run anyway.

    • Если какая-либо информация неверна, удалите файл и снова загрузите установочный файл.

Загрузка Axiom JDK с помощью браузера

Если ваш браузер не позволяет загрузить установочный файл Axiom JDK, нажмите More actions (три точки или стрелка) рядом с загруженным файлом и, в зависимости от браузера, выберите Keep или Download, чтобы сохранить файл.

Автоматическая установка в Windows

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

Error 1925. You do not have sufficient privileges to complete this installation for all users of the machine. Log on as administrator and then retry this installation.

Используйте учетную запись администратора для запуска автоматической установки.

Возврат к предыдущей версии продукта Axiom JDK в Windows

Мы не рекомендуем устанавливать предыдущие версии продуктов Axiom JDK, так как они могут содержать проблемы безопасности, решенные в последнем релизе.

Если у вас установлена последняя версия продукта Axiom JDK и вам необходимо установить предыдущую версию точно такого же продукта, сначала удалите текущую версию, а затем установите нужную версию.

Внеэкранный рендеринг

В системах Linux контейнерные развертывания иногда выполняют отрисовку вне экрана (off-screen rendering), например при подготовке документов, форм и изображений. При выполнении внеэкранного рендеринга JDK требует установки шрифтов ОС и библиотек fontconfig. Если у вас нет этих библиотек или шрифтов, вы можете столкнуться с ошибкой, подобной приведенной ниже:

    Exception in thread "main" java.lang.InternalError: java.lang.reflect.InvocationTargetException
sun.font.fontmanager: sun.awt.X11FontManager
Exception in thread "main" java.lang.Error: Probable fatal error:No fonts found.
    at sun.font.SunFontManager.getDefaultPhysicalFont(SunFontManager.java:1246)
    at sun.font.SunFontManager.initialiseDeferredFont(SunFontManager.java:1110)
    at sun.font.SunFontManager.findOtherDeferredFont(SunFontManager.java:1047)
    at sun.font.SunFontManager.findDeferredFont(SunFontManager.java:1064)
    at sun.font.SunFontManager.findFont2D(SunFontManager.java:2266)

В системах Linux эти библиотеки предоставляются пакетами fontconfig и font, и, в зависимости от типа Linux, их можно установить, выполнив одну из следующих команд.

  • Alpine Linux: apk add fontconfig ttf-dejavu

  • Ubuntu: apt install fontconfig fonts-dejavu

  • Fedora: yum install fontconfig dejavu-sans-fonts dejavu-serif-fonts

  • Suse: zypper install fontconfig dejavu-fonts

Чтобы использовать внеэкранный рендеринг в JDK без установки пакета fontconfig, сделайте следующее:

  • Установите или скопируйте необходимые шрифты в систему.

  • Убедитесь, что каталог <jdk8u>/jre/lib содержит соответствующие двоичные и исходные файлы конфигурации fontconfig.OS.[bfc|properties.src] fontconfig.

  • Убедитесь, что исходный файл конфигурации fontconfig содержит правильные пути к шрифтам, установленным в системе.

Axiom JDK 8 содержит предопределенные файлы fontconfig.OS.[bfc|properties.src] для Ubuntu, Fedora, Suse и Alpine Linux. Если ваша система отличается от указанных выше, возьмите один из файлов fontconfig.OS.properties.src в качестве шаблона, скопируйте его в файл fontconfig.properties и обновите пути шрифтов в файле в соответствии с путями на вашей системе.

Дополнительные сведения см. в документе Font Configuration Files на веб-сайте Oracle.

Обратно на страницу загрузки
Команда Axiom JDK roman.karpov@axiomjdk.ru Команда Axiom JDK logo Axiom Committed to Freedom 199 Obvodnogo Kanala Emb. 190020 St. Petersburg RU +7 812-336-35-67 Команда Axiom JDK 199 Obvodnogo Kanala Emb. 190020 St. Petersburg RU +7 812-336-35-67