3. 通过管理台体验长安链
3.1. 安装长安链管理台
首先我们需要先安装最新版本的长安链管理台。
3.1.1. 管理台版本支持
目前管理台支持长安链v1.2.4、v1.2.5、v1.2.6、v2.0.0、v2.1.0、2.2.0、2.3.0、2.3.1、2.3.2、2.3.3、2.3.4、2.3.5 版本，因长安链1.X版本和2.X版本底层数据结构不同，目前相互之间不兼容。
自管理台 v2.4.0 版本起，系统支持对 v2.3.0 及以上版本的长安链进行部署与订阅。 v2.4.0 版本管理台支持在离线环境下部署 v2.3.6 版本的长安链。如需部署其他版本的长安链，需确保管理台处于联网状态。
3.1.2. 管理台环境依赖
3.1.2.1. docker环境依赖
docker版本为20.10.7或以上 docker-compose 版本为1.29.2或以上
下载地址：
https://docs.docker.com/engine/install/
https://docs.docker.com/compose/install/
若已安装，请通过命令查看版本：
$ docker -v
$ docker-compose -v
3.1.3. 部署管理台
管理平台主要由前端、后端及数据库三部分组成。通过docker的方式部署。
3.1.3.1. 代码下载
下载地址： https://git.chainmaker.org.cn/chainmaker/management-backend 下载代码：
$ git clone -b v2.4.0 --depth=1 https://git.chainmaker.org.cn/chainmaker/management-backend.git
3.1.3.2. 启动容器
下载后端代码后，进入management-backend目录，如果是X86环境，执行以下命令
$ cd management-backend
$ docker compose up
如果是ARM环境，执行以下命令
$ ARCH=arm docker compose up
启动成功后，浏览器访问localhost即可，如果发现启动过程中有端口被占用的情况，请修改docker-compose.yml文件中的端口
3.2. 通过管理台部署长安链
然后再准备一台linux服务器，建议最低配置不低于2核8g。准备就绪后我们演示如何通过管理台部署一条长安链。
| 类目 | 说明 |
|---|---|
| 区块链组织数 | 4个 |
| 区块链节点数 | 4个 |
| 区块链用户数 | 1个 |
| 共识策略 | TBFT |
| 链账户类型 | 证书账户（PermissionedWithCert） |
| 链版本号 | 最新版本 |
| 是否开启Docker-VM | 否 |
| 是否开启TLS | 是 |
3.2.1. 登录管理台
在安装好管理台之后，打开管理台进入登录页面，默认的账号为的admin账号，默认密码为a123456。如需新增其他账号，可通过admin账号，在平台账户管理处新增。
3.2.2. 申请链账户的证书文件
登录后，在长安链快速引导处，点击快速生成证书按钮，系统将自动生成四个组织证书、四个节点证书、四个用户证书。
您可以前往链账户管理-证书账户处，查看已经自动生成的证书。下一步我们根据这些证书生成对应的链配置文件。
3.2.3. 生成链配置文件
进入区块链管理页面，点击左上角到新建区块链。
长安链支持可装配性特性，可以根据用户场景需要装配出对应的长安链。在此处我们生成下文所述配置的长安链。
| 类目 | 说明 |
|---|---|
| 区块链组织数 | 4个 |
| 区块链节点数 | 4个 |
| 区块链用户数 | 1个 |
| 共识策略 | TBFT |
| 链账户类型 | 证书账户（PermissionedWithCert） |
| 链版本号 | 最新版本 |
| 是否开启Docker-VM | 否 |
| 是否开启TLS | 是 |
首先我们按照图上指示，填写生成配置文件所需的内容。其中
chainid：为该链的唯一标识
区块链名称：为该链在长安链管理台上的备注名，仅方便管理台使用实际不上链。
区块链最大容量：为单位区块最多容纳多少笔交易，此处我们保持默认值即可。
出块间隔：为最低出块间隔时长，此处我们保持默认值即可。
交易过期时间：交易最长多久有效，过期后将不再执行。此处我们保持默认值即可。
密码算法：分为国密和非国密，此处我们选择默认的非国密即可。
账户模式：为该链所支持的账户类型，此处我们选择证书模式（permissionedWithcert）
是否开启TLS：为节点和客户端通讯的时候是否加密，此处我们选择开启。
接着在共识算法处我们选择TBFT共识，并且选择上文已经申请下来的4个节点。
并在节点部署配置处选择单机部署，并填写我们准备好的linux服务器的ip地址，以及我们打算部署的4个节点所占用的网络端口。
此处需要确保端口没被占用，且网络通畅。
在合约虚拟机配置处，如果勾选了Docker-VM则需要再装相关的Docker-VM需要的环境依赖，此处我们可先不勾选。
其他的可按照默认值选定即可，全部填写完成后，点击下一步，生成链配置文件。
3.2.4. 通过脚本部署长安链
在此处我们可看到上文所生成的链配置文件zip包，将之下载到本地。
注意，此处下载的文件大小大约在50M左右，一般下载完成需要10～20秒，如果网络比较慢的话，需要等待更多的时间，请耐心等待。
然后移动到我们准备好的linux服务上，解压zip包，并进入release文件夹内执行脚本启动链。具体命令如下：
$ cd release
$ ./start.sh
执行完成后通过如下命令检查是否启动成功
$ cat */log/system.log |grep "ERROR\|put block\|all necessary"
//若看到all necessary peers connected则表示节点已经准备就绪。
当看到该图时，则表示链部署成功，此时我们可用管理台订阅该条链，以便于后续的使用。
3.2.5. 将部署好的长安链订阅到管理台内
部署完成后，我们回到管理台，下载链配置文件界面，点击下一步，进入到如图所示的订阅长安链页面。
点击订阅长安链完成订阅。
管理台将通过此处配置的链节点信息，同步长安链上的信息，和往链上发送交易。
此处配置的用户信息，将用于对所发送的交易进行交易签名。
请注意，保持管理台和链之间的网络通畅，如果订阅链失败，请查看常见问答处排查下原因，大多数情况都是网络原因导致。
3.3. 使用管理台体验长安链
现在我们开始基于管理台使用已经部署好的长安链，包括部署、调用合约、查看链上信息等。
3.3.1. 部署示例智能合约
3.3.1.1. 下载示例合约
我们先到如图所示位置下载长安链官方提供的示例合约。 其中rust合约为存证合约，部署合约时可根据下表配置对应的合约方法，具体方法如下：
| Method | Param | 说明 |
|---|---|---|
| save | file_hash,file_name,time | 根据文件哈希，文件名称，时间进行存证 |
| find_by_file_hash | file_hash | 根据文件哈希查询存证信息 |
之后我们以rust合约为例做说明。
3.3.1.2. 部署示例合约
我们先从区块链管理列表页面，点击我们已经订阅成功的长安链，进入链管理详情页面。 在里头找到合约管理，然后点击左上角的部署合约按钮，弹出如下图弹窗。
如图填写相关信息，其中
合约名称不能和已有的合约重复。
合约版本虚拟机选择wasmer
上传已下载到本地的rust合约文件
在合约调用方法处，填写上述的合约方法和参数。
3.3.2. 调用合约
当合约部署完成后，我们进入上链管理处，点击左上角的发起上链将唤起如图弹窗
选择我们刚刚部署的合约，以及要调用的方法，输入参数，点击确定发起调用。
调用成功后，我们将在上链管理列表里看到一条新的交易记录，点击交易id可跳转到区块链浏览器查看交易详情。
此处如果立刻点击交易id跳转到浏览器后发现短时间没数据，是因为管理台正在同步链上数据，一般等个5~10秒钟后会同步到数据。
3.3.3. 通过区块链浏览器查看链上信息
在区块链浏览器处，我们可查看该条链上的信息，包括区块信息，交易信息，合约信息等。
一般交易发送成功后很快将同步到信息，如果长时间没同步到信息，可参考常见问题处排查问题。
3.3.4. 其他使用介绍
更多长安链管理台的使用说明，如订阅已经存在的链，部署使用其他语言的合约，修改链的权限等等，可详见长安链管理台。