Install Agent
To use the Parallel File Storage service, you need to connect to the target server and install the Agent. After installing the Agent, mount on the server and use Parallel File Storage.
Install Agent and Connect to Server (Mount)
Agent installation and server connection consist of six steps. Follow the next procedure.
- Agent installation
- Account Login
- Mount Point Creation
- Filesystem Mount
- Mount check
- fstab registration
Agent Installation
Install the Agent using Mount IP.
- All Services > Storage > Parallel File Storage Click the menu. Go to the Service Home page of Parallel File Storage.
- Click the Parallel File Storage menu on the Service Home page. Navigate to the Parallel File Storage list page.
- Parallel File Storage List page, click the resource to be used on the connected server. Move to the Parallel File Storage Details page.
- Connection Server After checking the server in the item, please connect.
- Refer to the following example to install the Volume Agent and proceed with server connection (Mount).
curl <Mount IP>:14000/dist/v1/install | sh
root@RESD-s4sr3h:/# curl http://10.102.160.254:14000/dist/v1/install | sh
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 1424 100 1424 0 0 1978k 0 --:--:-- --:--:-- --:--:-- 1390k
Downloading WekaIO CLI 4.2.4.29-hcsf
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 58.7M 100 58.7M 0 0 1079M 0 --:--:-- --:--:-- --:--:-- 1088M
Installing...
Installing agent of version 4.2.4.29-hcsf
The agent is configured to detect cgroups - cgroups v1 not found, cgroups are disabled
Waiting for agent service to be ready
Installation finished successfully
WekaIO CLI 4.2.4.29-hcsf is now installed
## Account Login
Log in using the mount information for server mount.
Reference
You can check the Mount name, Mount account, and password in the Mount information item of the detail page of Samsung Cloud Platform Console.
#weka user login -H
## Mount Point creation
Create a mount point on the server for the filesystem mount.
#mkdir /mnt/weka
## Filesystem Mount
Follow the steps below to mount the filesystem.
1. Use the #ip a command to check the IP and Interface Name information for Mount.
root@RESD-s4sr3h:/# ip a |grep 10.102 inet 10.102.160.248/23 brd 10.102.161.255 scope global ibs4f0.8010 inet 10.102.160.249/23 brd 10.102.161.255 scope global ibP1s8f0.8010
Note
The IP information and Interface Name that can be confirmed in the above example are as follows.
- IP: 10.102.160.10, 10.102.160.11
- Interface Name: ibs4f0.8010, ibP1s8f0.8010
2. Execute the mount command using the verified IP and Interface Name.
mount -t wekafs
## Mount Check
<code>#df -h</code> Run the command to check the mount status of the filesystem.
root@RESD-s4sr3h:/# df -h
Filesystem Size Used Avail Use% Mounted on
tmpfs 202G 3.8M 202G 1% /run
/dev/nvme2n1p2 3.5T 37G 3.3T 2% /
tmpfs 1008G 0 1008G 0% /dev/shm
tmpfs 5.0M 0 5.0M 0% /run/lock
/dev/nvme2n1p1 511M 6.1M 505M 2% /boot/efi
tmpfs 202G 4.0K 202G 1% /run/user/0
/dev/loop0 2.0G 47M 2.0G 3% /opt/weka/logs
tmpfs 1008G 12K 1008G 1% /opt/weka/data/agent/tmpfss/cleanup
tmpfs 1008G 2.0G 1006G 1% /opt/weka/data/agent/tmpfss/client-persistent-tmpfs
tmpfs 1008G 0 1008G 0% /opt/weka/data/agent/tmpfss/cross-container-rpc-the-tmpfs
tmpfs 1008G 4.0K 1008G 1% /opt/weka/data/agent/tmpfss/cleanup_before_stop_and_delete
bmtfs 1.9T 537G 1.3T 29% /weka_fs
## fstab registration
Register fstab so that it automatically mounts on server reboot.<br>
To register fstab, run the <code>#vi /etc/fstab</code> command, then add the following command.
root@RESD-s4sr3h:/# cat /etc/fstab
/etc/fstab: static file system information.
Use ‘blkid’ to print the universally unique identifier for a
device; this may be used with UUID= as a more robust way to name devices
that works even if disks are added and removed. See fstab(5).
/ was on /dev/nvme2n1p2 during curtin installation
/dev/disk/by-uuid/8683a4fb-ee21-47c2-938e-2be0beea2089 / ext4 defaults 0 1
/boot/efi was on /dev/nvme2n1p1 during curtin installation
/dev/disk/by-uuid/92ED-55CC /boot/efi vfat defaults 0 1 /swap.imgnoneswapsw00 10.102.160.254/wekafs /mnt/weka wekafs num_cores=8,net:ha=ibs4f0.8010,net:ha=ibP1s8f0.8010,mgmt_ip=10.102.160.10+10.102.160.11,x-systemd.requires=wekaagent.service,x-systemd.mount-timeout=infinity,_net dev 0 0
# Disconnect server (Umount)
To disconnect the server, first connect to the server and perform the disconnect operation (Umount), then you must disconnect the server from the Console.<br>
To disconnect the server, follow the steps below.
1. **All Services > Storage > Parallel File Storage** Click the menu. Go to the **Service Home** page of Parallel File Storage.
2. Click the **Parallel File Storage** menu on the **Service Home** page. You will be taken to the **Parallel File Storage** list page.
3. **Parallel File Storage List** page, click the resource to disconnect the server. Move to the **Parallel File Storage Details** page.
4. **Connection Server** after checking the server information in the item, connect to the server.
5. Refer to the commands shown in the following example and proceed with the unmount operation (Umount).
umount /mnt/weka
vi /etc/fstab