#创建用户和目录

# 创建安装用户

为提高业务隔离性，减少误操作，建议为YashanDB产品创建独立的安装用户。

请以root用户或具备sudo权限的用户登录所有服务器上执行下述操作。

创建一个帐号并设置密码。

本安装手册中，以yashan作为数据库安装用户名称。
```
# useradd -d /home/yashan -m yashan
# passwd yashan
```
新建YASDBA用户组并将安装用户加入该组。
```
# groupadd YASDBA
# usermod -a -G YASDBA yashan
```

（可选）为安装用户配置sudo免密。

某些特定功能（例如创建资源组和共享集群SCAN）要求数据库用户必须拥有sudo权限，如预计不会使用到这些功能，可以跳过本操作。

# cd /etc
# ll sudoers
## 若root用户不具备sudoers文件编辑权限，需先授权
# chmod +w sudoers
# vi /etc/sudoers

## 在sudoers文件文件末尾添加如下内容，保存并退出
yashan  ALL=(ALL)NOPASSWD:ALL

## 若调整过sudoers文件的权限，应还原
# chmod -w sudoers

# 创建目录

YashanDB采用集群多服务器并行安装模式，只需以root用户或具备sudo权限的用户登录某一台服务器上创建安装目录，并对安装用户进行授权。

在安装YashanDB服务端之前，需要以root用户或具备sudo权限的用户登录所有服务器上创建下述其他目录，并对安装用户进行授权。

安装用户必须具备这些目录的全部权限。

# 安装目录

本文以192.168.1.2作为安装服务器，以/home/yashan/install作为安装目录。

# mkdir -p /home/yashan/install
# chown -R yashan:yashan /home/yashan/install

HOME目录：YashanDB的产品目录，用于存放YashanDB所提供的命令、数据库运行所需的库及各关键组件。在安装操作中，该目录将作为--install-path参数的值。安装完成后YashanDB会在该目录下按规则生成$YASDB_HOME。
DATA目录：YashanDB的数据目录，用于存放数据库的各类系统数据文件、部分日志文件（具体请查阅日志管理）和配置文件，用户数据也默认存储在该目录下。但对于共享集群，所有的数据文件和redo文件均需保存在共享存储上，DATA目录将只用于存储实例运行相关的配置文件、日志文件等数据。在安装操作中，该目录将作为--data-path参数的值。安装完成后YashanDB会在该目录下按规则生成$YASDB_DATA。

本安装手册中，HOME目录和DATA目录的示例值均规划在/data/yashan下，可执行如下命令创建相应路径并授权：

## 创建/data/yashan目录、HOME目录和DATA目录
# mkdir -p /data/yashan
# mkdir -p /data/yashan/yasdb_home
# mkdir -p /data/yashan/yasdb_data

## 直接基于父目录进行授权即可
# chown -R yashan:yashan /data/yashan

# 运行日志目录

YashanDB的运行日志目录用于存放数据库运行过程中产生的日志文件，包括数据库的run.log和slow.log、yasom和yasagent的日志。

为避免运行日志与数据文件IO相互影响，建议将数据库的运行日志目录与DATA目录配置到不同的物理盘上。同时，运行日志目录可以按需根据以下场景进行规划：

按规划统一存放
1. 规划一个目录，用于存放run.log、slow.log以及yasom和yasagent的日志。
```
# mkdir -p /data/yashan/log
```
2. 在安装操作中，该目录将作为--data-path参数的值。
按规划分开存放
1. 规划不同目录，分别存放run.log、slow.log、yasom和yasagent的日志。
2. 在安装操作中，可以将其中一个目录（例如yasom和yasagent的日志的规划目录）将作为--log-path参数的值，生成配置文件{集群名称}.toml后按需修改中另外两类日志目录相关参数再执行后续的安装部署操作，也可以等安装完成后修改对应的配置参数调整run.log和slow.log的存放目录。
采用默认机制
- 不规划运行日志目录，YashanDB将默认在HOME目录下创建子目录log（根据本手册示例，则为/data/yashan/yasdb_home/log）存放run.log、slow.log以及yasom和yasagent的日志。
- 在安装操作中，无需指定--log-path参数。

# 软件包下载

在下载软件包前，请先以yashan用户登录到安装服务器（本文以192.168.1.2作为安装服务器）。

进入到已创建的安装目录（本手册以/home/yashan/install作为安装目录）：

$ cd /home/yashan/install

请依据所需要使用的场景下载（https://download.yashandb.com/download） (opens new window)软件包或联系我们的技术支持获取软件包。

为便于表述YashanDB的安装部署过程，统一以使用yashandb-{version_number}-linux-x86_64.tar.gz安装包为例。

下载后请进行解压：

$ tar zxf yashandb-{version_number}-linux-x86_64.tar.gz

执行下述命令检查安装命令是否正常：