SliverWorkspace文档中心

Appearance

SliverWorkspace 安装文档 ​

1. 准备工作 ​

  • 服务器环境 硬件要求 推荐配置：

    CPU ：不低于至强E3 4核心8线程

    内存： 不低于10G可用内存

    硬盘： 至少50G可用空间（用于保存分析结果）

  • 网络要求：

    要求SliverWorkspace部署在稳定网络环境

    安装过程中需要联网安装docker及下载docker镜像文件

  • 防火墙：

    SliverWorkspace 运行时使用如下端口 （安装时请避免与已有端口冲突）：

    端口备注
    80Nginx Web服务
    443Nginx Web服务
    8443Java 后端服务
    10443WebSocket 长链接
    5433postgreSQL数据库服务（2.7版本改为5433，降低与服务器原有数据库冲突概率）

2. 软件安装 ​

SliverWorkspace部署基于docker虚拟化实现，便于快速安装部署和迁移。

  • 推荐部署系统发行版 Linux Ubuntu18.04/20.04/22.04 Server版；CentOS 7/8

  • 不兼容CentOS 6.10，该版本下docker版本过低

  • 不兼容Windows10，MacOS 该系统下docker基于虚拟机运行与Linux下存在较大差异。

  • 不兼容Windows WSL Linux运行环境

    安装/解压后运行（CentOS因需要安装docker，需要在root账户下运行）：

shell
# 1. 解压缩
$ tar -zxvf sliverworkspace-community.tar.gz

# 2. 切换到解压缩后目录
$ cd SliverWorkspace-${version}

# 3. 运行安装脚本
$ bash setup.bin
  • 查看安装脚本内容：
shell
$ head -n 55 setup.bin
  • 安装完成应该可以看到以下内容：
shell
$ Creating sliverworkspace-dababase ... done
$ Creating sliverworkspace-backend  ... done
$ Creating sliverworkspace-frontend ... done
$ Creating sliverworkspace-server   ... done
  • 安装完成查看容器运行情况：
shell
# 1. 切换到安装目录/bin 目录下
$ cd SliverWorkspace-${version}/bin

# 2. 查看容器运行情况
$ docker-compose ps

3. 访问SliverWorkspace ​

  • 默认情况下SliverWorkspace使用了自签名证书对通信过程加密，如果有需要可以购买域名并申请正式证书

  • WebKit内核浏览器（Chrome，Edge等）地址栏输入https://ip打开首页，ip为部署服务器ip地址

    首次访问如果提示：您的连接不是私密连接，请点击按钮高级，继续访问。

  • Firefox浏览器，需要在浏览器地址依次输入https://ip:8443 https://ip:10443 添加端口例外

4. 软件卸载： ​

shell
# 1. 切换到安装目录/bin 下
$ cd ${install-dir}/bin/

# 2. 停止并卸载正在运行的容器
$ docker-compose down

5. 非root用户运行docker ​

shell
# 首先创建docker用户组，如果docker用户组存在可以忽略
$ sudo groupadd docker

# 把用户添加进docker组中
$ sudo gpasswd -a ${USER} docker

# 重启docker
$ sudo service docker restart
#或者
$ sudo systemctl restart docker

# 如果普通用户执行docker命令，如果提示get …… dial unix /var/run/docker.sock权限不够，则修改/var/run/docker.sock权限，使用root用户执行如下命令，即可
$ sudo chmod a+rw /var/run/docker.sock

​

6. 手动安装docker & docker-compose： ​

  • Ubuntu 18.04/20.04/22.04 安装docker ​

shell
#下载安装脚本安装
$ wget -qO- https://get.docker.com/ | sh
#安装docker-compose
$ sudo apt-get install docker-compose
  1. 卸载旧版本docker Docker 的旧版本名称为：docker 、 docker-engine 或者 docekr-io。 如果安装过旧版本的需要先卸载：
shell
$ sudo apt-get remove docker docker-engine docker.io

  1. 安装最新版本的 Docker 最新版本的 Docker 分两个版本，docker-ce(Community Edition)和docker-ee(Enterprise Edition)。CE版本是免费的，如果我们学习或者一般应用，CE足够。我们安装社区版： 由于docker安装需要使用https，所以需要使 apt 支持 https 的拉取方式。

    2.1 安装 https 相关的软件包

shell
$ sudo apt-get update # 先更新一下软件源库信息
$ sudo apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \
    software-properties-common

​ 2.2 设置apt仓库地址，鉴于国内网络问题，强烈建议使用国内地址 ​ 添加 Docker 官方apt仓库（使用国外源） ​ 执行该命令时，如遇到长时间没有响应说明网络连接不到docker网站，需要使用国内的

shell
# 添加 Docker 官方的 GPG 密钥
$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

# 设置稳定版本的apt仓库地址
$ sudo add-apt-repository \
   "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
   $(lsb_release -cs) \
   stable"
   
# 添加 阿里云 的apt仓库（使用国内源）
$ curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo apt-key add -
$ sudo add-apt-repository \
     "deb [arch=amd64] https://mirrors.aliyun.com/docker-ce/linux/ubuntu \
     $(lsb_release -cs) \
     stable"

​ 2.3 安装 docker软件

shell
$ sudo apt-get update
# 安装最新版的docker
$ sudo apt-get install docker-ce 

# 如果要安装指定版本的docker，则使用下面的命令：
$ apt-cache policy docker-ce # 查看可供安装的所有docker版本
$ sudo apt-get install docker-ce=18.03.0~ce-0~ubuntu # 安装指定版本的docker

