Kanass快速安装配置教程(入门级)

Kanass是一款国产开源免费的项目管理工具，工具简洁易用、开源免费，本文将介绍如何快速安装配置kanass，以快速上手。

1、快速安装

1.1 Linux 安装

点击官网 -> 演示与下载 ->下载，下载Linux安装包，安装包名字为tiklab-kanass-1.0.4.rpm，上传的要安装的服务器
上传之后执行以下命令安装，默认安装在opt 目录下

rpm -ivh --replacefiles --nodeps tiklab-kanass-1.0.4.rmp

安装之后出现一个名字为 tiklab-kanas的文件夹，tiklab-kanass的文件夹下的bin文件夹，执行 sh startup.sh 命令，启动项目

cd tiklab-kanasssh startup.sh

1.2 Docker 安装

点击官网 -> 演示与下载 ->下载，下载Docket安装包，安装包名字为tiklab-kanass.1.0.4.tar.gz，下载完成执行以下命令加载镜像

docker load -i tiklab-kanass-1.0.4.tar.gz

加载完成后，执行以下命令镜像启动

docker run -itd -p 9500:9500 tiklab-kanass:1.0.4

1.3 Windows 安装

点击官网 -> 演示与下载 ->下载，下载Windows安装包，安装包名字为tiklab-kanass.1.0.4.exe，双击安装包，跟着引导安装
安装之后在程序中出现Kanass的应用，点击启动

1.4 Mac 安装

点击官网 -> 演示与下载 ->下载，下载Mac安装包，安装包名字为tiklab-kanass-1.0.4.dmg
双击安装包安装Kanass，安装完成之后再启动图出现Kanass图标，点击图标启动

2、登录

启动成功控制台会显示应用访问地址，在浏览器输入http://ip:9500 就可访问系统了，默认登录方式为本地登陆模式，默认登录帐号密码为admin/123456

登录页

首页

3、自定义配置

Kanass 私有部署版本可以对数据库，启动端口、数据存放地址、dcs（缓存配置），dfs(附件存储），登录地址这些参数进行配置

下表展示自定义配置文件的地址：

系统	默认位置
Windows	默认在安装目录 --> conf -> application.yaml 目录下
Mac	默认在app下的Contents --> conf -> application.yaml 目录下
Linux	默认在/opt/tiklab-kanass/conf/ application.yaml 目录下
Docker	默认在镜像文件内/usr/local/tiklab-kanass/conf/application.yaml 目录下

3.1 启动端口

应用启动端口可自定义，默认为9500，可以修改为其他端口；

# 端口
server:port: 9500

属性	值
server.port	系统启动的端口号（可更改）

3.2 数据库

数据库需要在jdbc 和 postgresql 两个部分修改，可以修改数据库地址与端口，账号与密码要改成相应的，数据库端口必须一致

属性	说明
postgresql.embbed.enable	是否使用内嵌数据库，true:使用 false:不使用。如果配置为false，需要把该文件中jdbc下的数据库连接信息更改为自己的数据库地址，用户名以及密码。
postgresql.database	是否使用内嵌数据库默认连接的数据库，默认为tiklab_kanass如果更改次默认值需要把jdbc下的数据库连接信息更改为新的数据地址。
postgresql.db.port	使用内嵌数据库的启动端口，默认为9501，如果更改需要同时把jdbc.url中的数据库连接地址端口更改。
postgresql.db.username	使用内嵌数据库的用户名，默认为postgres，如果更改需要同时把jdbc.username中的数据库连接地址用户名更改。
postgresql.db.password	使用内嵌数据库的密码，默认为darth2020，如果更改需要同时把jdbc.password中的数据库连接地址密码更改。
postgresql.db.address	使用内嵌数据库的数据库文件保存位置，默认为${DATA_HOME}/postgresql，即默认的应用数据目录下的postgresql目录。注：如果更改该目录，该路径目录必须为空目录，否则会导致数据库无法启动。
jdbc.url	默认是：jdbc:postgresql://localhost:9501/tiklab_kanass?stringtype=unspecified 其中 9501 为端口号，tiklab_kanass 为数据库名字，这两个可更改但是端口号必须与postgresql.db.port 保持一致数据库名字必须与postgresql.database 保持一致
jdbc.username	数据库登录名，必须与postgresql.db.username一致
jdbc.password	数据库登录密码，必须与postgresql.db.password一致

3.5 数据存储

DATA_HOME为数据文件存放地址。

3.4 统一登录

Tiklab全家桶中有用于统一登录的Soular账号管理工具，即使用统一使用Soular的用户，部门等，这样配置可以让一个用户同时使用多个应用。需要安装Soular，具体安装见Soular 文档。

属性	说明
soular.embbed.enable	是否为统一登录，true: 本地模式 false：统一模式
soular.address	Soular的应用地址，统一模式必填