Администрирование приложений с помощью терминала
improve this page | report issueОбзор
Для администрирования приложений MobileFirst можно использовать программу mfpadm.
SDK IBM Mobile Foundation версии выше 8.0.0.0-MFPF-IF201701250919 предлагают обновленную поддержку проверки подлинности приложений: с помощью команд
mfpadm
можно переключаться междудинамическим
истатическим
режимами проверки и сбросить проверку.Перейдите в установочный каталог IBM Mobile Foundation
/MobilefirstPlatformServer/shortcuts
и выполните командыmfpadm
.
- Для переключения между типами проверки:
mfpadm --url= --user= --passwordfile= --secure=false app version [RUNTIME] [APPNAME] [ENVIRONMENT] [VERSION] set authenticity-validation TYPE
Value for TYPE can be
static
ordynamic
Пример для Android: здесь указывается
динамический
тип проверки.mfpadm --url=http://localhost:8080/mfpadmin --user=admin --passwordfile="C:\userhome\mfppassword\MFP_password.txt" --secure=false app version mfp test android 1.0 set authenticity-validation dynamic
- Для сбора данных с помощью следующей команды, которая очищает идентификационный код приложения.
mfpadm --url= --user= --passwordfile= --secure=false app version [RUNTIME] [APPNAME] [ENVIRONMENT] [VERSION] reset authenticity
Пример:
mfpadm --url=http://localhost:8080/mfpadmin --user=admin --passwordfile="C:\userhome\mfppassword\MFP_password.txt" --secure=false app version mfp sample.com.pincodeandroid android 1.0 reset authenticity
Перейти на
Сравнение с другими средствами
Операции администрирования в IBM Mobile Foundation можно выполнять следующими способами:
- MobileFirst Operations Console (интерактивный режим).
- Задача Ant mfpadm.
- Программа mfpadm.
- Службы REST администрирования MobileFirst.
Задача Ant mfpadm, программа mfpadm и службы REST оптимальным образом подходят для автоматизации операций, включая следующие сценарии:
- Устранение ошибок оператора в повторяющихся операциях
- Обеспечение работы, когда оператора нет на рабочем месте
- Настройка рабочего сервера в соответствии с конфигурацией тестового или промежуточного сервера.
Программа mfpadm и задача Ant mfpadm отличаются большей простотой использования и более удобными средствами создания отчетов об ошибках по сравнению со службами REST. Преимущество программы mfpadm над задачей Ant mfpadm заключается в том, что ее проще интегрировать с командами операционной системы. Более того, она лучше подходит для работы в интерактивном режиме.
Предварительные требования
Инструмент mfpadm устанавливается программой установки MobileFirst Server. Далее на этой странице product_install_dir
- это установочный каталог программы установки MobileFirst Server.
Команда mfpadm расположена в каталоге product_install_dir/shortcuts/ в виде набора сценариев:
- mfpadm для UNIX / Linux
- mfpadm.bat для Windows
Сценарии готовы к работе и не требуют настройки каких-либо переменных среды. Если
задана переменная среды JAVA_HOME, сценарии принимают
ее.
Для применения программы mfpadm добавьте каталог
product_install_dir/shortcuts/ в переменную среды PATH или
указывайте полное имя файла в каждом вызове.
Дополнительная информация о работе с программой установки MobileFirst Server приведена в разделе Запуск IBM Installation Manager.
Перейти к
- Вызов программы mfpadm
- Команды для общей настройки
- Команды для адаптеров
- Команды для приложений
- Команды для устройств
- Команды для устранения неполадок
Вызов программы mfpadm
С помощью программы mfpadm можно администрировать приложения MobileFirst.
Синтаксис
Вызов программы mfpadm выглядит следующим образом:
mfpadm --url= --user= ... [--passwordfile=...] [--secure=false] команда
Программа mfpadm имеет следующие параметры:
Параметр | Тип | Описание | Требуется | По умолчанию | |
---|---|---|---|---|---|
–url | URL | Base URL of the MobileFirst web application for administration services | Yes | ||
–secure | Boolean | Whether to avoid operations with security risks | No | true | |
–user | name | User name for accessing the MobileFirst admin services | Yes | ||
–passwordfile | file | File containing the password for the user | No | ||
–timeout | Number | Timeout for the entire REST service access, in seconds | No | ||
–connect-timeout | Number | Timeout for establishing a network connection, in seconds | No | ||
–socket-timeout | Number | Timeout for detecting the loss of a network connection, in seconds | No | ||
–connection-request-timeout | Number Timeout for obtaining an entry from a connection request pool, in seconds | No | |||
–lock-timeout | Number | Timeout for acquiring a lock, in seconds | No | 2 | |
–verbose | Detailed output | No |
url
В URL рекомендуется использовать протокол HTTPS. Например, если применяются порты и
корневые контексты по умолчанию, укажите следующий URL:
- Для WebSphere Application Server: https://server:9443/mfpadmin
- Для Tomcat: https://server:8443/mfpadmin
secure
По умолчанию параметр --secure
содержит значение true. Параметр --secure=false
может вызвать следующие эффекты:
- Имя пользователя и пароль могут передаваться в незащищенном виде (даже по соединениям HTTP).
- Сертификаты SSL сервера принимаются даже в том случае, если они являются собственными или созданы для другого имени хоста.
password
Укажите пароль в отдельном файле, переданном в параметре
--passwordfile
. В интерактивном режиме (см. раздел Интерактивный
режим) пароль можно указать интерактивно. Пароль относится к конфиденциальной
информации и требует защиты. Вы должны исключить доступ других пользователей
системы к паролям. Для того чтобы защитить пароль, перед добавлением пароля в файл
настройте права доступа к файлу таким образом, чтобы только вы могли просматривать его.
Например, можно выполнить одну из следующих команд:
- UNIX:
chmod 600 adminpassword.txt
- Windows:
cacls adminpassword.txt /P Administrators:F %USERDOMAIN%\%USERNAME%:F
По этой причине пароль не следует передавать в процесс с помощью аргумента командной строки. Во многих операционных системах другие пользователи могут просматривать аргументы командной строки ваших процессов.
Вызовы mfpadm содержат команду. Поддерживаются следующие команды.
Команда | Описание |
---|---|
show info | Отображает информацию о пользователе и конфигурации. |
show global-config | Отображает информацию о глобальной конфигурации. |
show diagnostics | Отображает диагностическую информацию. |
show versions | Отображает информацию о версии. |
unlock | Освобождает блокировку общего назначения. |
list runtimes [–in-database] | Отображает список сред выполнения. |
show runtime [runtime-name] | Отображает информацию о среде выполнения. |
delete runtime [runtime-name] condition | Удаляет среду выполнения. |
show user-config [runtime-name] | Отображает конфигурацию пользователей среды выполнения. |
set user-config [runtime-name] file | Задает конфигурацию пользователей среды выполнения. |
set user-config [runtime-name] property = value | Задает свойство в конфигурации пользователей среды выполнения. |
show confidential-clients [runtime-name] | Отображает конфигурацию конфиденциальных клиентов среды выполнения. |
set confidential-clients [runtime-name] file | Задает конфигурацию конфиденциальных клиентов среды выполнения. |
set confidential-clients-rule [runtime-name] id display-name secret allowed-scope | Задает правило для конфигурации конфиденциальных клиентов среды выполнения. |
list adapters [runtime-name] | Отображает список адаптеров. |
deploy adapter [runtime-name] property = value | Развертывает адаптер. |
show adapter [runtime-name] adapter-name | Отображает информацию об адаптере. |
delete adapter [runtime-name] adapter-name | Удаляет адаптер. |
adapter [runtime-name] adapter-name get binary [> tofile] | Получает двоичные данные адаптера. |
list apps [runtime-name] | Отображает список приложений. |
deploy app [runtime-name] file | Развертывает приложение |
show app [runtime-name] app-name | Отображает информацию о приложении. |
delete app [runtime-name] app-name | Удаляет приложение. |
show app version [runtime-name] app-name environment version | Отображает информацию о версии приложения. |
delete app version [runtime-name] app-name environment version | Удаляет версию приложения. |
app [runtime-name] app-name show license-config | Показывает конфигурацию лицензий на основе маркеров для приложения. |
app [runtime-name] app-name set license-config app-type license-type | Задает конфигурацию лицензий на основе маркеров для приложения. |
app [runtime-name] app-name delete license-config | Удаляет конфигурацию лицензий на основе маркеров для приложения. |
app version [runtime-name] app-name environment version get descriptor [> tofile] | Получает дескриптор версии приложения. |
app version [runtime-name] app-name environment version get web-resources [> tofile] | Получает веб-ресурсы версии приложения. |
app version [runtime-name] app-name environment version set web-resources file | Задает веб-ресурсы версии приложения. |
app version [runtime-name] app-name environment version get authenticity-data [> tofile] | Получает данные о подлинности версии приложения. |
app version [runtime-name] app-name environment version set authenticity-data [file] | Задает данные о подлинности версии приложения. |
app version [runtime-name] app-name environment version delete authenticity-data | Удаляет данные о подлинности версии приложения. |
app version [runtime-name] app-name environment version show user-config | Отображает конфигурацию пользователей версия приложения. |
app version [runtime-name] app-name environment version set user-config file | Задает конфигурацию пользователей версия приложения. |
app version [runtime-name] app-name environment version set user-config property = value | Задает свойство в конфигурации пользователей версии приложения. |
list devices [runtime-name][–query query] | Отображает список устройств. |
remove device [runtime-name] id | Удаляет устройство. |
device [runtime-name] id set status new-status | Изменяет состояние устройства. |
device [runtime-name] id set appstatus app-name new-status | Изменяет состояние устройства для приложения. |
list farm-members [runtime-name] | Отображает список элементов фермы серверов. |
remove farm-member [runtime-name] server-id | Удаляет сервер из списка элементов фермы. |
Интерактивный режим
Программу mfpadm можно вызвать без команд в командной строке. В
этом случае команды вводятся в интерактивном режиме по одной в строке. Сеанс mfpadm
завершается командой exit
или символом конца файла в стандартном
потоке ввода (Ctrl-D в случае терминалов UNIX).
В этом режиме также доступны команды help
, например:
- help
- help show versions
- help device
- help device set status
Хронология команд в интерактивном режиме
В отдельных операционных системах интерактивная команда mfpadm запоминает хронологию команд. В хронологии команд можно выбрать предыдущую команду с помощью клавиш со стрелками вверх и вниз, внести в нее изменения и запустить.
Linux
Хронология команд включена в окнах эмулятора терминала, если пакет rlwrap установлен
и указан в переменной PATH. Для установки пакета rlwrap выполните следующую команду:
- Red Hat Linux:
sudo yum install rlwrap
- SUSE Linux:
sudo zypper install rlwrap
- Ubuntu:
sudo apt-get install rlwrap
OS X
Хронология команд включена в программе Терминал, если пакет rlwrap установлен и указан в переменной PATH. Для установки пакета rlwrap выполните следующую команду:
- Установите MacPorts с помощью программы установки с сайта www.macports.org.
- Выполните команду:
sudo /opt/local/bin/port install rlwrap
- Затем укажите программу rlwrap в переменной PATH с помощью следующей команды в
оболочке, совместимой с Bourne:
PATH=/opt/local/bin:$PATH
Windows
Хронология команд включена в окнах консоли cmd.exe.
В средах, в которых пакет rlwrap не работает или не требуется, его можно выключить
с помощью параметра --no-readline
.
Файл конфигурации
Кроме того, параметры можно сохранить в файле конфигурации, чтобы не передавать их в командной строке в каждом вызове. Если файл конфигурации создан и указан параметр –configfile=файл, можно пропустить следующие параметры:
- –url=URL
- –secure=булевское значение
- –user=имя
- –passwordfile=файл
- –timeout=секунды
- –connect-timeout=секунды
- –socket-timeout=секунды
- –connection-request-timeout=секунды
- –lock-timeout=секунды
- runtime-name
С помощью следующих команд можно сохранить значения в файле конфигурации.
Команда | Комментарий |
---|---|
mfpadm [–configfile=file] config url URL | |
mfpadm [–configfile=file] config secure boolean | |
mfpadm [–configfile=file] config user name | |
mfpadm [–configfile=file] config password | Запрашивает пароль. |
mfpadm [–configfile=file] config timeout seconds | |
mfpadm [–configfile=file] config connect-timeout seconds | |
mfpadm [–configfile=file] config socket-timeout seconds | |
mfpadm [–configfile=file] config connection-request-timeout seconds | |
mfpadm [–configfile=file] config lock-timeout seconds | |
mfpadm [–configfile=file] config runtime runtime-name |
Для просмотра значений, указанных в файле конфигурации, выполните следующую
команду: mfpadm [--configfile=файл] config
Файл конфигурации представляет собой текстовый файл в кодировке текущей локали в формате .properties Java. Файлы конфигурации по умолчанию:
- UNIX: ${HOME}/.mfpadm.config
- Windows: My Documents\IBM MobileFirst Platform Server Data\mfpadm.config
Примечание: если параметр --configfile
не указан, то файл конфигурации по умолчанию применяется только в интерактивном
режиме, а также в командах config. Для неинтерактивного использования других команд
необходимо явным образом указать файл конфигурации, если вы хотите его использовать.
Важная информация: пароль хранится в нечитаемом формате, чтобы предотвратить несанкционированный доступ к нему. Однако, такая маскировка не обеспечивает безопасность.
Общие параметры
Доступны следующие общие параметры:
Параметр | Описание |
---|---|
–help | Shows some usage help |
–version | Shows the version |
Формат XML
Команды, которые получают ответ XML с сервера, проверяют соответствие этого ответа
конкретной схеме. Эту проверку можно выключить с помощью параметра
--xmlvalidation=none
.
Целевой набор символов
Программа mfpadm создает вывод в кодировке текущей локали. В Windows применяется кодовая страница ANSI. Это вызывает следующие эффекты:
- Символы, которые не принадлежат этому набору символов, в выводе преобразуются в знаки вопроса.
- Если вывод передается в окно командной строки Windows (cmd.exe), то символы, отличные от ASCII, отображаются неправильным образом, поскольку в таких окнах по умолчанию применяется кодовая страница OEM.
Для обхода этого ограничения выполните следующие действия:
- В операционных системах, отличных от Windows, применяется локаль с кодировкой UTF-8. Этот
формат - локаль по умолчанию в системах Red Hat Linux и OS X. Многие другие
операционные системы используют локаль
en_US.UTF-8
. - С помощью задачи Ant mfpadm с атрибутом
output="имя файла"
можно перенаправить вывод команды в файл.
Команды для общей настройки
При вызове программы mfpadm можно указать различные команды, обращающиеся к глобальной конфигурации IBM MobileFirst Server или среды выполнения.
Команда show global-config
Команда show global-config
отображает глобальную конфигурацию.
Формат: show global-config
Она принимает следующие параметры:
Аргумент | Описание |
---|---|
–xml | Produces XML output instead of tabular output. |
Пример
show global-config
Эта команда основана на службе REST Глобальная конфигурация (GET).
Команда show user-config
Команда show user-config
отображает конфигурацию пользователей среды
выполнения.
Формат: show user-config [--xml] [runtime-name]
Команда принимает следующие аргументы:
Аргумент | Описание |
---|---|
runtime-name | Имя среды выполнения. |
Команда show user-config
принимает следующие параметры после глагольной команды.
Аргумент | Описание | Требуется | По умолчанию |
---|---|---|---|
–xml | Produces output in XML format instead of JSON format. | No | Standard output |
Пример
show user-config mfp
Эта команда основана на службе REST Конфигурация среды выполнения (GET).
Команда set user-config
Команда set user-config
задает конфигурацию пользователей среды
выполнения или отдельное свойство в этой конфигурации.
Синтаксис для всей конфигурации: set user-config [runtime-name]
file
Команда принимает следующие аргументы:
Атрибут | Описание |
---|---|
runtime-name | Имя среды выполнения. |
file | Имя файла JSON или XML, содержащего новую конфигурацию. |
Синтаксис для отдельного свойства: set user-config [runtime-name] property = value
Команда set user-config
принимает следующие аргументы:
Аргумент | Описание |
---|---|
runtime-name | Имя среды выполнения. |
property | Имя свойства JSON. Вложенные свойства можно указать в формате prop1.prop2…..propN. Для элемента массива JSON укажите индекс вместо имени свойства. |
value | Значение свойства. |
Примеры
set user-config mfp myconfig.json
set user-config mfp timeout = 240
Эта команда основана на службе REST Конфигурация среды выполнения (PUT).
Команда show confidential-clients
Команда show confidential-clients
отображает конфигурацию
конфиденциальных клиентов, обладающих доступом к среде выполнения. Дополнительная
информация о конфиденциальных клиентах приведена в разделе Конфиденциальные
клиенты.
Синтаксис: show confidential-clients [--xml] [runtime-name]
Команда принимает следующие аргументы:
Атрибут | Описание |
---|---|
runtime-name | Имя среды выполнения. |
Команда show confidential-clients
принимает следующие параметры
после глагольной команды.
Аргумент | Описание | Требуется | По умолчанию |
---|---|---|---|
–xml | Produces output in XML format instead of JSON format. | No | Standard output |
Пример
show confidential-clients --xml mfp
Эта команда основана на службе REST Конфиденциальные клиенты (GET).
Команда set confidential-clients
Команда set confidential-clients
задает конфигурацию
конфиденциальных клиентов, обладающих доступом к среде выполнения. Дополнительная
информация о конфиденциальных клиентах приведена в разделе Конфиденциальные
клиенты.
Синтаксис: set confidential-clients [runtime-name] file
Команда принимает следующие аргументы:
Атрибут | Описание |
---|---|
runtime-name | Имя среды выполнения. |
file Имя файла JSON или XML, содержащего новую конфигурацию. |
Пример
set confidential-clients mfp clients.xml
Эта команда основана на службе REST Конфиденциальные клиенты (PUT).
Команда set confidential-clients-rule
Команда set confidential-clients-rule
задает правило в конфигурации
конфиденциальных клиентов, обладающих доступом к среде выполнения. Дополнительная
информация о конфиденциальных клиентах приведена в разделе
Конфиденциальные
клиенты.
Синтаксис: set confidential-clients-rule [runtime-name] id displayName secret allowedScope
Команда принимает следующие аргументы:
Атрибут | Описание |
---|---|
runtime | Имя среды выполнения. |
id | Идентификатор правила. |
displayName | Отображаемое имя правила. |
secret | Пароль правила. |
allowedScope | Область действия правила. Список маркеров через пробел. Список из двух и более маркеров следует заключить в двойные кавычки. |
Пример
set confidential-clients-rule mfp push Push lOa74Wxs "**"
Эта команда основана на службе REST Конфиденциальные клиенты (PUT).
Команды для адаптеров
При вызове программы mfpadm можно указать различные команды для адаптеров.
Команда list adapters
Команда list adapters
возвращает список адаптеров, развернутых для среды выполнения.
Синтаксис: list adapters [runtime-name]
Команда принимает следующие аргументы:
Аргумент | Описание |
---|---|
runtime-name | Имя среды выполнения. |
Команда list adapters
принимает следующие параметры после объекта.
Параметр | Описание |
---|---|
–xml | Produce XML output instead of tabular output. |
Пример
list adapters mfp
Эта команда основана на службе REST Адаптеры (GET).
Команда deploy adapter
Команда deploy adapter
развертывает адаптер в среде выполнения.
Синтаксис: deploy adapter [runtime-name] file
Команда принимает следующие аргументы:
Аргумент | Описание |
---|---|
runtime-name | Имя среды выполнения. |
file | Двоичный файл адаптера (.adapter) |
Пример
deploy adapter mfp MyAdapter.adapter
Эта команда основана на службе REST Адаптеры (POST).
Команда show adapter
Команда show adapter
отображает сведения об адаптере.
Формат: show adapter [runtime-name] adapter-name
Команда принимает следующие аргументы.
Аргумент | Описание |
---|---|
runtime-name | Имя среды выполнения. |
adapter-name | Имя адаптера |
Команда show adapter
принимает следующие параметры после объекта.
Параметр | Описание |
---|---|
–xml | Produce XML output instead of tabular output. |
Пример
show adapter mfp MyAdapter
Эта команда основана на службе REST Адаптеры (GET).
Команда delete adapter
Команда delete adapter
удаляет (отменяет развертывание) адаптера из среды выполнения.
Формат: delete adapter [runtime-name] adapter-name
Команда принимает следующие аргументы:
Аргумент | Описание |
---|---|
runtime-name | Имя среды выполнения. |
adapter-name | Имя адаптера. |
Пример
delete adapter mfp MyAdapter
Эта команда основана на службе REST Адаптер (DELETE).
Префикс команды adapter
Префикс команды adapter
принимает следующие аргументы перед глагольной командой.
Аргумент | Описание |
---|---|
runtime-name | Имя среды выполнения. |
adapter-name | Имя адаптера. |
Команда adapter get binary
Команда adapter get binary
возвращает двоичный файл адаптера.
Формат: adapter [runtime-name] adapter-name get binary [> tofile]
Команда принимает следующие параметры после глагольной команды.
Параметр | Описание | Требуется | По умолчанию |
---|---|---|---|
> tofile | Имя файла вывода. | Нет | Стандартный поток вывода |
Пример
adapter mfp MyAdapter get binary > /tmp/MyAdapter.adapter
Эта команда основана на службе REST Экспортировать ресурсы среды выполнения (GET).
Команда adapter show user-config
Команда adapter show user-config
отображает конфигурацию пользователей адаптера.
Синтаксис: adapter [runtime-name] adapter-name show user-config [--xml]
Команда принимает следующие параметры после глагольной команды.
Параметр | Описание |
---|---|
–xml | Produces output in XML format instead of JSON format. |
Пример
adapter mfp MyAdapter show user-config
Эта команда основана на службе REST Конфигурация адаптера (GET).
Команда adapter set user-config
Команда adapter set user-config
задает конфигурацию пользователей
адаптера или отдельное свойство в этой конфигурации.
Синтаксис для всей конфигурации: adapter [runtime-name] adapter-name set user-config file
Команда принимает следующие аргументы после глагольной команды.
Параметр | Описание |
---|---|
file | Имя файла JSON или XML, содержащего новую конфигурацию. |
Синтаксис для отдельного свойства: adapter [runtime-name] adapter-name set user-config property = value
Команда принимает следующие аргументы после глагольной команды.
Параметр | Описание |
---|---|
property | Имя свойства JSON. Вложенные свойства можно указать в формате prop1.prop2…..propN. Для элемента массива JSON укажите индекс вместо имени свойства. |
value | Значение свойства. |
Примеры
adapter mfp MyAdapter set user-config myconfig.json
adapter mfp MyAdapter set user-config timeout = 240
Эта команда основана на службе REST Конфигурация адаптера (PUT).
Команды для приложений
При вызове программы mfpadm можно указать различные команды для приложений.
Команда list apps
Команда list apps
возвращает список приложений, развернутых в среде выполнения.
Синтаксис: list apps [runtime-name]
Команда принимает следующие аргументы:
Аргумент | Описание |
---|---|
runtime-name | Имя среды выполнения. |
Команда list apps
принимает следующие параметры после объекта.
Параметр | Описание |
---|---|
–xml | Produce XML output instead of tabular output. |
Пример
list apps mfp
Эта команда основана на службе REST Приложения (GET).
Команда deploy app
Команда deploy app
развертывает версию приложения в среде выполнения.
Синтаксис: deploy app [runtime-name] file
Команда принимает следующие аргументы:
Аргумент | Описание |
---|---|
runtime-name | Имя среды выполнения. |
file | Дескриптор приложения, файл JSON. |
Пример
deploy app mfp MyApp/application-descriptor.json
Эта команда основана на службе REST Приложение (POST).
Команда show app
Команда show app
отображает сведения о приложении в среде выполнения (среды и версии).
Синтаксис: show app [runtime-name] app-name
Команда принимает следующие аргументы:
Аргумент | Описание |
---|---|
runtime-name | Имя среды выполнения. |
app-name | Имя приложения. |
Команда show app
принимает следующие параметры после объекта.
Параметр | Описание |
---|---|
–xml | Produce XML output instead of tabular output. |
Пример
show app mfp MyApp
Эта команда основана на службе REST Приложение (GET).
Команда delete app
Команда delete app
удаляет (отменяет развертывание) приложение из среды
выполнения.
Синтаксис: delete app [runtime-name] app-name
Команда принимает следующие аргументы:
Аргумент | Описание |
---|---|
runtime-name | Имя среды выполнения. |
app-name | Имя приложения |
Пример
delete app mfp MyApp
Эта команда основана на службе REST Версия приложения (DELETE).
Команда show app version
Команда show app version
отображает сведения о версии приложения в среде выполнения.
Синтаксис: show app version [runtime-name] app-name environment version
Команда принимает следующие аргументы:
Аргумент | Описание |
---|---|
runtime-name | Имя среды выполнения. |
app-name | Имя приложения. |
environment | Мобильная платформа. |
version | Версия приложения. |
Команда show app version
принимает следующие параметры после объекта.
Аргумент | Описание |
---|---|
– xml | Produces XML output instead of tabular output. |
Пример
show app version mfp MyApp iPhone 1.1
Эта команда основана на службе REST Версия приложения (GET).
Команда delete app version
Команда delete app version
удаляет (отменяет развертывание)
версии приложения из среды выполнения.
Синтаксис: delete app version [runtime-name] app-name environment version
Команда принимает следующие аргументы:
Аргумент | Описание |
---|---|
runtime-name | Имя среды выполнения. |
app-name | Имя приложения. |
environment | Мобильная платформа. |
version | Версия приложения. |
Пример
delete app version mfp MyApp iPhone 1.1
Эта команда основана на службе REST Версия приложения (DELETE).
Префикс команды app
Префикс команды app
принимает следующие аргументы перед глагольной командой.
Аргумент | Описание |
---|---|
runtime-name | Имя среды выполнения. |
app-name | Имя приложения. |
Команда app show license-config
Команда app show license-config
отображает конфигурацию лицензий на основе маркеров приложения.
Формат: app [runtime-name] app-name show license-config
Команда принимает следующие параметры после объекта:
Аргумент | Описание |
---|---|
–xml | Produces XML output instead of tabular output. |
Пример
app mfp MyApp show license-config
Эта команда основана на службе REST Конфигурация лицензий приложения (GET).
Команда app set license-config
Команда app set license-config
задает конфигурацию лицензий на основе маркеров приложения.
Синтаксис: app [runtime-name] app-name set license-config app-type license-type
Команда принимает следующие аргументы после глагольной команды.
Аргумент | Описание |
---|---|
appType | Тип приложения: B2C или B2E. |
licenseType | Тип приложения: APPLICATION, ADDITIONAL_BRAND_DEPLOYMENT или NON_PRODUCTION. |
Пример
app mfp MyApp iPhone 1.1 set license-config B2E APPLICATION
Эта команда основана на службе REST Конфигурация лицензий приложения (POST).
Команда app delete license-config
Команда app delete license-config
сбрасывает конфигурацию
лицензий приложения (возвращает ее в начальное состояние).
Синтаксис: app [runtime-name] app-name delete license-config
Пример
app mfp MyApp iPhone 1.1 delete license-config
Эта команда основана на службе REST Конфигурация лицензий (DELETE).
Префикс команды app version
Префикс команды app version
принимает следующие аргументы перед
глагольной командой.
Аргумент | Описание |
---|---|
runtime-name | Имя среды выполнения. |
app-name | Имя приложения. |
environment | Мобильная платформа |
version | Версия приложения |
Команда app version get descriptor
Команда app version get descriptor
возвращает дескриптор версии приложения.
Синтаксис: app version [runtime-name] app-name environment version get descriptor [> tofile]
Команда принимает следующие аргументы после глагольной команды.
Аргумент | Описание | Требуется | По умолчанию |
---|---|---|---|
> tofile | Имя файла вывода. | Нет | Стандартный поток вывода |
Пример
app version mfp MyApp iPhone 1.1 get descriptor > /tmp/MyApp-application-descriptor.json
Эта команда основана на службе REST Дескриптор приложения (GET).
Команда app version get web-resources
Команда app version get web-resources
возвращает веб-ресурсы версии приложения в виде файла .zip.
Синтаксис: app version [runtime-name] app-name environment version get web-resources [> tofile]
Команда принимает следующие аргументы после глагольной команды.
Аргумент | Описание | Требуется | По умолчанию |
---|---|---|---|
> tofile | Имя файла вывода. | Нет | Стандартный поток вывода |
Пример
app version mfp MyApp iPhone 1.1 get web-resources > /tmp/MyApp-web.zip
Эта команда основана на службе REST Получить веб-ресурс (GET).
Команда app version set web-resources
Команда app version set web-resources
задает веб-ресурсы для версии приложения.
Синтаксис: app version [runtime-name] app-name environment version set web-resources file
Команда принимает следующие аргументы после глагольной команды.
Аргумент | Описание |
file | Имя входного файла (требуется файл .zip). |
Пример
app version mfp MyApp iPhone 1.1 set web-resources /tmp/MyApp-web.zip
Эта команда основана на службе REST Развернуть веб-ресурс (POST).
Команда app version get authenticity-data
Команда app version get authenticity-data
возвращает данные о подлинности версии приложения.
Синтаксис: app version [runtime-name] app-name environment version get authenticity-data [> tofile]
Команда принимает следующие аргументы после глагольной команды.
Аргумент | Описание | Требуется | По умолчанию |
> tofile | Имя файла вывода. | Нет | Стандартный поток вывода |
Пример
app version mfp MyApp iPhone 1.1 get authenticity-data > /tmp/MyApp.authenticity_data
Эта команда основана на службе REST Экспортировать ресурсы среды выполнения (GET).
Команда app version set authenticity-data
Команда app version set authenticity-data
задает данные о подлинности версии приложения.
Синтаксис: app version [runtime-name] app-name environment version set authenticity-data file
Команда принимает следующие аргументы после глагольной команды.
Аргумент | Описание |
---|---|
file | Имя входного файла: <ul><li>Файл .authenticity_data </li><li>или файл устройства |
(.ipa, .apk или .appx), из которого извлекаются данные о подлинности. </li></ul> |
Примеры
app version mfp MyApp iPhone 1.1 set authenticity-data /tmp/MyApp.authenticity_data
app version mfp MyApp iPhone 1.1 set authenticity-data MyApp.ipa
app version mfp MyApp android 1.1 set authenticity-data MyApp.apk
Эта команда основана на службе REST Развернуть данные о подлинности приложения (POST).
Команда app version delete authenticity-data
Команда app version delete authenticity-data
удаляет данные о подлинности версии приложения.
Синтаксис: app version [runtime-name] app-name environment version delete authenticity-data
Пример
app version mfp MyApp iPhone 1.1 delete authenticity-data
Эта команда основана на службе REST Подлинность приложения (DELETE).
Команда app version show user-config
Команда app version show user-config
отображает конфигурацию пользователей для версии приложения.
Синтаксис: app version [runtime-name] app-name environment version show user-config [--xml]
Команда принимает следующие параметры после глагольной команды.
Аргумент | Описание | Требуется | По умолчанию |
---|---|---|---|
[–xml] | Создает вывод в формате XML вместо формата JSON. | Нет | Стандартный поток вывода |
Пример
app version mfp MyApp iPhone 1.1 show user-config
Эта команда основана на службе REST Конфигурация приложения (GET).
Команда app version set user-config
Команда app version set user-config
задает конфигурацию
пользователей для версии приложения или отдельное свойство в этой конфигурации.
Синтаксис для всей конфигурации: app version [runtime-name] app-name environment version set user-config file
Команда принимает следующие аргументы после глагольной команды.
Аргумент | Описание |
---|---|
file | Имя файла JSON или XML, содержащего новую конфигурацию. |
Синтаксис для отдельного свойства: app version [runtime-name] app-name environment version set user-config property = value
Команда app version set user-config
принимает следующие аргументы после глагольной команды.
Аргумент | Описание |
---|---|
property | Имя свойства JSON. Вложенные свойства можно указать в формате prop1.prop2…..propN. Для элемента массива JSON укажите индекс вместо имени свойства. |
value | Значение свойства. |
Примеры
app version mfp MyApp iPhone 1.1 set user-config /tmp/MyApp-config.json
app version mfp MyApp iPhone 1.1 set user-config timeout = 240
Эта команда основана на службе REST Конфигурация приложения (PUT).
Команды для устройств
При вызове программы mfpadm можно указать различные команды для устройств.
Команда list devices
Команда list devices
возвращает список устройств, которые
обращались к приложениям среды выполнения .
Синтаксис: list devices [runtime-name] [--query query]
Команда принимает следующие аргументы:
| Аргумент | Описание | |———-|————-| | runtime-name | Имя среды выполнения. | | query | Удобное имя или идентификатор пользователя для поиска. Этот параметр задает строку для поиска. Возвращаются все устройства, в удобных именах или идентификаторах пользователей которых встречается указанная строка (без учета регистра символов). |
Команда list devices
принимает следующие параметры после объекта.
Параметр | Описание |
---|---|
–xml | Produces XML output instead of tabular output. |
Примеры
list-devices mfp
list-devices mfp --query=john
Эта команда основана на службе REST Устройства (GET).
Команда remove device
Команда remove device
очищает информацию об устройстве, которое
обращалось к приложениям среды выполнения.
Синтаксис: remove device [runtime-name] id
Команда принимает следующие аргументы:
Аргумент | Описание |
---|---|
runtime-name | Имя среды выполнения. |
id | Уникальный идентификатор устройства. |
Пример
remove device mfp 496E974CCEDE86791CF9A8EF2E5145B6
Эта команда основана на службе REST Устройство (DELETE).
Префикс команды device
Префикс команды device
принимает следующие аргументы перед глагольной командой.
Аргумент | Описание |
---|---|
runtime-name | Имя среды выполнения. |
id | Уникальный идентификатор устройства. |
Команда device set status
Команда device set status
изменяет состояние устройства в среде
выполнения.
Синтаксис: device [runtime-name] id set status new-status
Команда принимает следующие аргументы:
Аргумент | Описание |
---|---|
new-status | Новое состояние. |
Состояние может иметь одно из следующих значений:
- ACTIVE
- LOST
- STOLEN
- EXPIRED
- DISABLED
Пример
device mfp 496E974CCEDE86791CF9A8EF2E5145B6 set status EXPIRED
Эта команда основана на службе REST Состояние устройства (PUT).
Команда device set appstatus
Команда device set appstatus
изменяет состояние устройства в отношении
приложения из среды выполнения.
Синтаксис: device [runtime-name] id set appstatus app-name new-status
Команда принимает следующие аргументы:
Аргумент | Описание |
---|---|
app-name | Имя приложения. |
new-status | Новое состояние. |
Состояние может иметь одно из следующих значений:
- ENABLED
- DISABLED
Пример
device mfp 496E974CCEDE86791CF9A8EF2E5145B6 set appstatus MyApp DISABLED
Эта команда основана на службе REST Состояние приложения устройства (PUT).
Команды для устранения неполадок
При вызове программы mfpadm можно указать различные команды для устранения неполадок.
Команда show info
Команда show info
отображает общую информацию о службах
администрирования MobileFirst, для возврата которой не
требуется доступ к среде выполнения или базе данных. С помощью этой команды можно
проверить, запущены ли службы администрирования MobileFirst.
Синтаксис: show info
Команда принимает следующие параметры после объекта.
Параметр | Описание |
---|---|
–xml | Produces XML output instead of tabular output. |
Пример
show info
Команда show versions
Команда show versions
отображает версии MobileFirst различных компонентов:
- mfpadmVersion: точный номер версии MobileFirst Server, к которой относится файл mfp-ant-deployer.jar.
- productVersion: точный номер версии MobileFirst Server, к которой относится файл mfp-admin-service.war
- mfpAdminVersion: точный номер версии компоновки файла mfp-admin-service.war.
Синтаксис: show versions
Команда принимает следующие параметры после объекта.
Параметр | Описание |
---|---|
–xml | Produces XML output instead of tabular output. |
Пример
show versions
Команда show diagnostics
Команда show diagnostics
отображает состояние различных
компонентов, необходимых для правильной работы службы администрирования
MobileFirst, включая доступность базы данных и вспомогательных служб.
Синтаксис: show diagnostics
Команда принимает следующие параметры после объекта.
Параметр | Описание |
---|---|
–xml | Produces XML output instead of tabular output. |
Пример
show diagnostics
Команда unlock
Команда unlock
освобождает блокировку общего назначения. Отдельные
опасные операции применяют эту блокировку, чтобы предотвратить
параллельное изменение данных конфигурации. В редких случаях, когда такие операции
прерываются, блокировки могут не освобождаться, запрещая тем самым запуск других подобных
операций. В таких случаях блокировку можно снять с помощью команды unlock.
Пример
unlock
Команда list runtimes
Команда list runtimes
возвращает список развернутых сред выполнения.
Синтаксис: list runtimes [--in-database]
Она принимает следующие параметры:
Параметр | Описание |
---|---|
–in-database | Whether to look in the database instead of via MBeans |
–xml | Produces XML output instead of tabular output. |
Примеры
list runtimes
list runtimes --in-database
Эта команда основана на службе REST Среды выполнения (GET).
Команда show runtime
Команда show runtime
отображает информацию о конкретной развернутой средой выполнения.
Синтаксис: show runtime [runtime-name]
Команда принимает следующие аргументы:
Аргумент | Описание |
---|---|
runtime-name | Имя среды выполнения. |
Команда show runtime
принимает следующие параметры после объекта.
Параметр | Описание |
---|---|
–xml | Produces XML output instead of tabular output. |
Эта команда основана на службе REST Среда выполнения (GET).
Пример
show runtime mfp
Команда delete runtime
Команда delete runtime
удаляет среду выполнения вместе с
приложениями и адаптерами из базы данных. Перед удалением среды выполнения
остановите ее веб-приложение.
Синтаксис: delete runtime [runtime-name] condition
Команда принимает следующие аргументы:
Аргумент | Описание |
---|---|
runtime-name | Имя среды выполнения. |
condition | Условие для удаления среды выполнения: empty или always. Внимание: |
значение always может представлять опасность. |
Пример
delete runtime mfp empty
Эта команда основана на службе REST Среда выполнения (DELETE).
Команда list farm-members
Команда list farm-members
возвращает список серверов из фермы, на
которых развернута конкретная среда выполнения.
Синтаксис: list farm-members [runtime-name]
Команда принимает следующие аргументы:
Аргумент | Описание |
---|---|
runtime-name | Имя среды выполнения. |
Команда list farm-members
принимает следующие параметры после объекта.
Параметр | Описание |
---|---|
–xml | Produces XML output instead of tabular output. |
Пример
list farm-members mfp
Эта команда основана на службе REST Элементы топологии фермы (GET).
Команда remove farm-member
Команда remove farm-member
удаляет сервер из списка элементов
фермы, на которых развернута указанная среда выполнения. Эту команду следует
выполнять в случае потери доступа к серверу или его отключения.
Синтаксис: remove farm-member [runtime-name] server-id
Команда принимает следующие аргументы.
Аргумент | Описание |
---|---|
runtime-name | Имя среды выполнения. |
server-id | Идентификатор сервера. |
Команда remove farm-member
принимает следующие параметры после объекта.
Параметр | Описание |
---|---|
–force | Force removal of a farm member, even if it is available and connected. |
Пример
remove farm-member mfp srvlx15
Эта команда основана на службе REST Элементы топологии фермы (DELETE).
▲Inclusive terminology note: The Mobile First Platform team is making changes to support the IBM® initiative to replace racially biased and other discriminatory language in our code and content with more inclusive language. While IBM values the use of inclusive language, terms that are outside of IBM's direct influence are sometimes required for the sake of maintaining user understanding. As other industry leaders join IBM in embracing the use of inclusive language, IBM will continue to update the documentation to reflect those changes.