Ncloud Tool Kit (Linux)
    • PDF

    Ncloud Tool Kit (Linux)

    • PDF

    Article summary

    Available in Classic and VPC

    Linux Ncloud Tool Kit (Linux NTK) is a tool kit for Linux VMs provided on NAVER Cloud Platform. It provides various functions including server status diagnosis, disk I/O test, log collection, and system patch. These functions facilitate the operation and maintenance of NCP VM and serve as a communication tool for resolving NCP VM issues.

    Note
    • If you are using NTK on KVM hypervisor-based Linux VM, only server status diagnosis and log collection are available.
    • NTK version upgrades will no longer be provided for server images that have faded out in XEN hypervisor-based Linux VM. For more information, see Notifications.

    Running Linux NTK

    To run NTK on the Linux server, follow these steps:

    1. Check the type of hypervisor being used for hosting the VM.
      The zipped NTK file name and the NTK file download link differ according to the hypervisor type.

      • XEN-based server
       [root@xen-server etc]# dmesg | grep "Hypervisor detected" | awk -F': ' '{print $2}'
       Xen HVM
      
      • KVM-based server
      [root@kvm-server etc]# dmesg | grep "Hypervisor detected" | awk -F': ' '{print $2}'
      KVM
      
    2. Move to the path where the NTK file is located.

       [root@xen-server ~]# cd /usr/local/etc
      
    3. Unzip the NTK file.

      • XEN-based server
      [root@xen-server etc]# tar zxvf ntk.tar.gz
      
      • KVM-based server
       [root@kvm-server etc]# tar zxvf ntk-kvm.tar.gz
      

      If no ntk.tar.gz file exists or if you wish to replace the existing file with the latest version, download the file first.

      • XEN-based server
      [root@xen-server etc]# wget -P /usr/local/etc http://init.ncloud.com/server/ntk/linux/xen/ntk.tar.gz
      
      • KVM-based server
      [root@kvm-server etc]# wget -P /usr/local/etc http://init.ncloud.com/server/ntk/linux/kvm/ntk-kvm.tar.gz
      
    4. Run NTK.

      [root@xen-server etc]# /usr/local/etc/ntk/ntk
      

    Using Linux NTK

    Main screen

    server-ntk-linux

    FieldDescription
    ① Program name and versionShows the program name and version.
    ② Menu tabIncludes the available menu options.
    ③ Action tabShows the running status of the menu option where the cursor is located and lets you cancel the progress.

    Available keys in NTK are limited to the following. Be sure to learn how to use the keys to use the desired functions.

    • [Enter] key: select the item where the cursor is located
    • Up and down keys: move between the menu options
    • [Tab]/left and right keys: move between menu areas and action areas

    The following are the available menu options in NTK.

    Note

    Different menu options may be displayed depending on the server type.

    1. EXECUTE MENU

    The Execute menu contains the main tools provided in NTK.

    ToolDescription
    SYSTEM CHECKINGThis tool diagnoses the VM status to identify symptoms and causes and saves the diagnosis result log. You can prevent errors in advance by running this tool before creating server images.
    For more information on SYSTEM CHECKING, see the following guides.
    FIO TESTThis tool runs the I/O test on a VM disk and saves the test result log.
    For more information on FIO TEST, see the following guides.
    GPU DEBUG COLLECTINGThis tool collects the NVIDIA debug log when the GPU server is used and saves the collection result log.
    For more information on GPU DEBUG COLLECTING, see the following guides.
    XENTOOLSThis tool re-installs Xentools.
    For more information on XENTOOLS, see the following guides.
    BACKUP CHECKINGThis tool inspects the status and port for installing agents when a backup product is used and it can be re-installed when the backup agent is not installed normally.
    For more information on BACKUP CHECKING, see the following guides.

    2. VIEW MENU

    Views or uploads the logs created after running tools in the EXECUTE menu.

    ToolDescription
    SYSTEM CHECKINGUsed to view the SYSTEM CHECKING logs.
    FIO TESTUsed to view the disk I/O test logs.
    GPU DEBUG COLLECTINGUsed to view the GPU debug logs.
    BACKUP CHECKING LOGUsed to view the BACKUP CHECKING logs.

    Running tools

    To select and run a tool in NTK, follow these steps:

    1. On the main screen of NTK, select the EXECUTE menu.
    2. Select the tool you want.
    3. If a message appears on the screen asking whether to start the task, click the [Yes] button.
      • The selected task is started.
    4. When the task is completed, follow the instructions on the screen to view the result and click the [OK] button.
      • You can transfer the log file to NAVER Cloud's technical support center. If a message appears on the screen asking whether to transfer the log to the technical support center, click the [Yes] button. Once the log is transferred, a success message appears along with a ShortURL for you to save the log at. If you need the Customer inquiry link, you can attach the ShortURL.

    Viewing log

    To view a log created by running a tool, follow these steps:

    1. On the main screen of NTK, select the VIEW menu.
    2. Select the log type and file you want.
      • In the case of VM diagnosis log, select whether to view the full log or only parts of the log containing problems (NOK log).
    3. View the log and click the [OK] button.
    4. Select whether to transfer the log to the technical support center.
      • Clicking the [Yes] button transfers the log to NAVER Cloud's technical support center. Upon transfer, a success message appears along with a ShortURL for you to save the log at. If you need the Customer inquiry link, you can attach the ShortURL.
    Note

    If the log cannot be transferred properly due to a network error, you can attach the file saved in VM and forward it to Customer inquiry.
    The file is located under /usr/local/etc/ntk/logs/.


    Was this article helpful?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.