Администрирование приложений с помощью терминала

improve this page | report issue

Обзор

Для администрирования приложений MobileFirst можно использовать программу mfpadm.

SDK IBM Mobile Foundation версии выше 8.0.0.0-MFPF-IF201701250919 предлагают обновленную поддержку проверки подлинности приложений: с помощью команд mfpadm можно переключаться между динамическим и статическим режимами проверки и сбросить проверку.

Перейдите в установочный каталог IBM Mobile Foundation /MobilefirstPlatformServer/shortcuts и выполните команды mfpadm.

  1. Для переключения между типами проверки:
     mfpadm --url=  --user=  --passwordfile= --secure=false app version [RUNTIME] [APPNAME] [ENVIRONMENT] [VERSION] set authenticity-validation TYPE
    

    Value for TYPE can be static or dynamic

Пример для 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
  1. Для сбора данных с помощью следующей команды, которая очищает идентификационный код приложения.
      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 можно администрировать приложения 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 выполните следующую команду:

  1. Установите MacPorts с помощью программы установки с сайта www.macports.org.
  2. Выполните команду: sudo /opt/local/bin/port install rlwrap
  3. Затем укажите программу 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.
Last modified on August 17, 2020