IBM PureData System for Analytics, Version 7.1

The nzstart command

Use the nzstart command to start system operation after you stop the system. The nzstart command is a script that initiates a system start by setting up the environment and starting the startup server.

Note: You must run nzstart on the host. You cannot run it remotely.

Syntax

The nzstart command uses the following syntax:

nzstart [options]

Inputs

The nzstart command takes the following inputs:

Table 1. The nzstart inputs
Input	Description
nzstart -h	Displays help.
nzstart -D `dataDir`	Specifies the data directory to use. By default, it is `install_dir`/data.
nzstart -log `file`	Sends the daemon output to the log file instead of to /dev/null.
nzstart -noWait	Does not wait for the system to go online.
nzstart -timeout `value`	Specifies the number of seconds to wait for the command to complete before it exits with a timeout error. The default is 300.
nzstart -newSystem	Start a new IBM® Netezza® system. (Used only the first time a new system is started.)

Description

The nzstart command does the following:

Privileges required

You must be able to log on to the host system as the nz user.

Common tasks

Use the nzstart command to start system operation after you stop the IBM Netezza system. The nzstart command verifies the host configuration to ensure that the environment is configured correctly and completely; it displays messages to direct you to files or settings that are missing or misconfigured.

If the system is unable to start because of a hardware problem, the command typically displays a timeout error message. You can review the sysmgr.log file to identify the problems that might cause the nzstart command to fail.

For IBM Netezza 1000 systems, a message is written to the sysmgr.log file if there are any storage path issues that are detected when the system starts. The log displays a message similar to mpath -issues detected: degraded disk path(s) or SPU communication error, which helps to identify problems within storage arrays. For more information about how to check and manage path failures, see Hardware path down.

Notes

The nzstart script has a default time out, which is 120 seconds + 3* the number of SPUs. This default is subject to change in subsequent releases.

If the system is not started by this time, the nzstart command returns and prints a warning message that indicates that the system failed to start in xxx seconds. The system, however, continues to try to start. You can override the default time-out by specifying a timeout.

Usage

The following provides sample usage:

To specify a directory, enter:
```
nzstart -D /tmp/data
```
To specify a log file, enter:
```
nzstart -log /tmp/startlog
```
To start without waiting, enter:
```
nzstart -noWait
```
To specify a timeout, enter:
```
nzstart -timeout 400
```