mmwinservctl command

Manages the mmwinserv Windows service.

Synopsis

mmwinservctl set [--account AccountName [--password Password]] [--remote-shell {yes | no}]
[-N {Node[,Node...] | NodeFile | NodeClass}] [-v]

or

mmwinservctl {enable | disable | query} [-N {Node[,Node...] | NodeFile | NodeClass}] [-v]

Availability

Available on all IBM Spectrum Scale editions. Available on Windows.

Description

mmwinserv is a GPFS for Windows service that is needed for the proper functioning of the GPFS daemon on nodes running Windows. Optionally, the service can be configured to provide a remote execution facility for GPFS administration commands.

Use the mmwinservctl command to manage the mmwinserv service. You can set the log on account and password for the service, enable or disable the service, enable or disable the service's remote execution facility, or query its current state.

The mmwinservctl command must be run on a Windows node and it has no effect on nodes running other operating systems.

If the remote execution facility of mmwinserv is enabled, a Windows GPFS cluster can be configured to use mmwinrsh and mmwinrcp as the remote shell and remote file copy commands:
  • mmwinrsh (/usr/lpp/mmfs/bin/mmwinrsh) uses Windows Named Pipes to pass the command to the target node.
  • mmwinrcp (/usr/lpp/mmfs/bin/mmwinrcp) is a wrapper module that invokes the Cygwin cp command to copy the files that are needed by the mm commands. The path names on remote hosts are translated into path names based on the standard Windows ADMIN$ share.

An account must be given the right to log on as a service before it can be used to run mmwinserv. The right to log on as a service is controlled by the Local Security Policy of each Windows node. You can use the Domain Group Policy to set the Local Security Policy on all Windows nodes in a GPFS cluster.

For more information on the mmwinserv service, see Configuring the GPFS Administration service in the IBM Spectrum Scale: Concepts, Planning, and Installation Guide.

Parameters

set
Sets the service configuration options and restarts the service if it is running.
enable
Sets the service to automatic startup and starts the service.
disable
Sets the service to disabled and stops the service.
query
Returns information about the service's configuration and current state.
--account AccountName
Specifies the log on account name for the mmwinserv service. By default, mmwinserv is configured to run using the LocalSystem account.
--password Password
Specifies the log on password for the mmwinserv service.
--remote-shell {yes | no}
Specifies whether or not remote connections are allowed.
-N {Node[,Node...] | NodeFile | NodeClass}
Specifies the list of nodes on which to perform the action. The default is the node on which the mmwinservctl command is issued.

If the node on which the mmwinservctl command is issued belongs to a GPFS cluster, the nodes specified with the -N parameter must belong to the cluster.

If the node on which the mmwinservctl command is issued does not belong to a GPFS cluster, the nodes specified with the -N parameter must be identified by their host names or IP addresses. Node classes and node numbers cannot be used.

For general information on how to specify node names, see Specifying nodes as input to GPFS commands.

-v
Displays progress and intermediate error messages.

Exit status

0
Successful completion.
nonzero
A failure has occurred.

Security

You must be a member of the Domain Admins group to run the mmwinservctl command.

Examples

  1. To specify 'gpfs\root' as the log on account name for the mmwinserv service and enable the remote command execution facility on nodes ls21n19 and ls21n20, issue: 
    mmwinservctl set -N ls21n19,ls21n20 --account gpfs/root -password abcdefg –remote-shell yes
    The system displays information similar to: 
    Node name        Service state  Remote shell  Account name
----------------------------------------------------------
ls21n19          START_PENDING  yes           gpfs\root
ls21n20          START_PENDING  yes           gpfs\root
  2. To display the current state of the mmwinserv service on all nodes in the cluster, issue: 
    mmwinservctl query -N all
    The system displays information similar to: 
    Node name        Service state  Remote shell  Account name
----------------------------------------------------------
ls21n19          RUNNING        yes           gpfs\root
ls21n20          RUNNING        yes           gpfs\root
ls21n14          RUNNING        yes           LocalSystem

Location

/usr/lpp/mmfs/bin