Overview

This guide covers setting up Fioctl to communicate with your Enterprise instance.

Along with the steps described under installing Fioctl, follow the steps specific to the enterprise edition below.

Configuring Fioctl

Enterprise Only

Run the following:

fioctl login --oauth-url https://app.qcom.foundries.io/oauth

The default Fioctl configuration file is under $HOME/.config/fioctl.yaml. After login, it should contain your domain:

$ cat $HOME/.config/fioctl.yaml

clientcredentials:
  ...
  url: https://app.qcom.foundries.io/oauth/
server:
  ...
  url: https://api.qcom.foundries.io.io

Enterprise and Foundries.io Instances

If you wish to work with both your enterprise instance and Foundries.io, use the config flag to define a new place to store the enterprise configuration. The Foundries.io configuration will be kept in the default location ($HOME/.config/fioctl.yaml).

1. Create a file for the enterprise configuration:

vi $HOME/.config/fioctl-enterprise.yaml

2. Login with the enterprise configuration:

$ fioctl -c $HOME/.config/fioctl-enterprise.yaml login \
  --oauth-url=https://app.qcom.foundries.io/oauth

3. Verify the configuration:

fioctl -c $HOME/.config/fioctl-enterprise.yaml factories

4. Create an alias to simplify its usage:

alias fioctl-enterprise="fioctl -c $HOME/.config/fioctl-enterprise.yaml"

5. Check the alias:

fioctl-enterprise factories

Now you can use fioctl-enterprise, skipping the need to pass the configuration file to execute commands.

NOTE If you do not want to create an alias, you will need to use an environment variable (FIOCTL_CONFIG=$HOME/.config/fioctl-enterprise.yaml).