DXP commands and options
The top-level commands of the DXP CLI execute functions that affect the DXP CLI instance itself or invoke the required DXP service.
These commands can be reviewed using the dxp-next --help
command, the output of which is shown below:
Usage: dxp-next [options] [command]
dxp-next commands
Options:
-V, --version output the version number
-h, --help display help for command
Commands:
auth Authenticate into the DXP CLI
cmp Component Service Commands
job-runner Job Runner Service Commands
datastore Datastore Commands
cdp Customer Data Platform Service Commands
dxp-next auth
Usage: dxp-next auth [options] [command]
Authenticate into the DXP CLI
Options:
-h, --help display help for command
Commands:
login [options] Login to the DXP platform
help [command] display help for command
dxp-next auth login
Usage: dxp-next auth login [options]
Login to the DXP platform
Options:
--dxp-base-url <baseURL> dxp cloud base url e.g. "https://develop-apps-dxp-console.dev.dxp.squiz.cloud/" (default: "https://dxp.squiz.cloud", env:
DXP_BASE_URL)
--region <region> (choices: "au", default: "au")
--override-session Override the existing authorized session if it exists
--tenant <tenantID>
-h, --help display help for command
WSL configuration
If you use an Ubuntu variant in WSL, further configuration is required to sign in using the auth login
command.
-
If it is not already installed, install
xdg-utils
:-
sudo apt-get update
-
sudo apt-get install xdg-utils
-
-
Identify the path to the default browser executable. There are multiples ways to do this using the WSL CLI. Listing them all is out of scope for this documentation.
Keep in mind that the WSL default browser will be installed in your Windows environment, so unless you have installed your browser to a unique location, the path will begin with either
/mnt/c/Program Files
or/mnt/c/Program Files (x86)
.If this is the case, and the path contains a space, follow the Additional steps.
If your executable path does not contain a space, there is no need for any further configuration.
Additional steps
-
Create a symbolic link to the browser executable.
ln -s /path/to/default\ browser/executable.exe ~/browser.exe
Your path will be different and point to a binary executable. Change
browser.exe
to a name you will recognize (the browser’s name, for example).Do not forget to escape the space(s) in the path with a backslash ( \
). -
Add this symlink as a variable in
~/.bashrc
:export BROWSER=~/browser.exe
Use the name you chose in Step 4. Ensure you include the file extension (
.exe
). -
Reload your bash configuration:
source ~/.bashrc
These further steps will ensure your browser will launch, allowing you to authenticate as needed.