Download the latest release for Mac OS X
or Windows
from the Releases
page, which includes the compiled binary for the pm-cli
utility:
https://github.com/PredixDev/predix-mobile-cli/releases
The release zip package includes pm CLI and the UAA configuration and UAA user creation shell scripts. The scripts enable you to quickly configure a UAA server for use with Predix Mobile.
Note: For convenience in running the pm CLI, add the pm
executable to your system PATH variable.
Command line usage is available for pm
CLI via the --help parameter:
pm --help
For more details, see Predix Mobile Command-Line Interface (pm CLI) Commands.
Utility scripts for configuring UAA, and adding developer users for use by the pm
CLI utility.
The pm-configure-uaa.sh
script can be used to configure the pm-api-gateway-oauth
OAuth account, pm
OAuth account, and pm.admin
user group.
./pm-configure-uaa.sh -u admin -s https://0e904b72-0000-0000-0000-fc1be00f817e.predix-uaa-staging.grc-apps.svc.ice.ge.com
(enter UAA admin password when prompted)
The pm-api-gateway-oauth
account is used by the Predix-Mobile service for client authentication, using the authorization_code
grant type.
The pm
account is an implicit_grant
type account, used by the pm
cli tool, similar in functionality to the cf
user account used by the Cloud Foundry cf
command line tool.
Note: It is safe to re-run the pm-configure-uaa.sh
script on an already configured UAA server. This will delete and recreate the OAuth clients. This can be useful to update an existing UAA server to the latest OAuth client configuration.
Create a developer user on the UAA server that provides the user with full access to the pm
CLI tool. This utility creates the user, and grants them access to the pm.admin
group.
./pm-add-developer.sh -e test@ge.com -p test
Note: If an error occurs related to authentication not valid, try re-logging into the UAA server, using the standard uaac
commands, and then execute the user creation operation again:
$> uaac target <uaa-server-url> --skip-ssl-validation
$> uaac token client get <username>
(enter UAA admin password when prompted)