Kanass入门到实战(1) - 安装教程

 Kanass是一款国产开源免费、简洁易用的项目管理工具，包含项目管理、项目集管理、事项管理、工时管理、统计分析等相关模块，工具功能完善，简洁易用，本文将介绍如何快速安装配置Kanass，以快速上手。

1、安装

1.1 Linux系统安装

centos

• 下载：下载Linux下的centos安装包，或使用命令在线下载安装包

wget -O tiklab-kanass-1.2.9.rpm https://install.tiklab.net/app/install/kanass/1.2.9/tiklab-kanass-1.2.9.rpm

• 安装：上传之后执行以下命令安装，默认安装在opt 目录下

sudo rpm -ivh tiklab-kanass-1.2.9.rmp

• 启动：安装之后,会在opt文件夹下出现一个名字为 tiklab-kanass的文件夹，进入tiklab-kanass的文件夹下的bin文件夹，执行./kanass start 命令，启动项目

cd opt/tiklab-kanass/bin

./kanass start

ubuntu

• 下载：下载Linux下的ubuntu安装包，或使用命令在线下载安装包

wget -O tiklab-kanass-1.2.9.deb https://install.tiklab.net/app/install/kanass/1.2.9/tiklab-kanass-1.2.9.deb

• 安装：上传之后执行以下命令安装，默认安装在opt 目录下

dpkg -i tiklab-kanass-1.2.9.deb

• 启动：安装之后，会在opt文件夹下出现一个名字为 tiklab-kanass的文件夹，进入tiklab-kanass的文件夹下的bin文件夹，执行 ./kanass start命令，启动项目

cd opt/tiklab-kanass/bin

./kanass start

1.2 Docker系统安装

• 下载：下载Docker安装包，或直接使用命令在线下载安装包

wget -O tiklab-kanass-1.2.9.tar.gz https://install.tiklab.net/app/install/kanass/1.2.9/tiklab-kanass-1.2.9.tar.gz

• 安装：下载完成后，执行以下命令加载镜像

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

• 启动：执行以下命令启动镜像

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

1.3 Windows系统安装

• 下载：下载Windows安装包

• 安装：双击安装包后，依次点击下一步->安装->完成

• 启动：kanass安装成功后会弹出启动页面，点击启用应用

1.4MacOs系统安装

• 下载：下载MacOs安装包  

• 安装：下载完成后会得到tiklab-kanass-1.2.9.dmg格式类似的可执行文件，双击可执行文件 --> 将tiklab-kanass-1.2.9.app拉入应用程序中即可

• 启动：安装完成之后再启动图出现Kanass图标，点击图标启动

 2、登录

启动成功后，在浏览器输入http://ip:9500访问系统，默认账号密码admin/12345

登录

首页

3、配置

通过修改application.yaml配置文件，可以进行自定义配置，如修改端口、配置选择使用内嵌还是外部DB、修改数据存储目录等。

application.yaml的存放位置：

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

3.1 自定义端口

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

#web config

server:

   port: 9500

3.2 自定义DB配置

kanass默认使用内嵌DB，如需要使用外部DB则可通过修改配置进行自定义。数据库修改需要同时修改jdbc 和 postgresql ，可以修改数据库地址与端口，账号与密码要改成相同的，数据库端口必须一致

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为数据存放目录

系统	默认存储目录
Windows	C:\tiklab\tiklab-kanass
Linux	/opt/tiklab/tiklab-kanass
Mac	/Applications/.tiklab/tiklab-kanass
Docker	/opt/tiklab/tiklab-kanass