Difference between revisions of "Systems"

Latest revision as of 16:38, 9 August 2023

Systems

We called the imRAD device as "System". If you configure an IP address in a system, the information of the system is automatically saving in a few seconds and this menu shows all the saved systems.

Device

This page lists all imRAD N1 systems.

System Information

This page shows the details of a system.(The smgr and the wd service in each device saves the information every 10 minutes.) The smgr service reads and saves the following information.

General system information(i.e. version, serial number, uptime, model, and so on)
Disk(storage), Memory(RAM), and CPU Load.

The wd service reads and saves

The status, version, and information of operating service

If you click the "greater than" icon(>) in front of the IP address on each list, you can display more system information.

Item	Description
IP Address	It is the IP address of the system. If the system has multiple same version addresses, it displays only one address of them.
Name	It is the hostname or system name of the system. You can change it via the CLI.
Serial number	It is the serial number of the system.
Update Date	It is the last datetime the information is saved. If this time is not updating for the "Idle detection timeout for system activity", we notice the system as "System Idle".
Status	It shows the status of disk^[1] utilization and services. If each disk utilization exceeds the "Warning threshold for Disk utilization rate", it shows a "Notice" icon. If each disk utilization exceeds the "Critical threshold for Disk utilization rate", it shows a "Critical" icon. In the rest of the cases, it shows a "Normal" icon. If an enabled service is not running, it shows a "Notice" icon. If the system integrity has been compromised, it show a "compromised" icon. The is a icon button for "page refresh" and the is a icon button to immediately check system integrity. If you click the trash icon, It will delete the system information. If the deleted system is still running, the information will be saved again.
Uptime	It indicates how long the system has been running.
Description	It is the description of the operating system.
Version	It is the current imRAD package version. If you click the icon() beside the version, it displays the details.
RAM Disk(OS) Disk(Data)^[1]	It is the availability of each resource.
CPU Load	It shows the CPU load averages over the last 1, 5, and 15 minutes.
Current Failover Mode	It indicates the current mode of System Failover. If the System Failover is not configured, It shows "Not Configured". If the System Failover is configured, it shows either "active" or "passive". The Datetime beside the mode(i.e. active or passive) is the time of the mode was applied.
Database Replication	If the System Failover is not configured, this item does not display. If the System Failover is configured, it show "Not Configured", "Master", or "Slave". The "Not Configured" means that a system is not configured to replicate database. This case is not a normal condition. Therefore, you need to configure the System Failover again. The "Master" means that the replication mode of the system is "Master". The "Slave" indicates the replication mode of the system is "Slave". The circle icon in from of the replication mode(i.e. "Master" or "Slave") indicates the status of the database replication. The green color means that the status of the database replication is ok. The yellow color indicates that the database replication is ok but the " Seconds_Behind_Master"^[2] is high. A high number can indicate that the replication is delaying. Normally the number will be decreasing in few minutes. The red color is replication error. If you click a icon() beside the title(i.e. Database Replication), you can find what errors occur. If the replication error persists for a long time, you need to configure the System Failover again.

Services

It shows all services(daemons) in a system. The status can be either "Active" or "Inactive". The "Active" indicates the service is running and the "Inactive" indicates the service has been stopped. The "Update Date" is the last time the service was checked. The "Uptime" is the time of the service was started.

System Integrity

This system performs a system integrity check once a day (every day at 1 AM) and displays the integrity check results. If any changes or damage occur in any of the operating files, an integrity error may be displayed, and in such cases, a system update is required. To immediately check system integrity, click the icon() on the system status, and within a few seconds, the check results will be displayed again. The image below shows the screen displayed when there are no compromised files and there are more than one compromised files each other.

Database

Main Database Variables

It shows some key information of the database global variables. If you click the "plus" icon beside the title(i.e. "Main Database Variables"), you can see the information.

You may open an issue^[3] when you think the database may have some problems. In such a case, you must include this information.

Database Replication Status

It shows the primary(master) and secondary(salve) status of MySQL Replication. It only appears in the environment of the failover configured.

Main Database Events

Events are named database objects containing SQL statements that are to be executed at a later stage, either once off, or at regular intervals.^[4] Several events are running in the database of the imRAD system. If you click the "plus" icon beside the title(i.e. "Main Database Events"), it shows all events and their status.

The icon in front of a event name indicates the event status. The green color means the event is ok, the yellow color indicates the event is disabled and the gray color notes the event is in the SLAVESIDE_DISABLED.^[5]

