Managing GooseFSx Clients
Last updated:2025-07-17 20:23:21
Creating a POSIX Client
The GooseFSx POSIX client refers to the host where the GooseFSx POSIX client software is deployed and mounts GooseFSx as a local directory. The POSIX client accesses the mount directory just like accessing a local file system.
Note:
Prerequisites
Created GooseFSx instances and POSIX client management nodes. When creating a GooseFSx instance, a POSIX client management node is synchronously created. Please see Managing GooseFSx Instances.
Added security group rules for the host. Please see Client Specifications and Limits. If you have also set up a security group with a denial policy for the POSIX client, ensure that the POSIX client security group rules are not denied.
Operation Steps
1. Log in to the Data Accelerator GooseFS console, and enter the instance list.
2. Select the region where the target instance is located, select the target GooseFSx instance, which is the GooseFSx instance for creating the POSIX client. You can quickly find the target instance by AZ, status, Type, or perform a keyword fuzzy matching search by name.
3. Click the instance ID or Management, then select POSIX Client > Client List.
4. In the client list section, click Add New Client to create a POSIX client.
5. In the pop-up dialog box for adding a POSIX client, configure as follows.
VPC to which the corresponding instance belongs: Select host VPC location.
Subnet: Select the subnet where the host resides.
Host ID: Quickly find the host you need to add as a POSIX client by fuzzy matching the host name/host IP address, or enter the host IP directly. You can select up to 10 hosts at the same time and add multiple hosts as POSIX clients in one batch operation.
Note:
Please confirm that security group rules have been added for this host. Please refer to Client Specifications and Limits. If you also set up a security group with a denial policy for the POSIX client, ensure that the POSIX client security group rules are not denied.
Mount directory: Please enter the absolute path. It can be one of the following cases:
If the directory already exists and is not mounted, it will be mounted to this directory.
If the directory already exists and is mounted, it will not be mounted to this directory.
If the directory does not exist, it will be created and mounted to this directory.
You can also choose the default mount directory. The default GooseFSx mount directory is
/GooseFSx/x-${model}-${instance id}-proxy, such as /GooseFSx/x-c60-089xxxx-proxy. Among them, ${model} and ${instance id} are the model and instance of your specific environment. The GooseFSx file system mounts to this directory on the host.6. Click Confirm. The creation process is expected to take several minutes. You can check the result in the POSIX client list.
Checking Whether GooseFSx Is Mounted
The default mount directory for GooseFSx is
/GooseFSx/x-${model}-${instance id}-proxy, such as /GooseFSx/x-c60-089xxxx-proxy. Among them, ${model} and ${instance id}, please refer to Managing GooseFSx Instances.
The user can run the following command to check whether GooseFSx is mounted:
sh goosefsx_mount_status.sh 10
Note:
The input parameter number 10 means the timeout period, which is customizable.
If
mount success is returned, mounting is successful.If
wait time out is returned, mounting fails.The path to execute this command is as follows:
/root/goosefsx_client_agent/linux_client_agent/goosefsx_mount_status.sh
Mounting GooseFSx to a Specified Directory
Users can mount the specified directory manually using the mount command, such as mounting to
/mnt/test:mount --bind /goosefsx/x-c60-089xxxx-proxy/ /mnt/test
Creating POSIX Clients in Batches
To batch create POSIX clients, you can create a batch of GooseFSx POSIX clients at one time using an image. First, create a GooseFSx POSIX client with the same host OS version. Next, generate an image from this client. Finally, use the image to pull up GooseFSx POSIX clients in bulk.
Prerequisites
Created GooseFSx instances. Please see Managing GooseFSx Instances. If multiple GooseFSx instances have been created, select the instances for which you want to batch create POSIX clients; if you want to batch create POSIX clients for multiple instances, execute batch creation of POSIX clients for each of these instances, because GooseFSx POSIX clients belong to a certain GooseFSx instance.
POSIX client management nodes have been created. When creating GooseFSx Instances, POSIX client management nodes are synchronously created.
Created at least one GooseFSx POSIX client with the same host OS version.
Note:
To batch create POSIX clients with different OS versions, first create POSIX clients with different OS versions, generate a mirror, and then pull up POSIX clients with the same OS version using the mirror.
For example, create a CentOS POSIX client, generate a mirror of the CentOS POSIX client, then batch create CentOS POSIX clients using the mirror; create a TLinux POSIX client, generate a mirror of the TLinux POSIX client, then batch create TLinux POSIX clients using the mirror; and so on.
Operation Steps
1. Log in to the Data Accelerator GooseFS console, and enter the instance list.
2. Select the region where the target instance is located, then select the target GooseFSx instance. You can quickly find the target instance by AZ, status, type, etc., or perform a keyword fuzzy matching search by name.
3. Click the instance ID or Management, then select POSIX Client > Client List.
4. In the POSIX Client List, select the POSIX client to create an image based on. If there is no POSIX client for the target operating system version, you need to Creat POSIX Client first; click Host ID to enter the console of the host instance. If you need to create an image, please refer to Create a Custom Image.
5. Batch create POSIX clients using images. For relevant guidelines, please refer to Instance Creation Using Images.
Querying a POSIX Client
Query POSIX clients, including both automatically and manually added POSIX clients mounted to GooseFSx.
Prerequisites
Created GooseFSx instances and POSIX client management nodes. When creating GooseFSx instances, POSIX client management nodes are synchronously created. Please see Managing GooseFSx Instances.
Created a GooseFSx Client.
Operation Steps
1. Log in to the Data Accelerator GooseFS console, and enter the instance list.
2. Select the region where the target instance is located, then select the target GooseFSx instance, which is the GooseFSx instance belonging to the POSIX client. You can quickly find the target instance by AZ, status, type, etc., or perform a keyword fuzzy matching search by name.
3. Click the instance ID or Management, then select POSIX Client > Client List.
4. POSIX Client List displays all POSIX client information.
Deleting a POSIX Client
Delete POSIX client, unbind POSIX client mount from GooseFSx. The client management node no longer manages this POSIX client. Uninstall POSIX client software.
After deleting a POSIX client, you can perform the creation again to mount it to GooseFSx.
Prerequisites
Created GooseFSx instances and POSIX client management nodes. When creating a GooseFSx instance, a POSIX client management node is synchronously created. See Managing GooseFSx Instances.
Created a GooseFSx Client.
Operation Steps
1. Log in to the Data Accelerator GooseFS console, and enter the instance list.
2. Select the region where the target instance is located, then select the target GooseFSx instance, which is the POSIX client to be deleted. You can quickly find the target instance by AZ, status, type, etc., or perform a keyword fuzzy matching search by name.
3. Click the instance ID or Management, then select POSIX Client > Client List.
4. Check the POSIX client to be deleted, then click Delete in the Action column and Confirm in the pop-up.
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No
Feedback