# 检查docker是否安装成功
$ docker --version # 查看安装的docker版本

​ 2.4 安装 docker-compose

shell
# 安装docker-compose
$ sudo apt-get install docker-compose
# 查看docker-compose 版本
$ docker-compose version

#或者
$ sudo apt-get install python-pip
$ sudo pip install docker-compose

该 centos-extras 库必须启用。默认情况下，此仓库是启用的，但是如果已禁用它，则需要重新启用它。

建议使用 overlay2 存储驱动程序。

将当前用户加入sudo用户列表，修改配置文件，避免每次换切用户

shell
#安装环境所需 编辑sudo权限#避免每次都要切回root
$ vi /etc/sudoers
# 找到这一行
$ root      ALL=(ALL)       ALL
# 添加一行，bootsir为当前用户名      
$ boosir    ALL=(ALL)       ALL
# 找到这一行
$ Defaults  secure_path = /sbin:/bin:/usr/sbin:/usr/bin
# 修改为
$ Defaults  secure_path = /sbin:/bin:/usr/sbin:/usr/bin:/usr/local/bin

卸载旧版本

较旧的 Docker 版本称为 docker 或 docker-engine 。如果已安装这些程序，请卸载它们以及相关的依赖项。

shell
$ sudo yum remove docker \
                  docker-client \
                  docker-client-latest \
                  docker-common \
                  docker-latest \
                  docker-latest-logrotate \
                  docker-logrotate \
                  docker-engine

安装 Docker Engine-Community

使用 Docker 仓库进行安装

在新主机上首次安装 Docker Engine-Community 之前，需要设置 Docker 仓库。之后，您可以从仓库安装和更新 Docker。

设置仓库

shell
# 安装所需的软件包。yum-utils 提供了 yum-config-manager ，并且 device mapper 存储驱动程序需要 device-mapper-persistent-data 和 lvm2
$ sudo yum install -y yum-utils device-mapper-persistent-data lvm2

# 使用以下命令来设置稳定的仓库。
$ sudo yum-config-manager \
    --add-repo \
    https://download.docker.com/linux/centos/docker-ce.repo

安装 Docker Engine-Community

安装最新版本的 Docker Engine-Community 和 containerd，或者转到下一步安装特定版本：

$ sudo yum install docker-ce docker-ce-cli containerd.io

如果提示您接受 GPG 密钥，请选是。

有多个 Docker 仓库吗？

如果启用了多个 Docker 仓库，则在未在 yum install 或 yum update 命令中指定版本的情况下，进行的安装或更新将始终安装最高版本，这可能不适合您的稳定性需求。

Docker 安装完默认未启动。并且已经创建好 docker 用户组，但该用户组下没有用户。

要安装特定版本的 Docker Engine-Community，请在存储库中列出可用版本，然后选择并安装：

  1. 列出并排序您存储库中可用的版本。此示例按版本号（从高到低）对结果进行排序。
shell
$ sudo yum list docker-ce --showduplicates | sort -r
docker-ce.x86_64  3:18.09.1-3.el7                     docker-ce-stable
docker-ce.x86_64  3:18.09.0-3.el7                     docker-ce-stable
docker-ce.x86_64  18.06.1.ce-3.el7                    docker-ce-stable
docker-ce.x86_64  18.06.0.ce-3.el7                    docker-ce-stable
  1. 通过其完整的软件包名称安装特定版本，该软件包名称是软件包名称（docker-ce）加上版本字符串（第二列），从第一个冒号（:）一直到第一个连字符，并用连字符（-）分隔。例如：docker-ce-18.06.3.ce-3.el7。
shell
$ sudo yum install docker-ce-18.06.3.ce-3.el7 docker-ce-cli containerd.io

启动 Docker。

shell
$ sudo systemctl start docker
  • 安装 docker-compose
shell
# 或者github直接下载
$ sudo curl -L https://github.com/docker/compose/releases/download/1.25.0/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
$ sudo chmod +x /usr/local/bin/docker-compose

7. 附录：CentOS 7/8 防火墙设置 ​

shell
# 启动firewall：
$ sudo systemctl start firewalld.service

# 设置开机自启：
$ sudo systemctl enable firewalld.service

# 重启防火墙：
$ sudo systemctl restart firewalld.service

# 检查防火墙状态是否打开：
$ sudo firewall-cmd --state

# 开启软件服务端口
$ sudo firewall-cmd --zone=public --add-port=80/tcp       --permanent
$ sudo firewall-cmd --zone=public --add-port=443/tcp      --permanent
$ sudo firewall-cmd --zone=public --add-port=8443/tcp     --permanent
$ sudo firewall-cmd --zone=public --add-port=10443/tcp    --permanent
# 数据库可选
$ sudo firewall-cmd --zone=public --add-port=5433/tcp     --permanent
# 重启防火墙生效
$ sudo systemctl restart firewalld

# 查看
$ sudo firewall-cmd --zone=public --query-port=80/tcp

# 删除
$ sudo firewall-cmd --zone=public --remove-port=80/tcp    --permanent
$ sudo firewall-cmd --zone=public --remove-port=443/tcp   --permanent
$ sudo firewall-cmd --zone=public --remove-port=8443/tcp  --permanent
$ sudo firewall-cmd --zone=public --remove-port=10443/tcp --permanent
$ sudo firewall-cmd --zone=public --remove-port=5433/tcp  --permanent
# 重启防火墙生效
$ sudo systemctl restart firewalld

# 查看端口
$ netstat -ntlp
# 或
$ sudo firewall-cmd --list-ports

© 2019 - SliverWorkspace. All rights reserved.