If one of the events is not ok, you must enable them. If you click the icon red or gray-colored, you can enable an event.

Log Table

It displays the size of operational log stored in local database. All data is managed on a monthly basis, and if the system's storage space is insufficient, you can click on a specific month of a specific log, as shown in the following image and you can delete all log for a specific month.

Syslog

The logexp service reads the Syslog^[6] in its system and saves them into the imRAD database. It shows such Syslog.
However, The logexp service reads logs only whose level is greater than the "Informational". In other words, If you want to see logs whose level is "Informational", you can see it from the CLI.

If you click the icon in front of each row, it shows the details of each log.

References

↑ ^1.0 ^1.1 The imRAD disk consists of two partitions. One is for the operating systems, another is for data.
↑ https://dev.mysql.com/doc/refman/5.7/en/replication-administration-status.html
↑ https://issue.basein.net
↑ https://mariadb.com/kb/en/events/
↑ https://dev.mysql.com/doc/refman/8.0/en/show-events.html
↑ https://en.wikipedia.org/wiki/Syslog

[imrad_disk-1] 1.0 ^1.1 The imRAD disk consists of two partitions. One is for the operating systems, another is for data.

[2] ttps://dev.mysql.com/doc/refman/5.7/en/replication-administration-status.html

[3] ttps://issue.basein.net

[4] ttps://mariadb.com/kb/en/events/

[5] ttps://dev.mysql.com/doc/refman/8.0/en/show-events.html

[6] ttps://en.wikipedia.org/wiki/Syslog

[1]

[2]

[3]

[4]

[5]

[6]

@@ Line 3: / Line 3: @@
 If you [[CLI - Configuring IP address | configure an IP address]] in a system, the information of the system is automatically saving in a few seconds and this menu shows all the saved systems.
-==== List ====
+==== Device ====
-===== Systems =====
+This page lists all imRAD N1 systems.
-The information of systems is saving in the period of about 10 minutes by the smgr service in each device.
-The smgr service reports the following information.
+===== System Information =====
+This page shows the details of a system.(The smgr and the wd service in each device saves the information every 10 minutes.)
+The smgr service reads and saves the following information.
 * General system information(i.e. version, serial number, uptime, model, and so on)
 * Disk(storage), Memory(RAM), and CPU Load.
+The wd service reads and saves <br>
 * The status, version, and information of operating service
+If you click the "greater than" icon('''>''') in front of the IP address on each list, you can display more system information.
 {| class="wikitable"
-! style='width:150px' | Item !! Description
+! style='width:180px' | Item !! Description
+|-
+| IP Address || It is the IP address of the system. If the system has multiple same version addresses, it displays only one address of them.
+|-
+| Name || It is the hostname or system name of the system. You can change it via the [[CLI - Hostname | CLI]].
+|-
+| Serial number || It is the serial number of the system.
+|-
+| Update Date || It is the last datetime the information is saved. If this time is not updating for the [[Environment | "Idle detection timeout for system activity"]], we notice the system as "System Idle".
+|-
+| Status || It shows the status of disk<ref name="imrad_disk">The imRAD disk consists of two partitions. One is for the operating systems, another is for data.</ref> utilization and services. If each disk utilization exceeds the [[Environment | "Warning threshold for Disk utilization rate"]], it shows a "<span style="background:#ffff00">Notice</span>" icon. If each disk utilization exceeds the [[Environment | "Critical threshold for Disk utilization rate"]], it shows a "<span style="background:#ff0000;color:#ffffff">Critical</span>" icon. In the rest of the cases, it shows a "<span style="background:#0000ff;color:#ffffff">Normal</span>" icon.<br>
+If an enabled service is not running, it shows a "<span style="background:#ffff00">Notice</span>" icon.<br>
+If the system integrity has been compromised, it show a "<span style="background:#ff0000">compromised</span>" icon.<br>
+The [[File:스크린샷 2023-08-09 오후 4.01.56.png|25px]] is a icon button for "page refresh" and the [[File:스크린샷 2023-08-09 오후 4.02.11.png|25px]] is a icon button to immediately check system integrity.
+If you click the trash icon, It will delete the system information. If the deleted system is still running, the information will be saved again.
+|-
+| Uptime || It indicates how long the system has been running.
+|-
+| Description || It is the description of the operating system.
 |-
-| Update Date || It is the last datetime the information is saved. If this time is not updating for the [[System Messages| "Idle detection timeout for system activity"]], we notice the system as "Service Idle".
+| Version || It is the current imRAD package version. If you click the icon([[File:icon_bars.png|15px]]) beside the version, it displays the details.
+|-
+| RAM<br>Disk(OS)<br>Disk(Data)<ref name="imrad_disk" /> || It is the availability of each resource.
+|-
+| CPU Load || It shows the CPU load averages over the last 1, 5, and 15 minutes.
+|-
+| Current Failover Mode || It indicates the current mode of [[System Failover]].<br>
+If the System Failover is not configured, It shows "Not Configured". If the System Failover is configured, it shows either "active" or "passive". The Datetime beside the mode(i.e. active or passive) is the time of the mode was applied.
+|-
+| Database Replication || If the System Failover is not configured, this item does not display. If the System Failover is configured, it show "Not Configured", "Master", or "Slave".
+The "Not Configured" means that a system is not configured to replicate database. This case is not a normal condition. Therefore, you need to [[CLI - Configuring System Failover | configure the System Failover]] again.<br>
+The "Master" means that the replication mode of the system is "Master".<br>The "Slave" indicates the replication mode of the system is "Slave".
+The circle icon in from of the replication mode(i.e. "Master" or "Slave") indicates the status of the database replication.<br> The green color means that the status of the database replication is ok. The yellow color indicates that the database replication is ok but the "[[Environment | Seconds_Behind_Master]]"<ref>https://dev.mysql.com/doc/refman/5.7/en/replication-administration-status.html</ref> is high. A high number can indicate that the replication is delaying. Normally the number will be decreasing in few minutes.
+The red color is replication error. If you click a icon([[File:icon_bars.png|15px]]) beside the title(i.e. Database Replication), you can find what errors occur. <br>
+If the replication error persists for a long time, you need to [[CLI - Configuring System Failover | configure the System Failover]] again.
 |-
-| Status ||
 |}
