qq portal_create

This section explains how to use the qq portal_create command.

Example

To Propose an Initial Portal Relationship

Run the qq portal_create command and specify the spoke portal root directory, the proposed hub portal root directory on that cluster, and the IP addresses of the nodes in the remote cluster.

Important

We strongly recommend using the qq portal_create command with the --hub-hosts flag to spread the workload across all nodes on the hub portal host cluster.
For the command to succeed, don't use the backslash (\) to break the list of IP addresses across multiple lines.

For example:

qq portal_create \
  --spoke-root /remote/projects \
  --hub-address 203.0.113.0 \
  --hub-root /projects
  --hub-root /projects \
  --hub-hosts 203.0.113.1,203.0.113.2,203.0.113.3,203.0.113.4

Description

Create a spoke portal on the current cluster and propose a hub portal on another cluster

Usage

qq portal_create [-h] [--spoke-root SPOKE_ROOT] [--hub-root HUB_ROOT] [-j] [-r] [-n] (-m HUB_HOSTS | -a HUB_ADDRESS) [-p HUB_PORT]

Flags

Flag Name	Required	Description
`--spoke-root`	No	The full path to the directory that serves as the spoke portal root directory. Qumulo Core creates this directory for you automatically. If this directory exists already, the system outputs an error.
`--hub-root`	No	The full path to the prospective directory that will serve as the hub portal root directory
`-j`	No	Pretty-print JSON
`-r`	No	Create a read-only spoke portal. Read-only spoke portals prevent users from creating or modifying files or directories under the hub portal root directory. Important: It isn't possible to change a read-only spoke portal to a read-write portal after creating it.
`-n`	No	Do not attempt to resolve file IDs present on the local cluster to paths.
`-m`	No	The IP addresses and TCP ports of the remote cluster. Use a comma-delimited list to specify multiple hosts. Use colon as a separator after each IP address to provide custom TCP port (3713 is used by default). Ports specified this way override other --port arguments.
`-a`	No	The IP address of a node in the remote cluster
`-p`	No	The TCP port for portal activity on the remote cluster. The default port 3713 is used if this field is not provided.