Kanass是一款开源免费的项目管理工具,包含项目管理、项目集管理、事项管理、工时管理、统计分析相关模块,工具功能完善、简洁易用、开源免费,本文将介绍如何在windows环境下快速安装与配置kanass,以快速入门上手。
1、安装
- 下载, 下载地址:Kanass - 下载, 下载安装包如tiklab-kanass.1.0.4.exe
- 安装,双击exe文件安装应用
- 启动,双击应用程序或桌面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、更新
Kanass支持自动在线更新应用程序,执行应用安装目录下update.sh或update.bat脚本更新。
5、帮助与支持
有使用过程中有什么问题可以查阅Tiklab社区、文档相关资源,或者可加入社区-技术交流群在线反馈。
文档:
https://doc.tiklab.net/document/236bfef29a50
社区:
https://developer.tiklab.net/