Kanass从入门到精通-安装简明教程

在我们日常研发过程中，为了有效跟踪、管理项目，以保障项目有序、高效交付通常会使用一些项目管理工具如jira、redmine等。今天给大家介绍一款国产开源免费的项目管理工具-Kanass，工具包含项目管理、项目集管理、事项管理、工时管理、统计分析相关模块，简洁易用、开源免费。本文将介绍如何快速安装部署kanass，以快速入门。

1、快速安装

1.1 Linux 安装

此处安装包为linux centos rpm包。

• 下载，下载地址:Kanass - 下载，下载安装包如tiklab-kanass-1.0.4.rpm
• 安装，执行rpm命令安装，安装路径默认为/opt目录下

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

• 启动，启动成功控制台会显示状态及应用访问地址

cd /opt/tiklab/tiklab-kanass
sh startup.sh

1.2 Docker 安装

• 下载， 下载地址:Kanass - 下载， 下载安装包如tiklab-kanass.1.0.4.tar.gz
• 安装，执行docker命令加载镜像文件

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

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

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

1.3 Windows 安装

• 下载， 下载地址:Kanass - 下载， 下载安装包如tiklab-kanass.1.0.4.exe
• 安装，双击exe文件安装应用
• 启动，双击应用程序或桌面Kanass应用图标，启动应用

1.4 Mac 安装

• 下载， 下载地址:Kanass - 下载， 下载安装包如tiklab-kanass.1.0.4.dmg
• 安装，双击dmg文件安装应用
• 启动，双击应用程序或桌面Kanass应用图标，启动应用

2、登录

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

登录页 

首页 

3、自定义配置

通过修改application.yaml配置文件进行相关自定义配置，如修改启动端口、配置选择使用内嵌还是外部DB、使用默认本地登录还是使用soular统一登录及数据存储目录等。

各环境配置文件存放路径为：

系统	默认位置
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 数据库

kanass默认使用内嵌DB，如需要使用外部DB则可通过修改配置进行自定义。

jdbc:
  driverClassName: org.postgresql.Driver
  url: jdbc:postgresql://localhost:9501/tiklab_kanass?stringtype=unspecified
  username: postgres
  password: darth2020

postgresql:
  embbed:
    enable: true
  database: tiklab_kanass
  db:
    port: 9501
    username: postgres
    password: darth2020
    address: ${DATA_HOME}/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.3 数据存储目录

DATA_HOME为文件存放目录。

# 数据存放地址
DATA_HOME: /opt/tiklab/kanass

属性	值
DATA_HOME	数据文件存放地址

3.4 统一登录

Kanass安装默认使用本地登陆模式，如需要通过soular使用统一帐号及认证登陆，则需要修改配置。

#soular config
soular:
  embbed:
    enable: true
  #address: http://e.tiklab.net

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

4、帮助与支持

有使用过程中有什么问题可以查阅Tiklab社区、文档相关资源，或者可加入社区-技术交流群在线反馈。

文档:

Kanass - 文档 (tiklab.net)

社区：

TikLab - 社区