10.4.2 Servicing Node exporter for AIX

(1) Enabling registering services

Enable service registration with the following command:

• For physical host operation

  mkssys -p /bin/sh -s jpc_node_exporter_aix -u root -S -f 9 -n 15 -a "-c \"'Node-exporter-for-AIX-destination-directory/jp1ima/bin/node_exporter_aix' -CcADmdiabf -p 20730 2>&1 | logger\""

• For logical host operation

  mkssys -p /bin/sh -s jpc_node_exporter_aix__logical-host-name# -u root -S -f 9 -n 15 -a "-c \"'Node-exporter-for-AIX-destination-directory/jp1ima/bin/node_exporter_aix'  -CcADmdiabf -p 20730 2>&1 | logger\""

  #

  If the logical hostname is 8 bytes or more, specify -s option by appending "jpc_node_exporter_aix_" followed by any character string up to 7 characters. The character string specified in -s option must be unique within Subsystem of lssrc -a command.

The following is a description of the above node_exporer_aix command-options:

• Node_exporer_aix Command-Option

  Item name	Description	Changeability	What you set in JP1/IM-Agent	JP1/IM - Agent Default value
  -C#	Specifies that metrics are to be collected for linux node exporter.	Y	--	--
  -c#	Specifies that metrics are to be collected for CPU.	Y	--	--
  -A#	Specifies that metrics are to be collected for the disk adapter.	Y	--	--
  -D#	Specifies that metrics are to be collected for the disk path.	Y	--	--
  -m#	Specifies that metrics are to be collected for memory.	Y	--	--
  -d#	Specifies that metrics are to be collected for the disk.	Y	--	--
  -i#	Specifies that metrics are to be collected for a network interface.	Y	--	--
  -a#	Specifies that metrics are to be collected for the net adapter.	Y	--	--
  -b#	Specifies that metrics are to be collected for the net buffer.	Y	--	--
  -f#	Specifies that metrics are to be collected for the file system.	Y	--	--
  -p	Specify the listen port.	Y	Specify this option if you want to change the port.	-p 20730

Legend

Y: Changeable --: Not applicable

#

If all options other than -p are not specified, the command is enabled.

To Page Top

(2) Disable registering service

Disable service registration with the following command:

• For physical host operation

  rmssys -s jpc_node_exporter_aix

• For logical host operation

  rmssys -s jpc_node_exporter_aix_logical-host-name#

  #

  If the logical host name is 8 bytes or more, add any character string of up to 7 characters specified in 10.4.2(1) Enabling registering servicesor 10.4.2(3) Registering the service changedto the end of "jpc_node_exporter_aix_" and specify it in -s option.

To Page Top

(3) Registering the service changed

If you want to change Node exporter for AIX port number, use the following command to change the service-registration:

• For physical host operation

  chssys -p /bin/sh -s jpc_node_exporter_aix -u root -S -f 9 -n 15 -a "-c \"'Node-exporter-for-AIX-destination-directory/jp1ima/bin/node_exporter_aix'  -CcADmdiabf -p new-port-number 2>&1 | logger\""

• For logical host operation

  chssys -p /bin/sh -s jpc_node_exporter_aix_logical-host-name# -u root -S -f 9 -n 15 -a "-c \"'Node-exporter-for-AIX-destination-directory/jp1ima/bin/node_exporter_aix'  -CcADmdiabf -p new-port-number 2>&1 | logger\""

  #

  If the logical hostname is 8 bytes or more, specify -s option by appending "jpc_node_exporter_aix_" followed by any character string up to 7 characters. The character string specified in -s option must be unique within Subsystem of lssrc -a command.

To Page Top

(4) Checking the status of services

Check the status of the service with the following command:

• For physical host operation

  lssrc -s jpc_node_exporter_aix

• For logical host operation

  lssrc -s jpc_node_exporter_aix_logical-host-name#

  #

  If the logical host name is 8 bytes or more, add any character string of up to 7 characters specified in 10.4.2(1) Enabling registering servicesor 10.4.2(3) Registering the service changedto the end of "jpc_node_exporter_aix_" and specify it in -s option.

To Page Top

(5) Confirmation of service registration details

Confirm the registered contents of the service with the following command.

• For physical host operation

  lssrc -S -s jpc_node_exporter_aix

• For logical host operation

  lssrc -S -s jpc_node_exporter_aix_logical-host-name#

  #

  If the logical host name is 8 bytes or more, add any character string of up to 7 characters specified in 10.4.2(1) Enabling registering servicesor 10.4.2(3) Registering the service changedto the end of "jpc_node_exporter_aix_" and specify it in -s option.

To Page Top

(6) Starting the Service

1. Start the service.

   Start the service with the following command:

   • For physical host operation

   startsrc -s jpc_node_exporter_aix

   • For logical host operation

   startsrc -s jpc_node_exporter_aix_logical-host-name#

   #

   If the logical host name is 8 bytes or more, add any character string of up to 7 characters specified in 10.4.2(1) Enabling registering servicesor 10.4.2(3) Registering the service changedto the end of "jpc_node_exporter_aix_" and specify it in -s option.

