云存储网关使用须知 - 云存储网关

为了保证云存储网关实例的正常运行，在使用之前，请您务必认真阅读以下使用须知。

文件网关须知

避免频繁中断大文件拷贝到NFS或SMB共享文件夹。由于后台的分段上传机制，中断大文件拷贝会造成碎片遗留在OSS。这些碎片会影响OSS的空间统计，造成OSS空间统计略大于看到的文件总量。通过OSS的碎片自动删除策略，可以帮助您管理碎片。具体操作，请参见删除碎片。
文件共享的缓存区估算公式为：本地建议缓存容量=（应用带宽（MB/s）-网关后端带宽（MB/s））×写入时长（s）×1.2。
如果您需要获得较好的本地访问性能，可以先预估总的热数据容量。取总的热数据容量和本地建议缓存容量的最大值作为本地缓存盘容量。
如果使用文件网关写入较大的文件，单一文件大小应保持在缓存盘容量的30%以下，且不能多个大文件并发写入，否则容易造成缓存盘写满的情况。
1.0.38及之后版本的文件网关支持最大30TB的文件上传。在上传超大文件时（大于2TB），建议用户的公网带宽不低于500MB/s或者采用专线连接阿里云，否则可能出现上传超时的问题。
文件网关支持Sparse file。如果上传Sparse file到文件网关失败，请运行以下命令转化。
```
dd if=<sparse file name> of=<sparse file name> conv=notrunc bs=1M
```
目前，支持的Sparse File文件大小不可超过可用缓存盘的大小。
文件网关的文件名和目录名必须使用UTF-8编码。文件网关暂不支持非UTF-8编码的文件名或目录名。例如：在Windows系统下挂载文件网关的NFS共享时，如果文件和目录名包含中文，则会导致创建失败，并返回错误代码0x8007045D。
文件网关中的单个文件超过256 MB的情况下，不建议开启Bucket的多版本功能。否则会出现文件元数据上传超时，影响网关整体性能。
文件网关是基于POSIX ACL实现Windows AD的权限访问隔离，不支持跨目录层级的多AD用户授权。例如：目录层级AA/BB/CC，属于张三。此时仅授予赵四访问（读写/只读）目录CC的权限，赵四无法利用AA/BB/CC全路径直接访问CC下的数据，需要把AA和BB都对赵四授权，才能保证数据对赵四可见。
在OSS文件数超过百万级别后，建议设置比较大的反向同步间隔（>3600s）。
从1.0.36版本开始支持按照文件后缀名自动在OSS的对象元数据里设置MIME类型。
在反向同步打开的情况下，在一个扫描周期中会出现本地未上云的空目录被反向同步进程删除的情况，再次创建目录即可修复。
重命名文件夹时，子孙目录或者文件总数目上限为500万。如果有更多的数目要求，请开工单。
反向同步开启时，重命名目录有可能因为网关侧元数据缓存不完整导致部分重命名成功。

云上文件网关须知

网关同步带宽根据OSS带宽限制制定，目前OSS为每个用户提供的最大访问带宽为10 Gbps。各区域的集群略有差异，请提交工单咨询。
默认的在线云存储网关只有1 Mb/s的公网带宽上行带宽，在跨地域访问OSS时使用的是公网，不保证传输质量和速度。

NFS和SMB等网络存储协议涉及一些特殊端口，需要通过安全组开通服务。

创建云上文件网关后，会默认创建一个前缀为Cloud_Storage_Gateway_Usage的安全组，创建ECS时请避免使用此安全组。NFS和SMB所需的端口已在此安全组中自动配置。
云存储网关支持AD域，新增需配置的端口有：AD、DNS、Kerberos。如果您需要将云存储网关加入AD域。具体操作，请参见文件网关如何加入AD域。

协议	端口
NFS	111（TCP、UDP），2049（TCP、UDP），32887（TCP、UDP），32888（TCP、UDP），32889（TCP、UDP）
SMB	137（UDP），138（UDP），139（TCP），389（TCP），445（TCP），901（TCP）
AD	389（TCP，UDP），445（TCP、UDP）
DNS	53（TCP、UDP）
Kerberos	88（TCP、UDP）

本地文件网关须知

本地文件网关控制台采用HTTPS协议。NFS和SMB等网络存储协议涉及一些特殊端口，需要通过防火墙开通服务。

本地文件网关支持加入AD域，新增需配置的端口有：AD、DNS、Kerberos。如果您需要将本地文件网关加入AD域，则需要在客户端防火墙打开对应端口。

协议	端口
HTTPS	443
NFS	111（TCP、UDP），2049（TCP、UDP），32887（TCP、UDP），32888（TCP、UDP），32889（TCP、UDP）
SMB	137（UDP），138（UDP），139（TCP），389（TCP），445（TCP），901（TCP）
AD	389（TCP，UDP），445（TCP、UDP）
DNS	53（TCP、UDP）
Kerberos	88（TCP、UDP）

块网关须知

iSCSI卷缓存区估算格式：本地建议缓存容量=（应用带宽（MB/s）-网关后端带宽（MB/s））×写入时长（s）×1.2
如果您需要获得较好的本地访问性能，可以先预估总的热数据容量。取总的热数据容量和本地建议缓存容量的最大值为本地缓存盘容量。
块网关同步带宽根据OSS带宽限制制定，目前OSS为每个用户提供的最大访问带宽为10Gbps。各区域的集群略有差异，请向各区域OSS客户支持人员查询。
缺省配置的IOPS受限于后端云盘的能力。高效云盘的最大带宽为110MB/s，SSD云盘的最大带宽为230MB/s。