---
order: 1
navTitle: DEMO体验版安装
---
# DEMO体验版安装配置

试用SuccBI，可以直接使用DEMO体验版，安装配置步骤如下

\[\[toc]]

## 下载DEMO体验版压缩包{#download-package}

访问[下载地址列表](../../../whatsnew/README.md)，选择版本(推荐当前版本)，下载文件名为`SuccBi-trial-x.x.x.zip`的压缩包。

## 解压运行{#unzip}

### 在Windows上运行{#runs-on-windows}

将压缩包解压，请注意解压路径不宜太深，且路径中尽量不要带有中文和空格。Windows双击根目录下的`startup.bat`后，加载完毕后，会自动弹出浏览器访问页面，也可以直接访问<http://localhost:8080>进行初始化。

### 在mac上运行{#runs-on-mac}

使用系统自带的“归档实用工具”解压缩，请注意解压路径不宜太深，且路径中尽量不要带有中文和空格。在终端命令行运行`startup.sh`，当命令行显示

```bash
org.apache.catalina.startup.Catalina.start Server startup in xxxx ms
```

就可以访问<http://localhost:8080>进行初始化了。

## 系统初始化{#sysinit}

初始化界面如图

![初始化](./images/2025-06-05-10-18-20.png)

点击`立即试用`，以DEMO体验版压缩包自带的PostgreSQL作为默认数据库，以`admin`为账号密码直接开始试用。

![使用协议](./images/2025-06-05-11-02-36.png)

勾选`我已阅读相关协议条款`后，点击`同意并开始试用`，等待系统初始化完成后进入登录界面。

![登录界面](./images/2025-06-05-11-06-58.png)

以`admin`为账号和密码进行登录。
:::tip
5.0体验版系统初始化完成后，用户成功登录将无法正常访问DEMO，需要完成[产品许可](../../../sys-settings/basic/license.md)申请流程后，才能获取完整功能访问权限继续使用。
:::

## 更新版本{#update-war}

DEMO体验版也支持通过更换war更新版本，具体步骤如下

1. 访问[下载地址列表](../../../whatsnew/README.md)，下载新版本WAR。
2. Windows双击根目录下的`shutdown.bat`，macOS在终端命令行运行`shutdown.sh`，关闭系统。
3. 备份后删除/server/tomcat/webapps/下的`ROOT.war`和`ROOT`目录，将新版本war移动到该目录，并重命名为`ROOT.war`，同时清空tomcat的work目录。
4. Windows双击根目录下的`startup.bat`，macOS在终端命令行运行`startup.sh`，启动系统。

更多帮助见[升级WAR包](../../upgrade/war.md)。

## 常见问题{#faq}

### PostgreSQL数据库服务连接异常{#db-connect-error}

部署体验版demo时，弹出【服务器拒绝连接】对话框，提示 “请检查数据源连接的 URL 是否正确，服务器是否启动”。底层原因是系统启动时无法连接到 PostgreSQL 数据库服务器，这通常是因为数据库服务未正常启动，可以通过检查Windows系统的任务管理器窗口，查看是否存在`postgres.exe`的进程来确认。

**定位数据库未能启动的原因：**

体验版自带的是PostgreSQL数据库，它是通过命令`D:\\xxx\SuccBI-standalone-xxx\win\postgresql\postgresql.bat start`来启动的，可以通过windows的命令行工具直接执行一下启动命令，并根据输出日志来判断启动故障原因。

**方法一**：通过检查【任务管理器|详细信息】窗口，查看是否存在`postgres.exe`相关进程来判断其运行状态。

**方法二**：点击桌面【开始菜单】，选择【运行】(或按 Win+R 快捷键)，输入`cmd`后，通过命令

`D:\\xxx\SuccBI-standalone-xxx\win\postgresql\bin\pg_ctl -D "D:\\xxx\SuccBI-standalone-xxx\win\postgresql\data" status`

查看运行状态，若返回`no server running`，则说明未启动。

**可能的原因：**

1. **目录含空格或中文**：PostgreSQL 数据库采用 UTF-8 字符集，若在中文目录或包含空格的路径下启动服务，会干扰数据库的正常初始化流程，导致服务无法正常启动。可尝试将体验版 Demo 解压至无空格、纯英文路径（例如：`D:\soft\db`），完成解压后，重新启动服务。​​​

2. **端口被占用**：PostgreSQL 数据库默认使用 15430 端口，当此端口被其他进程占用时，数据库服务因无法获取必要的网络资源，从而无法正常启动。可通过在命令提示符中输入`netstat -ano | find "15430"`，若查到占用进程，说明该端口已被其他程序使用。​关闭占用进程后，重新启动服务。
