挂载目录

在本例中：远程DB节点表示SequoiaDB集群安装节点，FS节点表示通过SequoiaFS映射挂载目录的节点。

两者可以是相同节点也可以是不同节点，可以在一个FS节点上的不同目录下，映射挂载同一DB集群节点或不同DB集群节点，也可以在不同FS节点进行映射挂载同一DB集群节点。

以下例子中DB节点为一常见普通集群，部署了一个coord、三个catalog和三个data节点，在FS节点上利用SequoiaFS挂载映射目录。

1、在DB节点上创建目标集合

首次启动时，需要在远程DB节点上创建映射的目标集合collection。后面挂载目录之后，mountpoint目录下的所有文件的实际内容会以lob的形式存放在该集合下。而所有文件的属性信息会分别存放在目录元数据集合和文件元数据集合中。

$sdb
Welcome to SequoiaDB shell!
help() for help, Ctrl+c or quit to exit
> var db = new Sdb("localhost", 11810) 
Takes 0.124118s.
> db.createCS("foo")
localhost:11800.foo
Takes 0.352408s.
> db.foo.createCL("bar")
localhost:11800.foo.bar
Takes 2.466226s.
>  

2、在FS节点上创建挂载目录及配置文件

挂载目录mountpoint为FS节点上的目录，用以挂载映射远程DB节点的目标集合，所以需要在FS节点上创建该目录。

启动SequoiaFS时可以指定从配置文件中读取配置参数，建议首次启动前创建配置文件并进行参数设置，配置文件及日志路径建议参考进行设置，以防止出现多次映射时互相覆盖的情况。

$mkdir -p /opt/sequoiadb/mountpoint
$mkdir -p /opt/sequoiafs/conf/foo_bar/001/
$mkdir -p /opt/sequoiafs/log/foo_bar/001/

该例中按照默认参数值进行启动，所以不对参数进行配置，只是创建一个空配置文件，实际使用时按需写入相关配置值。

$touch /opt/sequoiafs/conf/foo_bar/001/sequoiafs.conf

3、挂载目录

挂载目录时，除了目标集合collection外，还需要指定一系列参数，具体参数选项详情请查看选项。。

通过-i或者—hosts进行指定远程DB节点（协调节点），一旦挂载之后，mountpoint目录下的所有文件的属性信息会存放在远程DB节点上的目录元数据集合及文件元数据集合中，而文件内容会以lob的形式存放在目标集合下。目录元数据集合和文件元数据集合可以分别通过-d(或—metadircollection)和-f（或—metafilecollection）在进行指定，也可以直接通过指定—autocreate默认生成，该例指定默认生成。

这里除了SequoiaFS相关参数，还指定了FUSE的参数-o big_writes（开启大页写），具体参数详情可以参见。

4、查看挂载信息

4.1 本地FS节点通过mount可以看到挂载信息

$ mount
/dev/sda1 on / type ext4 (rw,errors=remount-ro)
proc on /proc type proc (rw,noexec,nosuid,nodev)
sysfs on /sys type sysfs (rw,noexec,nosuid,nodev)
none on /sys/fs/fuse/connections type fusectl (rw)
none on /sys/kernel/debug type debugfs (rw)
none on /sys/kernel/security type securityfs (rw)
udev on /dev type devtmpfs (rw,mode=0755)
devpts on /dev/pts type devpts (rw,noexec,nosuid,gid=5,mode=0620)
tmpfs on /run type tmpfs (rw,noexec,nosuid,size=10%,mode=0755)
none on /run/lock type tmpfs (rw,noexec,nosuid,nodev,size=5242880)
none on /run/shm type tmpfs (rw,nosuid,nodev)
sequoiafs on /opt/sequoiadb/mountpoint type fuse.sequoiafs (rw,nosuid,nodev,user=sdbadmin)

4.2 在DB节点可以查看相关信息

> var db = new Sdb("localhost", 11810) 
Takes 0.001705s.
> db.list(4)
{
  "Name": "sequoiafs.maphistory"
}
{
  "Name": "sequoiafs.sequenceid"
}
{
  "Name": "sequoiafs.bar_dir148139183721030"
}
{
  "Name": "sequoiafs.bar_file148139183721030"
}
{
  "Name": "foo.bar"
}

对于每次mount，可以通过以上5张表查看相关信息，后续会介绍各表的作用，sequoiafs.maphistory为映射挂载历史信息表，记录历史挂载的关键数据信息。

>  db.sequoiafs.maphistory.find()
  "_id": {
    "$oid": "5aff94db15d4f9e718e723cd"
  },
  "SourceCL": "foo.bar",
  "DirMetaCL": "sequoiafs.bar_dir148139183721030",
  "FileMetaCL": "sequoiafs.bar_file148139183721030",
  "Address": "eth0:192.168.20.45;",
  "MountPoint": "/opt/sequoiadb/mountpoint",
  "MountTime": {
    "MountTime": "2018-05-19-11.07.07.866247"
  }
}

每次挂载时都会记录一条历史数据，以供历史查询，其基本含义如下：

sequoiafs.sequenceid为目录元数据中目录记录的id序列表，目的用于构造目录的唯一性。

sequoiafs.bar_dir148139183721030和sequoiafs.bar_file148139183721030分别为目录和文件的元数据集合表，由于SequoiaFS启动挂载时指定了—autocreate，所以这里是默认生成的，用以记录FS挂载目录下的目录和文件信息。

4.3 在FS节点挂载目录下创建文件和目录

