Documentation Index

Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

Create and manage app

Prev Next

Available in VPC

This guide provides information about the apps available in Data Forest and explains how to create and manage them. Data Forest offers15 apps. Any app can run as a Docker container, and with Data Forest, you can build big data systems optimized for your users.

Note

For more information on the types of apps provided by Data Forest, see Data Forest prerequisites.

Create an app

To create an app, follow these steps:

  1. Create an account to own the app.
  2. In the VPC environment on the NAVER Cloud Platform console, navigate to Menu > All Services > Big Data & Analytics > Data Forest.
  3. Click Data Forest > Apps on the left.
  4. Enter details about the app you want to create on the basic settings interface.
    df-app_2-1_vpc_ko
    Name Description
    Account name
    • Account that owns the app.
    • Select the account to access the app.
    App type
    • Select the app type to create.
    • In the example, GRAFANA-7.5.10 is selected.
    App name
    • Designate the name of the app to create.
    • Minimum of 3 characters, maximum of 20 characters including account and app name.
    • Only lowercase letters, numbers, and hyphens (-) are allowed.
    Runtime
    • Duration (in seconds) that the created app runs before termination.
    • -1 (permanent) or 300 seconds (5 minutes) to 604,800 seconds (7 days).
    Version
    • Version updates when the app configuration is modified.
    • Version number increments with each update.
    • Enter v1 when creating an app.
    Queue
    • Specify the YARN queue for running the app.
    • Longlived: shared queue for service apps.
    Application Master
    vCPU
    • Number of vCPUs required to run the Application Master (fixed at 1 vCPU).
    Application Master
    Memory
    • Amount of memory required to run the Application Master (fixed at 4 GB).
    Component
    • List of components that make up the application.
    • Default components are predefined by application type, and only component resources can be configured by the user.
    • The default value is the recommended resources.
  5. When settings are completed, click [Next].
  6. On the user settings interface, enter the parameter values for the app you want to create.
    df-app_2-2_vpc_ko
    Name Description
    Parameters
    • List of configurable parameters of the app.
    • Configurable parameters are predefined by app type, and users can set only parameter values.
    • The default value is the recommended resources.
    Import Restore settings for the same app that you previously created.
    Initialize Initialize entered parameter values to default.
  7. When settings are completed, click [Next].
  8. After finalizing the confirmation, click [Create].
      • For all apps, the application is submitted to YARN immediately upon creation request, and it takes about 1 to 2 minutes to complete the app creation.
        df-app_2-3_vpc_ko
Note

Runtime: The duration from when the app starts running until it terminates.
By default, the app is created with a runtime of 604,800 seconds (7 days), after which it is automatically terminated (killed).

View app details

To view app details:

  1. In the VPC environment on the NAVER Cloud Platform console, navigate to Menu > All Services > Big Data & Analytics > Data Forest.
  2. Click Data Forest > Apps on the left. You can view a list of the different apps that the user has run.
    df-app-control_01_vpc_ko(1)
    Item Description
    App name The name of the app
    Account Accounts that can access the app
    Status App status. App details need to be checked even if it's running.
    Start Time App start time
    End Time App end time
    Elapsed Time App runtime
  3. Click the df-app_openat the end of the app list to view the app's details.
    df-app_3-4_vpc_ko
    Item Description
    App type App type
    Status App status
    • CREATING: The application is being created. When creation completes successfully, the status changes to RUNNING.
    • ACCEPTED: The YARN scheduler has received a request to run the application
    • RUNNING: Resources are allocated to the Application Master and the application is running.
    • KILLED: The application has been closed unexpectedly. It may terminate when Lifetime expires.
    • FINISHED: The application has completed successfully by user action.
    • STOPPED: The application is stopped. It can be restarted. It has the same application ID.
    • FAILED: The application creation has failed. The failure may be due to an internal error. Retry the operation or contact customer support.
    • CHANGING: The application is being modified. It usually shows when the lifetime is being edited or flexed. The status changes to RUNNING when the change is completed successfully.
    • DELETING: The application is being deleted by user action.
    App name The name of the app
    Lifetime The remaining runtime of the app.
    App stops when app runtime reaches 0 seconds.
    Click the [Edit] to extend the app's runtime.
    Version Version updates when the app configuration is modified.
    Version number increments with each update.
    Enter v1 when creating an app.
    Queue name Selected queue when creating the app
    Application ID Application ID received after the app was submitted to YARN
    Account Accounts that can access the app
    User settings Parameter values set in the app
Note
  • Even if the Status in the app list is Running, the app might not be finished running. To ensure that all the containers that make up your app are up and running, you must ensure that the Status in the app details is Stable.
  • The Status in the app list refers to the status of the YARN Application, and the Status in the app details refers to the status of the YARN Service.

App management

Shut down the Application Manager node

If the app is having an issue or is not working properly, restart Application Manager (AM) ([Kill AM]). You can determine the status from the newly started AM and get the app back to normal.

  1. In the VPC environment on the NAVER Cloud Platform console, navigate to Menu > All Services > Big Data & Analytics > Data Forest.
  2. Click Data Forest > Apps on the left.
  3. Select your account and choose an app.
  4. Click the [Kill AM] to view the app details.

Adjust the number of containers

You can adjust the number of containers by component.

To change the number of containers in a component, follow these steps:

  1. In the VPC environment on the NAVER Cloud Platform console, navigate to Menu > All Services > Big Data & Analytics > Data Forest.
  2. Click Data Forest > Apps on the left.
  3. Select your account, select the apps you want to adjust the number of containers, and click the [Flex].
  4. When the popup window appears, edit the number of containers and click the [Edit].
    df-app-control_04_vpc_ko
Caution

Changing the number of containers may result in data loss, so take appropriate measures, such as backups, and only edit the number of containers if necessary.

Start an app

To restart an app that you've ended, follow these steps:

  1. In the VPC environment on the NAVER Cloud Platform console, navigate to Menu > All Services > Big Data & Analytics > Data Forest.
  2. Click Data Forest > Apps on the left.
  3. Select your account, choose the app you want to start from the list of apps, and click the [Start].

End the app

To close the app, follow these steps:

  1. In the VPC environment on the NAVER Cloud Platform console, navigate to Menu > All Services > Big Data & Analytics > Data Forest.
  2. Click Data Forest > Apps on the left.
  3. Select your account, select the app you want to close from the list of apps, and click the [Close].

Delete an app

To delete an app, follow these steps:

  1. In the VPC environment on the NAVER Cloud Platform console, navigate to Menu > All Services > Big Data & Analytics > Data Forest.
  2. Click Data Forest > Apps on the left.
  3. Select the account and ensure the app you want to delete is closed in the app list.
    • Before you delete an app, you must quit the app.
  4. Select the app you want to delete and click [Delete].