Name

iistartup − start up all or some elements of ULTRIX/SQL installation

Syntax

iistartup [−init] [−B] [sql-directory]

Description

The iistartup command allocates shared memory resources and starts up the ULTRIX/SQL name server, DBMS (database management system) servers, communications servers, and archiver and recovery processes. Commands are available for starting up these elements separately; however, using the iistartup command ensures that different startup operations occur in the correct sequence. The parameter sql-directory is the path to the ULTRIX/SQL installation, normally /usr/kits/sql. If you do not specify sql-directory, iistartup uses the path defined by the environment variable II_SYSTEM to specify the path to the ULTRIX/SQL installation directory.

Only the ULTRIX/SQL system administrator can use the iistartup command.

Note

The iistartup command with the −init option is run automatically when you use iibuild to initialize ULTRIX/SQL after installation.

Options

−initDirects iistartup to prompt for configuration information that is applied to the current startup operation and also stored in configuration files that subsequent startup operations will use by default.

−BPrevents a startup message from being broadcast. 

Restrictions

If an error occurs during the startup process, you may have to manually remove the iistartup.lock, sysseg, and lockseg files in the directory $II_SYSTEM/sql/files before you can run iistartup again.

Examples

Execute iistartup when the II_SYSTEM environment variable is set to identify the ULTRIX/SQL installation that you are starting up.  In addition, direct iistartup to prompt you for new configuration information:

iistartup -init

Start up ULTRIX/SQL automatically at system boot time by including the following line in the ULTRIX boot script (which is usually the file /etc/rc.local). In the following case, the value of the II_SYSTEM environment variable is not defined, and the current configuration files will be used for the ULTRIX/SQL system:

su ingres -c "/usr/kits/sql/sql/utility/iistartup /usr/kits/sql"

Files

$II_CONFIG/gcc.opt
File that supplies configuration information for communications servers when −init option is not specified and that is created or replaced when −init option is specified. 

$II_CONFIG/rcp.opt
File that supplies configuration information for recovery and locking facilities when −init option is not specified and that is created or replaced when −init option is specified. 

$II_CONFIG/rundbms.opt
File that supplies configuration information for DBMS servers when −init option is not specified and that is created or replaced when −init option is specified. 

$II_SYSTEM/sql/files/iistartup.lock
Lock file that prevents more than one concurrent attempt to start up ULTRIX/SQL.

$II_SYSTEM/sql/files/lockseg

$II_SYSTEM/sql/files/sysseg
System lock files.

See Also

intro(1sql), iibuild(8sql), iishutdown(8sql), intro(8sql)

ULTRIX/SQL Operations Guide