Starting a Storage Manager

A Storage Manager (SM) may have already been started when you created the database. For more information, see Creating a Database.

Having created an archive and a database, you may start an SM using the start process command.

nuocmd start process --db-name <database name> --engine-type SM  --archive-id <archive ID> --server-id server ID 

Note: The start process command is used to explicitly start one or more SMs. You can also start one or more SMs implicitly using the start database command - for more information, see Restarting a Database. The start process command and the start database command are issued using NuoDB Command (nuocmd). For more information on NuoDB Command and other command line tools, see Command Line Tools.

Parameters

This section describes parameters that can be provided when starting a SM.

Parameter

Description

Comments

--db-name

The database name associated with the archive previously created.

See Creating an Archive for more information.
--engine-type The type of process to be started. SM is case-sensitive.
--archive-id The unique ID of the archive already created. For information on the archive ID previously generated, see Creating an Archive.

--server-id

The unique ID for the admin process on the host machine (where the archive exists).

-

--default-options Starts the database with the database options provided. Separate options values and options using a space character. For more information about the available database options, see Database Options.

Example

The following example shows how to request an SM on the archive object already created (see Creating an Archive) by specifying --archive-id 0 (which is bound to server0).

nuocmd start process --db-name test --engine-type SM --archive-id 0 --server-id server0
Process(archive_id=0, db_name=test, durable_state=REQUESTED, engine_state=UNKNOWN, engine_type=SM, labels={}, options={log-over-conn: enable, verbose: error,flush,warn, database: devtest, region-name: Default, engine-type: SM, archive-id: 0, geo-region: 0, commit: safe, archive: /var/opt/nuodb/production-archives/test}, region_name=Default, server_id=server0, start_id=1)

Note: The create database command documented here specifies:
- The name of the database where the SM is to be started (test).
- The type of process to be started (SM).
- The archive ID of the archive previously created (0).
- The NuoDB Admin server where the SM is to started (server0).