sward是一个开源免费的项目管理软件，之前简单介绍过它的功能，今天来介绍一下私有部署版本在MacOS环境下的安装与配置。
1. 安装
- 下载，下载Mac安装包
- 安装，双击安装包后，依次点击下一步->安装->完成
- 启动，sward安装成功后会弹出启动页面，点击启用应用
2. 登录
在浏览器输入http://ip:9600访问系统， 默认使用本地登录模式，默认登录帐号密码为admin/123456
项目首页：
3. 自定义配置
sward 私有部署版本可以对数据库，启动端口、数据存放地址、登录地址这些参数进行配置，自定义配置文件的地址默认在app下的Contents --> conf -> application.yaml 目录下
3.1 启动端口
应用启动端口可自定义，默认为9600，可以修改为其他端口；
# 端口
server:
port: 9600
| 属性 | 值 |
|---|---|
| server.port | 系统启动的端口号（可更改） |
3.2 数据库
数据库需要在jdbc 和 postgresql 两个部分修改，可以修改数据库地址与端口，账号与密码要改成相应的，数据库端口必须一致
postgresql:
embbed:
enable: true
database: tiklab_sward
db:
port: 9601
username: postgres
password: darth2020
address: ${DATA_HOME}/postgresql
jdbc:
driverClassName: org.postgresql.Driver
url: jdbc:postgresql://localhost:9601/tiklab_sward?stringtype=unspecified
username: postgres
password: darth2020
| 属性 | 说明 |
|---|---|
| postgresql.embbed.enable | 是否使用内嵌数据库，true:使用 false:不使用。如果配置为false，需要把该文件中jdbc下的数据库连接信息更改为自己的数据库地址，用户名以及密码。 |
| postgresql.database | 是否使用内嵌数据库默认连接的数据库，默认为matflow-ee如果更改次默认值需要把jdbc下的数据库连接信息更改为新的数据地址。 |
| postgresql.db.port | 使用内嵌数据库的启动端口，默认为9201，如果更改需要同时把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:9601/sward_ee?stringtype=unspecified其中 9601 为端口号，sward_ee 为数据库名字，这两个可更改但是端口号必须与postgresql.db.port 保持一致数据库名字必须与postgresql.database 保持一致 |
| jdbc.username | 数据库登录名，必须与postgresql.db.username一致 |
| jdbc.password | 数据库登录密码，必须与postgresql.db.password一致 |
3.3 数据存储
DATA_HOME为数据文件存放地址。
| 属性 | 值 |
|---|---|
| DATA_HOME | /Applications/tiklab/tiklab-sward |
3.4 统一登录
统一登录，即使用统一使用Soular的用户，部门等，这样配置可以让一个用户同时使用多个应用。需要安装Soular，具体安装见Soular 文档。
#soular
auth:
type: local
soular:
address: http://soular.tiklab.net
expire: 86400
| 属性 | 说明 |
|---|---|
| type | local:本地登录 soular:统一登录。配置文件中默认为local |
| address | 配置统一登录时需更改address为soular地址，http://ip:9100， IP为安装soular的机器IP |
4. 帮助与支持
tiklab提供了详细的使用文档，你也可以随时向活跃的社区寻求帮助！
sward下载：download.tiklab.net/sward
sward使用文档：doc.tiklab.net/document/23…
tiklab社区：developer.tiklab.net/