上面我们在FS挂载目录下创建了文件testfile并写入'hello, this is a testfile!'，并创建了子目录testdir。在DB节点查看目录元数据集合，可以查到testdir目录元数据信息记录。

> db.sequoiafs.bar_dir148139183721030.find()
{
  "_id": {
    "$oid": "5affae7115d4f9e718e723d0"
  },
  "Name": "testdir",
  "Mode": 16877,
  "Uid": 2109,
  "Gid": 2000,
  "Pid": 1,
  "Id": 621,
  "NLink": 0,
  "Size": 4096,
  "CreateTime": 1526705777945,
  "ModifyTime": 1526705777945,
  "AccessTime": 1526705777945,
  "SymLink": ""
}
Return 1 row(s).
Takes 0.019212s.

目录元数据信息的具体含义如下：

DB节点查看文件元数据集合，可以查到testfile文件元数据信息记录。

> db.sequoiafs.bar_file148139183721030.find()
{
  "AccessTime": 1526705729062,
  "CreateTime": 1526705729000,
  "Gid": 2000,
  "LobOid": "5affae4015d4f9e718e723ce",
  "Mode": 33188,
  "ModifyTime": 1526705729062,
  "NLink": 1,
  "Name": "testfile",
  "Pid": 1,
  "Size": 27,
  "SymLink": "",
  "Uid": 2109,
  "_id": {
    "$oid": "5affae4015d4f9e718e723cf"
  }
}
Return 1 row(s).
Takes 0.010137s.
> db.foo.bar.listLobs()
{
  "Size": 27,
  "Oid": {
    "$oid": "5affae4015d4f9e718e723ce"
  },
  "CreateTime": {
    "$timestamp": "2018-05-19-12.55.28.833000"
  },
  "ModificationTime": {
  },
  "Available": true,
  "HasPiecesInfo": false
}

文件元数据信息具体含义如下：

从上表可以看出，文件元数据和目录元数据大致相同，不同的是，文件实际对应着一个Lob文件（通过LobOid映射到该文件），以保存文件的实际内容。并且文件没有ID属性，因为文件只从属于某个目录，所以只需要PID属性。

通用选项

首次启动时，其中-l collection参数和mountpoint是必须指定的，collection为需要映射的目标集合名称，为目标SequoiaDB节点中创建的集合，需要提前在DB中创建好。

目标SequoiaDB节点可以通过-i或者—hosts进行指定，一旦挂载之后，mountpoint目录下的所有文件的属性信息会存放在目标SequoiaDB节点上的目录元数据集合及文件元数据集合中，文件内容会以lob的形式存放在目标集合下。

目录元数据集合和文件元数据分别可以通过-d(或—metadircollection)和-f（或—metafilecollection）在启动时进行指定，也可以直接通过指定—autocreate默认生成。手工创建时，需要为目录元数据集合创建一个强一致唯一索引，索引字段为 {Name:1, Pid:1}。为文件元数据集合创建两个强一致唯一索引，索引字段分别为 {Name:1, Pid:1} 和 {LobOid:1}。

FUSE选项

因为SequoiaFS在同一个节点可以挂载映射同一套DB或者不同套DB的同一个目标集合或者不同目标集合，所以在创建配置文件及指定日志路径时，建议参考以下规则进行配置，以防止出现配置文件互相干扰覆盖或者日志文件互相覆盖的情况。

配置文件路径及日志文件路径参考规则：

/opt/sequoiafs/conf/collection/001/sequoiafs.conf
/opt/sequoiafs/log/collection/001/diaglog/sequoiafs.log
/opt/sequoiafs/conf/collection/002/sequoiafs.conf
/opt/sequoiafs/log/collection/002/diaglog/sequoiafs.log 

collection即SequoiaFS启动时指定的目标集合实际名称，001和002表示挂载映射次数，从而防止映射同一个目标映射集合时日志文件互相覆盖。

配置样本文件：

如果SequoiaFS是通过run包进行安装的，则可以从安装目录conf/samples/下拷贝配置文件样本sequoiafs.conf到指定的配置路径下。否则可以通过手工创建sequoiafs.conf，并根据需要写入以下配置内容，参数具体值根据实际情况写入，不进行配置的参数可以不用写入进配置文件中，以下为SequoiaFS配置文件样本内容：

下面实例演示了通过API在mountpoint目录下简单地创建了一个testfile文件并写入testdata内容。

#include <stdio.h>
#include <sys/stat.h>
#include <unistd.h>
#include <sys/types.h>
#include <fcntl.h>
 
static char testdata[] = "abcdefghijklmnopqrstuvwxyz";
static int testdatalen = sizeof(testdata) - 1;
#define testfile "/opt/sequoiadb/mountpoint/testfile"
 
int main()
{
    int rc = 0;
    int fd = 0;
    const char *data = testdata;
    int datalen = testdatalen;
 
    fd = open(testfile,  O_WRONLY|O_CREAT);
    if(0 > fd)
    {
        printf("Failed to open file:%s\n", testfile);
        goto error;
    }
 
    rc = write(fd, data, datalen);
    if(0 > rc)
    {
        printf("Failed to write file:%s\n", testfile);
        goto error;
    }
 
    rc = lseek(fd, 4, SEEK_SET);
    if(0 > rc)
    {
        printf("Failed to lseek file:%s\n", testfile);
        goto error;
    }
 
    rc = write(fd, "DF", 2);
    if(0 > rc)
    {
        printf("Failed to write file:%s\n", testfile);
        goto error;
    }
 
    rc = close(fd);
    if(0 > rc)
    {
        printf("Failed to close file:%s\n", testfile);
        goto error;
    }
done:
    return rc;
error:
}