Skip to content

Commit

Permalink
complete s
Browse files Browse the repository at this point in the history
  • Loading branch information
chendelin1982 committed May 4, 2024
1 parent e25e54c commit bf79b2f
Show file tree
Hide file tree
Showing 4 changed files with 34 additions and 149 deletions.
Binary file added docs/apps/assets/superset-console-websoft9.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 1 addition & 2 deletions docs/apps/sqlserver.md
Expand Up @@ -39,8 +39,7 @@ Express版本与企业版相比,功能更少(例:[SQLServer 2016 各个版
2. 获取服务器名称:"我的电脑" > "属性" 中的计算机名即服务器名称
3. 打开 **SQLServer企业管理器**,填写服务器名称,并以 "Windows身份验证" 登录数据库

- 服务器名称:填写为 `.``(local)`,也可以点击 **浏览更多...** 获取
- 计算机名也可以通过 "我的电脑" > "属性" 获取
- 服务器名称:填写为 `.``(local)` 或上一步获取的名称,也可以点击 **浏览更多...** 获取
- 身份验证:选择 "Windows身份验证"
![](./assets/sqlserver-getsqlserver-websoft9.png)

Expand Down
55 changes: 6 additions & 49 deletions docs/apps/suitecrm.md
Expand Up @@ -17,62 +17,19 @@ import Meta from './_include/suitecrm.md';
Websoft9 控制台安装 SuiteCRM 后,通过 "我的应用" 查看应用详情,在 "访问" 标签页中获取登录信息。

1. 本地浏览器访问,进入登陆页面
![](http://libs.websoft9.com/Websoft9/DocsPicture/zh/suitecrm/suitecrm-init1-websoft9.png)

2. 根据向导提示,选择【Next】初始化设置
![](http://libs.websoft9.com/Websoft9/DocsPicture/zh/suitecrm/suitecrm-init2-websoft9.png)

3. 初始化设置完成,开始体验后台
![](http://libs.websoft9.com/Websoft9/DocsPicture/zh/suitecrm/suitecrm-init3-websoft9.png)

### 快速了解

- [API Versions](https://docs.suitecrm.com/developer/api/)
## 配置选项{#configs}

- 多语言(✅):需下载[语言包](https://crowdin.com/project/suitecrmtranslations/zh-CN)后再上传安装,具体参考 [Install New Languages](https://docs.suitecrm.com/admin/installation-guide/languages/install-a-new-language/)
- SMTP(✅):"Administartor" > "Admin" > "Email" > "Email Setting"

## 管理维护{#administrator}

### 配置 SMTP{#smtp}

1. 打开SuiteCRM->Administartor->Admin->Email->Email Setting,打开邮件发送设置项(Outgoing Mail Configuration)

2. 设置无误后,请点击“Send Test Email”进行测试以验证

### 安装中文包

SuiteCRM默认安装只有英文,需要中文或其他语言,需要下载语言包,然后通过后台进行安装,以中文为例,具体如下:

1. 下载[中文语言包](https://crowdin.com/project/suitecrmtranslations/zh-CN) – 存到本地电脑上
2. 以Admin身份进入SuiteCRM,进入 “admin-Admin Tools-Module loader”
![](http://libs.websoft9.com/Websoft9/DocsPicture/zh/suitecrm/suitecrm-lmodule-websoft9.png)
3. Upload file->Install it->Commit
![](http://libs.websoft9.com/Websoft9/DocsPicture/zh/suitecrm/suitecrm-linstall-websoft9.png)
4. Go to “Admin” enter “Repair” and apply “Quick repair and rebuild” for languages
![](http://libs.websoft9.com/Websoft9/DocsPicture/zh/suitecrm/suitecrm-repair-websoft9.png)
5. 退出 SuiteCRM
6. 先选择所需的语言,再登录
![](http://libs.websoft9.com/Websoft9/DocsPicture/zh/suitecrm/suitecrm-logincn-websoft9.png)

### 备份与恢复

详细请参照[SuiteCRM 备份](https://docs.suitecrm.com/developer/best-practices/#_backup)

### 升级

详细请参照[SuiteCRM 升级策略](https://docs.suitecrm.com/8.x/admin/installation-guide/upgrading/)



## 故障

#### SuiteCRM 安装向导连接数据库步骤,点击【Next】没有任何反应?

**问题原因**:经过排查,发现【Next】动作有文件404(估计是Ajax触发),即有文件无法下载程序没有反应
![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/suitecrm/suitecrm-noresponse-websoft9.png)

**解决方案**:临时购买一台香港地区的Windows服务器,在这个服务器打开浏览器安装SuiteCRM即可

#### 无法在 Studio 中编辑字段 ,报错:无法检索数据
- [SuiteCRM 备份](https://docs.suitecrm.com/developer/best-practices/#_backup)
- [SuiteCRM 升级](https://docs.suitecrm.com/admin/installation-guide/upgrading/)

问题描述:在SuiteCRM 8 中,通过 Admin → Studio → Accounts → Fields → 弹出错误 - 无法检索数据
解决方案:用[下载源码文件](https://github.com/myfluxi/SuiteCRM-Core/blob/30e44d2fb786389236f98182d304dc0a7a00cb55/public/legacy/modules/ModuleBuilder/views/view.modulefields.php) 替换 SuiteCRM 目录中 public/legacy/modules/ModuleBuilder/views/view.modulefields.php 文件
## 故障
125 changes: 27 additions & 98 deletions docs/apps/superset.md
Expand Up @@ -13,92 +13,30 @@ import Meta from './_include/superset.md';

## 入门指南{#guide}

### 初始化{#wizard}
### 登录后台{#wizard}

Websoft9 控制台安装 Superset 后,通过 "我的应用" 查看应用详情,在 "访问" 标签页中获取登录信息。

1. 通过浏览器访问,进入登录页面
![](https://libs.websoft9.com/Websoft9/DocsPicture/en/superset/superset-login-websoft9.png)

2. 输入账号密码,成功登录到 Superset 后台
![](https://libs.websoft9.com/Websoft9/DocsPicture/en/superset/superset-console-websoft9.png)
![](./assets/superset-console-websoft9.png)

3. 修改密码:【Superset Admin】>【Profiles】>【Reset my Password】
![](https://libs.websoft9.com/Websoft9/DocsPicture/en/superset/superset-resetpw-websoft9.png)

4. 修改语言:通过右上角国旗图标设置你所需的语言
![](https://libs.websoft9.com/Websoft9/DocsPicture/en/superset/superset-setlanguagech-websoft9.png)
### 分析数据

1. 登录 Superset 后,打开 "Datasets" 页面,新建一个数据库连接

### 从 MySQL 中分析数据
2. 连接成功后,系统会导入数据库表

下面以连接 Superset 从 MySQL 数据源中获取数据进行分析作为范例:

1. 登录后,依次打开:【Data】>【Databases】
![](https://libs.websoft9.com/Websoft9/DocsPicture/en/superset/superset-database-websoft9.png)

2. 点击右上角【数据库】,输入要连接的数据地址、端口、库名以及驱动([参考](https://docs.sqlalchemy.org/en/13/core/engines.html)
![](https://libs.websoft9.com/Websoft9/DocsPicture/en/superset/superset-connect-websoft9.png)

3. 点击【确认】,追加的数据库显示在列表中
![](https://libs.websoft9.com/Websoft9/DocsPicture/en/superset/superset-connect-websoft9.png)

4. 依次打开菜单栏:【Data】>【Datesets】
![](https://libs.websoft9.com/Websoft9/DocsPicture/en/superset/superset-dataset-websoft9.png)

5. 点击追加 Datasets,依次选择库、SCHEMA、Table,点击追加
![](https://libs.websoft9.com/Websoft9/DocsPicture/en/superset/superset-selecttable-websoft9.png)

6. 新追加的表已经显示在 Datasets 一览了
![](https://libs.websoft9.com/Websoft9/DocsPicture/en/superset/superset-datalist-websoft9.png)

### 安装数据库驱动{#installdriver}

Superset 支持数十种数据库,但 Superset 默认并没有安装[数据库的驱动](https://superset.apache.org/docs/databases/installing-database-drivers)(连接程序)。

因此,需要用户进入到容器后手动安装,具体如下:

```
# 范例:安装 MySQL 驱动
pip install mysqlclient
# 范例:安装 PostgreSQL 驱动
pip install psycopg2
# 范例:通过 pip 镜像仓库安装 PostgreSQL 驱动,解决网络慢的问题
pip install psycopg2 -i https://pypi.tuna.tsinghua.edu.cn/simple
```
3. 开始对表进行分析

## 配置选项

- CLI:Usage: superset [OPTIONS] COMMAND [ARGS]...
- [API](https://superset.apache.org/docs/api)
- [Flask-AppBuilder](https://flask-appbuilder.readthedocs.io/en/latest/security.html#supported-authentication-types)
- 配置文件:/src/docker/pythonpath_dev/superset_config.py,配置项参考:[config.py](https://github.com/apache/superset/blob/master/superset/config.py)

## 管理维护{#administrator}

### 更换 Logo

SuperSet 不支持从界面上更换 Logo,所以只能从源码角度进行 Logo 替换:

1. 上传 Logo 到服务器,命名为:superset-logo-horiz.png

2. 通过 docker cp 命令拷贝到容器。范例参考如下:

```
docker cp /path/superset-logo-horiz.png superset-containername:/app/superset/static/assets/images/superset-logo-horiz.png
```

> /path 是服务器上 Logo 所在的文件夹路径;superset-containername 为 SuperSet 容器名称
3. 刷新 Superset 后台页面,查看更换效果

### 配置 SMTP

Superset 配置 SMTP 发邮件的步骤:

1. 修改 *Superset 配置文件*,增加如下的 SMTP 配置段,设置好自己的参数。
- 多语言(✅):支持后台切换
- CLI:`superset [OPTIONS] COMMAND [ARGS]...`
- [配置文件](https://github.com/apache/superset/blob/master/superset/config.py)*./src/docker/pythonpath_dev/superset_config.py*
- SMTP(✅):配置文件中增加如下的 SMTP 配置段,重启应用后生效

```
# smtp server configuration
Expand All @@ -112,42 +50,33 @@ Superset 配置 SMTP 发邮件的步骤:
SMTP_MAIL_FROM = 'websoft9@163.com'
```

2. 重启 Superset 容器后生效
## 管理维护{#administrator}

- 更换 Logo:替换容器文件 */app/superset/static/assets/images/superset-logo-horiz.png*
- 找回密码:Superset 数据库中运行下面的 SQL 语句后,用户 `admin` 的密码就被设置为 `admin123`
```
sudo docker restart superset-app
update ab_user set password='pbkdf2:sha256:150000$w8vfDHis$b9c8fa353137417946766ed87cf20510da7e1e3a7b79eef37426330abef552bf' where username='admin';
```
- 安装数据库驱动:Superset 需在容器中安装[数据库的驱动](https://superset.apache.org/docs/databases/installing-database-drivers)方可连接对应的数据库
```
# 范例:安装 MySQL 驱动
pip install mysqlclient
### 修改密码

登录 Superset 后台,修改密码:【Settings】>【User】>【Info】

![Superset 修改密码](https://libs.websoft9.com/Websoft9/DocsPicture/en/superset/superset-resetpw-websoft9.png)

### 找回密码

如果用户忘记了密码,需要连接 SuperSet 数据库,并运行重置密码的 SQL 命令。

运行如下的 SQL 语句后,用户 admin 的密码就被设置为`admin123`
# 范例:安装 PostgreSQL 驱动
pip install psycopg2
```
update ab_user set password='pbkdf2:sha256:150000$w8vfDHis$b9c8fa353137417946766ed87cf20510da7e1e3a7b79eef37426330abef552bf' where username='admin';
# 范例:通过 pip 镜像仓库安装 PostgreSQL 驱动,解决网络慢的问题
pip install psycopg2 -i https://pypi.tuna.tsinghua.edu.cn/simple
```


## 故障

#### Superset 容器中安装数据库驱动报错
#### Superset 容器安装驱动报错

**现象描述**:ERROR: Could not install packages due to an OSError: [Errno 13] Permission denied: '/home/superset'
**现象描述**:ERROR: Could not install packages due to an OSError: [Errno 13]
Check the permissions.

**原因分析**:权限不足

**解决方案**:在 Websoft9 控制台中的**容器**管理界面,执行容器命令(默认会以 roo 用户连接),然后再安装驱动

#### Superset 密码正确,但仍然登录失败?{#loginfail}

**现象描述**:用户名和密码完全正确,但 Superset 仍然登录失败,错误信息 Invalid login, Please try again

**原因分析**:暂时未知

**解决方案**:重启所有 Superset 容器
**解决方案**:以 `root` 身份进入容器命令模式,再安装驱动

0 comments on commit bf79b2f

Please sign in to comment.