Standalone mode is a simplified deployment mode that embeds the Shard Server into the Name Server process. Instead of running three separate processes (Meta Server, Shard Server, and Name Server), standalone mode requires only two processes (Meta Server and Name Server).
This mode is suitable for:
NOTEStandalone mode is not recommended for production environments as it lacks shard-level fault isolation and horizontal scaling capabilities.
Feature | Standard Mode | Standalone Mode |
|---|---|---|
| Processes required | Meta Server + Shard Server + Name Server | Meta Server + Name Server |
| Configuration complexity | Multiple server configs | Name Server config only |
| Resource usage | Higher (multiple processes) | Lower (merged processes) |
| Use case | Production, distributed | Development, single-machine |
Add the [Standalone] section to name-server.config:
Ini[Standalone] enabled = true shard_id = 1 data_path = /data/ultipa/shard resource_path = /data/ultipa/resource
Parameter | Default | Description |
|---|---|---|
enabled | false | Enables or disables standalone mode. |
shard_id | 1 | Unique identifier for the embedded shard. |
data_path | (empty) | Shard data storage path. Uses Server.data_path if empty. |
resource_path | (empty) | Resource file path (e.g., full-text search dictionaries). Uses data_path if empty. |
Ini[Server] addr = 0.0.0.0:60061 private_addr = 127.0.0.1:60161 id = 1 meta_server_addrs = 127.0.0.1:50061 data_path = /data/ultipa worker_num = 10 authorized = true [Log] level = 3 stdout = true [Standalone] enabled = true shard_id = 1 data_path = /data/ultipa/shard resource_path = /data/ultipa/resource
Bashcd /opt/ultipa ./start_standalone.sh
The script automatically copies the standalone configuration template, creates necessary data directories, starts Meta Server and Name Server, and checks process status.
Bash# Copy standalone config template cp config/name-server-standalone.config config/name-server.config # Start Meta Server ./meta-server & sleep 3 # Start Name Server (with embedded shard) ./name-server &
engine_type=default. Other engine types are not compatible with standalone mode.