Start Process

This is a NuoDB Manager command. See NuoDB Manager.

Description

Start a transaction engine (TE), storage manager (SM) or snapshot storage manager (SSM). To create a new database use the “initialize true” argument.

Note: When using the Start Process command in creating a new database, remember to use the "initialize true" argument as shown in the Syntax.

Preview: Snapshot storage manager is a preview feature.

Preview: NuoDB encourages you to use preview features in your development projects. However, the use of preview features in production is not supported.

When starting a storage manager or snapshot storage manager, you must specify an archive directory. The default behavior is that the archive directory is not initialized (initialize is set to false). For example, you can specify the archive directory that is the result of a nuodbmgr restore database command.

Use single quotation marks ( ' ') to specify multiple arguments on the command line with the options parameter. Use --command syntax to execute more than one start process te command in one operation. Separate commands with a semi-colon. See Database Options.

Note, the agent is careful about process creation before the agent has completed a full cycle of the engine-reconnect period which is 10 seconds. If a process is started before the period expires and there are local processes on the agent, then the error is Failed to start process: ProcessBarrier[DSMResync] on [All] not ready.

Syntax

start process sm 
    host host_name[:port] 
    database database_name
    archive archive_dir
    [ initialize { true | false } ] 
    [ options option_list ]
   
start process ssm 
    host host_name[:port] 
    database database_name
    archive archive_dir
    [ snapshotArchive snapshot_dir ]
    [ initialize { true | false } ]
    [ options option_list ]
 
start process te 
    host host_name[:port] 
    database database_name 
    [ options option_list]

Parameters

Interactive Example

Note: When you create a database, remember to first start the Storage Manager and then the Transaction Engine.

Scripting Example

The same start process commands can be executed with --command as follows:

nuodbmgr --broker host --password password \
    --command "start process sm \
    database test \
    host localhost \
    archive /tmp/nuodb1 \
    initialize true"nuodbmgr --broker host --password password \
    --command "start process te \
    database test \
    host localhost \
    options '--dba-user dba --dba-password goalie'"