6.2.3.5 chservice
Start, stop, restart, or disable a software service.
Purpose
The chservice
command allows you to start, stop, restart, or disable
an Exascale software service. A
chservice
command can only perform one operation on one service
instance.
Syntax
chservice --attributes name=service_cell[,frontend={true|false}]
{ --start | --stop | --restart | --disable [ --force ]}
chservice --attributes name=service_compute
{ --start | --stop | --restart | --disable [ --force ]}
Command Options
The options for the chservice
command are:
-
--attributes
: Primarily identifies the server and service that is the subject of the operation. This option is also used to specify optional attribute settings.-
name
: Identifies the server and service that is the subject of the operation.For a service on an Exadata storage server, specify the
name
attribute using the format:name=service_cell
. In the attribute value:-
service: Specifies the service that you want to act on, which is one of the following:
-
cellsrv
: Specifies the Exadata Cell Server (CELLSRV). -
egs
: Specifies the Exascale cluster service, also known as Exascale global service (EGS). -
ers
: Specifies the Exascale control service, also known as Exascale RESTful service (ERS). -
syseds
: Specifies the system vault manager service. -
usreds
: Specifies the user vault manager service. -
bsm
: Specifies the block store manager (BSM) service. -
bsw
: Specifies the block store worker (BSW) service.
-
-
cell: Specifies the name of the storage server (
cell
) that hosts the service.The cell must be identified by its name. Use the
lscell
command to find all cell names.
For a service on an Exadata compute server, specify the
name
attribute using the format:name=service_compute
. In the attribute value:-
service: Specifies the service that you want to act on, which is one of the following:
-
egs
: Specifies the Exascale cluster service, also known as Exascale global service (EGS). -
bsw
: Specifies the block store worker service.
-
-
compute: Specifies the name of the compute server (
dbserver
) that hosts the service.Depending on the required service location, specify either the name of a specific compute node virtual machine (VM) or the Exadata compute node host domain (KVM host or Dom0). Use the
lscomputeserver
command to display information about compute servers associated with the Exascale cluster.
-
-
frontend
: Optionally specifies whether to start ERS front-end server processes. This option is only valid when starting or restarting an ERS instance.To start the front-end server processes on the ERS instance, specify
frontend=true
. To not start the front-end server processes on the ERS instance, specifyfrontend=false
.
-
- You must also specify one of the following operations:
-
--start
: Starts a service. The service is also enabled if it was previously disabled. -
--stop
: Stops a service. -
--restart
: Restarts a service. The service is also enabled if it was previously disabled. -
--disable
: Disables a service. A disabled service is stopped and prevented from automatically restarting on the associated server.You can also add the
--force
option to forcibly disable the service, even if the server hosting the service is unavailable. This option only applies when disabling a service.
-
Examples
Example 6-7 Start the System Vault Manager Service (SYSEDS)
In this example, the system vault manager service is started on
CELL1
.
@> chservice --attributes name=syseds_CELL1 --start
Example 6-8 Restart the Exascale Control Service (ERS)
In this example, ERS is restarted on CELL2
, along with
the front-end ERS server processes.
@> chservice --attributes name=ers_CELL2,frontend=true --restart
Parent topic: Service and Cluster Management