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.
- 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 the topic "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 in the IBM Spectrum Scale: Administration and Programming Reference.
- -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
- 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
- To display the current state of the mmwinserv service
on all nodes in the cluster, issue:
The system displays information similar to:mmwinservctl query -N all
Node name Service state Remote shell Account name ---------------------------------------------------------- ls21n19 RUNNING yes gpfs\root ls21n20 RUNNING yes gpfs\root ls21n14 RUNNING yes LocalSystem