-'''(1) 상세보기 열기 / 닫기'''<br>
+===== Services =====
-(1)번 아이콘을 클릭하면 상세 보기로 확장 할 수 있습니다.
+It shows all services(daemons) in a system. The status can be either "Active" or "Inactive". The "Active" indicates the service is running and the "Inactive" indicates the service has been stopped. The "Update Date" is the last time the service was checked. The "Uptime" is the time of the service was started.
+===== System Integrity =====
+This system performs a system integrity check once a day (every day at 1 AM) and displays the integrity check results. If any changes or damage occur in any of the operating files, an integrity error may be displayed, and in such cases, a system update is required. To immediately check system integrity, click the icon([[File:스크린샷 2023-08-09 오후 4.02.11.png|25px]]) on the system status, and within a few seconds, the check results will be displayed again. The image below shows the screen displayed when there are no compromised files and there are more than one compromised files each other.
+[[File:스크린샷 2023-08-09 오후 4.11.55.png|800px|system integrity ok]]
-'''(2) 디스크 및 서비스 상태 개요'''<br>
+[[File:스크린샷 2023-08-09 오후 4.10.55.png|800px|system integrity not ok]]
-본 시스템은 OS 영역과 데이터 영역의 디스크 공간이 논리적으로 분리되어있는데 그 사용률이 정의된 임계치를 초과했는지 여부에 따라 상태 아이콘이 [[File:icon_ok.png|32px]], [[File:icon_warning.png|32px]] 또는 [[File:icon_criti.png|32px]]중 하나로 표시됩니다.<br>
-임계치 정의는 [[환경설정]] > 시스템 메시지 > 디스크 사용률에서 설정 할 수 있으며 심각 상태일 경우 반드시 CLI를 통해 디스크 상태를 점검 후 공간을 확보해야 합니다.<br>
-또한 운영중인 서비스 중 하나라도 동작하지 않는 경우 [[File:icon_warning.png|32px]]로 표시됩니다.
-'''(3) 삭제'''<br>
-시스템 및 관련 정보가 모두 삭제됩니다.
-'''(4) 버전'''<br>
-시스템에 적용되어 있는 imRAD 패키지의 버전 및 적용될 날짜를 나타내며 [[File:icon_bars.png|15px]] 아이콘을 클릭하면 상세 버전을 확인 할 수 있습니다.
-'''(5) RADIUS TLS 인증서'''<br>
+=== Database ===
-RADIUS TLS 통신(TTLS, PEAP 등)에 사용되는 서버 인증서를 나타내며 [[File:icon_bars.png|15px]] 아이콘을 클릭하면 인증서의 상제 정보를 확인 할 수 있습니다.
+==== Main Database Variables ====
+It shows some key information of the database global variables. If you click the "plus" icon beside the title(i.e. "Main Database Variables"), you can see the information.
-'''(6) CPU Load'''<br>
+You may open an issue<ref>https://issue.basein.net</ref> when you think the database may have some problems. In such a case, you must include this information.
-CPU 사용률을 최근 1분, 5분 그리고 15분 통계로 표시합니다.
-'''(7) 시스템 이중화 모드'''<br>
+==== Database Replication Status ====
-해당 시스템의 이중화 모드를 표시하면 Active 또는 Passive로 표시됩니다. 만일 [[시스템 이중화]]가 되어 있지 않다면 아무런 내용도 표시되지 않습니다.
+It shows the primary(master) and secondary(salve) status of MySQL Replication. It only appears in the environment of the failover configured.
-'''(7) 데이터베이스 복제'''<br>
+==== Main Database Events ====
-시스템 이중화 모드가 설정된 경우 해당 시스템의 데이터베이스 복제 상태를 표시합니다. [[시스템 이중화]]는 CLI를 통해 [[CLI - 시스템 이중화 설정 | 설정]]할 수 있으며 데이터베이스 복제 상태에 문제가 발생하면 CLI를 통해 재 설정 할 수 있습니다.
+Events are named database objects containing SQL statements that are to be executed at a later stage, either once off, or at regular intervals.<ref>https://mariadb.com/kb/en/events/</ref> Several events are running in the database of the imRAD system. If you click the "plus" icon beside the title(i.e. "Main Database Events"), it shows all events and their status.
+The icon in front of a event name indicates the event status. The green color means the event is ok, the yellow color indicates the event is disabled and the gray color notes the event is in the SLAVESIDE_DISABLED.<ref>https://dev.mysql.com/doc/refman/8.0/en/show-events.html</ref>
+If one of the events is not ok, you must enable them. If you click the icon red or gray-colored, you can enable an event.
+[[File:스크린샷 2023-08-09 오후 4.26.18.png|500px]]
-'''(8) 서비스'''<br>
-해당 시스템에서 운영중인 모든 서비스 목록을 표시합니다.<br>
-'''상태'''<br>
-{| class="wikitable"
-! 상태 아이콘 !! 설명
-|-
-| [[File:icon_service_active.png|30px]] || 서비스가 정상적으로 동작중입니다.
-|-
-| [[File:icon_service_active_warning.png|30px]] || 서비스 동작에 이상이 감지된 경우입니다.
-|-
-| [[File:icon_service_inactive.png|40px]]|| 서비스가 중지되어 있습니다.
-|-
-|}
-'''최근 확인시간 / 가동 시간'''<br>
-최근 확인 시간은 서비스의 상태, 이름, 버전 및 가동시간을 확인 후 저장된 최근 시간을 의미하며 가동 시간은 서비스의 uptime을 의미합니다.
+=== Log Table ===
+[[File:스크린샷 2023-08-09 오후 4.35.26.png|400px|thumb]]
+It displays the size of operational log stored in local database. All data is managed on a monthly basis, and if the system's storage space is insufficient, you can click on a specific month of a specific log, as shown in the following image and you can delete all log for a specific month.
+<br><br><br><br><br><br>
+=== Syslog ===
+The [[ImRAD services(daemons) | logexp]] service reads the Syslog<ref>https://en.wikipedia.org/wiki/Syslog</ref> in its system and saves them into the imRAD database. It shows such Syslog.<br>
+However, The logexp service reads logs only whose level is greater than the "Informational".
+In other words, If you want to see logs whose level is "Informational", you can see it from the [[CLI - Log | CLI]].
-===== 메인 데이터베이스 변수 =====
+If you click the icon in front of each row, it shows the details of each log.
-설정된 주요 MariaDB 변수를 출력합니다.
-===== 메인 데이터베이스 이벤트 =====
-MariaDB 내부에서 스케줄링된 이벤트의 상태를 표시하면 그 상태는 모두 "활성"으로 표시되어야 합니다.<br>
-만일 일부 상태가 "비활성" 또는 "Slave 비활성"인 경우 상태 아이콘을 클릭하면 해당 이벤트를 다시 적용 할 수 있습니다.<br>
-==== Syslog ====
+=== References ===
-각 시스템에서 발생 한 주요 syslog는 메인 데이터베이스에 저장되는데 이 메뉴에서 확인 할 수 있습니다.<br>
-syslog는 notice level 이상만 저장되면 information과 debug는 SSH 접속 후 확인 할 수 있습니다([[로그 확인]]).<br>