← ShimoDocs Suite Deployment Documentation
This article explains how to disable the built-in MySQL in the ShimoDocs installer and configure Dameng DM8 as a third-party relational database. After configuration, the installer will check database login, network connectivity, and table creation permissions. Once the checks pass, deployment can continue.
1. Preparation Before Configuration
Before starting, please ensure:
- Dameng DM8 is installed and running properly.
- The deployment node can access the host and port of the Dameng database.
- The database host, port, USERNAME, and PASSWORD are ready.
- The database account has permissions to log in, connect, create tables, and delete tables.
- The Dameng database has been configured according to the required MySQL compatibility mode. For detailed instructions, please refer to the Dameng Database Integration Configuration Guide.
Tip
The IPs, ports, and accounts in this article are examples. Please use actual environment information for configuration, and do not record real information in external documents or screenshots. PASSWORD
2. Enter Advanced Settings
In the “Configuration” step of the installer, after completing the network, target environment, and node information configuration, expand the “Advanced Configuration” at the bottom of the page.
3. Deselect the Built-in Component MySQL
In the “Middleware Services” section, deselect MySQL.
After deselection, the installer will no longer install the built-in MySQL component and will use a pre-prepared Dameng database. For other middleware, whether to use the built-in service should be chosen according to the actual deployment plan.
4. Open Third-Party Middleware Configuration
In the “Third-Party Middleware” section, click “Configure.”
5. Configure Dameng Database
- Select “RDB Relational Database.”
- Enable “Use Third-Party Relational Database.”
- In the “Dialect” section, select DM (Dameng).
- Fill in the database connection information.
| Configuration Item | Description |
|---|---|
| Host | The IP address or accessible hostname of the Dameng database |
| Port | The listening port of the Dameng database, usually default is 5236, depending on the actual configuration |
| USERNAME | Account used to connect to the database |
| PASSWORD | The PASSWORD corresponding to the database account |
| DSN | Automatically generated by the installer based on the above information, no manual input required |
- After confirming the information is correct, click “Verify and Save”.
6. Confirm Verification Results
The installer will check the following items:
- Login: The database account can log in normally.
- Connectivity: The deployment environment can access the database.
- Table Creation Permissions: The database account has permissions to create and drop tables.
Once all checks show “Success”, close the configuration window and return to the installer’s “Configuration” page.
If there are any failures, please check according to the page prompts:
- Whether the host and port are entered correctly.
- Whether the network between the deployment node and the database is connected.
- Whether the USERNAME and PASSWORD are correct.
- Whether the database account has the required permissions.
- Whether the Dameng database service and MySQL compatibility configuration are functioning properly.
7. Continue Initializing Deployment
After returning to the “Configuration” page, ensure that MySQL remains unchecked, and then click “Initialize Deployment” to continue completing the deployment overview, checks, and execution steps.
Tip
Before initializing deployment, please confirm once again that the Dameng configuration has been saved and all validation items have passed.