3.5.1 Matrix Server Administration Guide

Chapter 2: Matrix Administration 38

mxinit Configuration File

mxinit performs its actions according to a set of default values. You can

use the /etc/opt/polyserve/mxinit.conf configuration file to override these

values. The file describes the available options and the required format.

We recommend that you change this file only under the direction of

PolyServe personnel.

Start or Stop Matrix Server

Matrix Server runs on each server in the matrix. When a server is booted

to run-levels 3 or 5, Matrix Server is started automatically by the script

/etc/init.d/pmxs.

Start or Stop Matrix Server with the pmxs Script

If you need to start, stop, or restart Matrix Server on a particular server,

invoke the pmxs script:

# /etc/init.d/pmxs start

# /etc/init.d/pmxs stop

# /etc/init.d/pmxs restart

The pmxs script calls the mxinit utility. For a start operation, mxinit starts

the Matrix Server processes in the correct order and loads the kernel

modules. For a stop operation, it stops the Matrix Server processes,

unloads the kernel modules, and performs cleanup tasks.

Start or Stop Matrix Server with mxinit

Typically, you should use the pmxs script to start or stop Matrix Server.

However, if you want to see verbose output during the start or stop

operation, you can run mxinit manually with the --verbose option.

You can use the following mxinit options to start or stop Matrix Server:

• -s, --start

Start the Matrix Server processes.

• -x, --stop

Gently stop the Matrix Server processes. mxinit first attempts to

unmount PSFS filesystems. If the unmount fails, the gentle stop

operation will also fail.