2. Confirm the start of the service.

   Execute 10.4.2(4) Checking the status of services and confirm that the service has started.

To Page Top

(7) Stopping the service

1. Stop the service.

   Stop the service with the following command:

   • For physical host operation

   Node-exporter-for-AIX-destination-directory/jp1ima/bin/jpc_stop_node_exporter_aix

   • For logical host operation

   ode-exporter-for-AIX-destination-directory/jp1ima/bin/jpc_stop_node_exporter_aix -h logical-host-name#

   #

   If the logical host name is 8 bytes or more, add any character string of up to 7 characters specified in 10.4.2(1) Enabling registering servicesor 10.4.2(3) Registering the service changedto the end of "jpc_node_exporter_aix_" and specify it in -s option.

2. Confirm that the service is stopped.

   Execute 10.4.2(4) Checking the status of services to confirm that the service has stopped.

3. Confirm that the node_exporter_aix process is stopped.

   Execute ps command. Confirm that the node_exporter_aix process is stopped.

To Page Top

(8) Forced Stop of Service

1. Stop the service forcibly.

   Stop the service forcibly with the following command:

   • For physical host operation

   Node-exporter-for-AIX-destination-directory/jp1ima/bin/jpc_stop_node_exporter_aix -f

   • For logical host operation

   Node-exporter-for-AIX-destination-directory/jp1ima/bin/jpc_stop_node_exporter_aix -f -h logical-host-name#

   #

   If the logical host name is 8 bytes or more, add any character string of up to 7 characters specified in 10.4.2(1) Enabling registering servicesor 10.4.2(3) Registering the service changedto the end of "jpc_node_exporter_aix_" and specify it in -s option.

2. Confirm that the service is stopped.

   Execute 10.4.2(4) Checking the status of servicesto confirm that the service has stopped.

3. Confirm that the node_exporter_aix process is stopped.

   Execute ps command. Confirm that the node_exporter_aix process is stopped.

To Page Top

(9) Enabling Automatic Startup

1. Set the auto-launch setting

   Enable autostart with the following command:

   • For physical host operation

   mkitab "jpcaixexporter:2:wait:startsrc -s jpc_node_exporter_aix"

   • For logical host operation

   mkitab "jpcaixexporter:2:wait:startsrc -s jpc_node_exporter_aix_logical-host-name#"

   #

   If the logical host name is 8 bytes or more, add any character string of up to 7 characters specified in 10.4.2(1) Enabling registering servicesor 10.4.2(3) Registering the service changedto the end of "jpc_node_exporter_aix_" and specify it in -s option.

2. Check settings

   Check the settings with the following command.

   lsitab -a

   (Example of execution result)

   init:2:initdefault:
   brc::sysinit:/sbin/rc.boot 3 >/dev/console 2>&1 # Phase 3 of system boot
   ...
   jpcaixexporter:2:wait:startsrc -s jpc_node_exporter_aix

To Page Top

(10) Disabling automatic startup

1. Set the auto-launch setting

   Disable autostart with the following command:

   • For physical host operation

   rmitab "jpcaixexporter"

   • For logical host operation

   rmitab "jpcaixexporter"

2. Check settings

   Use the following command to confirm that the item specified in step 1 has been deleted.

   lsitab -a

To Page Top

(11) Enabling Automatic Stop

1. Open /etc/rc.shutdown file in a text editor and add the following Node exporter for AIX description:

   • For physical host operation

   Node-exporter-for-AIX-destination-directory/jp1ima/bin/jpc_stop_node_exporter_aix

   • For logical host operation

   Node-exporter-for-AIX-destination-directory/jp1ima/bin/jpc_stop_node_exporter_aix -h logical-host-name#

   #

   If the logical host name is 8 bytes or more, add any character string of up to 7 characters specified in 10.4.2(1) Enabling registering servicesor 10.4.2(3) Registering the service changedto the end of "jpc_node_exporter_aix_" and specify it in -s option.

2. At the end of /etc/rc.shutdown file add one line:

   exit 0

   If the exit code of the last command executed is other than "0", /etc/rc.shutdown script recognizes it as an error and aborts the shutdown process.

To Page Top

(12) Disabling Automatic Stop

1. Open /etc/rc.shutdown file in a text editor and remove the following Node exporter for AIX descriptions:

   • For physical host operation

   Node-exporter-for-AIX-destination-directory/jp1ima/bin/jpc_stop_node_exporter_aix

   • For logical host operation

   Node-exporter-for-AIX-destination-directory/jp1ima/bin/jpc_stop_node_exporter_aix -h logical-host-name#

   #

   If the logical host name is 8 bytes or more, add any character string of up to 7 characters specified in 10.4.2(1) Enabling registering servicesor 10.4.2(3) Registering the service changedto the end of "jpc_node_exporter_aix_" and specify it in -s option.

2. At the end of /etc/rc.shutdown file add one line:

   exit 0

   If the exit code of the last command executed is other than "0", /etc/rc.shutdown script recognizes it as an error and aborts the shutdown process.

To Page Top