edit-icon download-icon

Deploy software

Last Updated: Apr 09, 2018

This article describes how to deploy the Data Transport software and the basic operations of this software.

Install the software package

  1. Unzip the installation package.

    Once you have received the installation package InstallPackage.tar, upload it to a location in the Linux system (such as /opt/Cube). Switch to the directory where the InstallPackage.tar file is located. Enter command unzip InstallPackage.tar to unzip the installation package. After unzipping, the directory looks like the following:

    1-1

  2. Configure the JDK 1.8 environment variables.

    Data Transport runs in an environment of JDK 1.8 or later. In the installation package, the InstallPackage directory contains “jdk1.8.0_131.” Go to the following directory and create soft links of Linux environment variables for the Java executable files under this directory.

    ln -s /opt/Cube/InstallPackage/jdk1.8.0_131/bin/java /usr/bin/java

    Enter command “java -version” to view the Java version information. Make sure the version information displayed is the same as the version installed: 1.8.0_131.

2 Run the software

  1. Start the service

    • Unzip the installation package under the directory /InstallPackage/cube. Enter the directory and you can find the cube.sh script. Enter command ./cube.sh” to start the Data Transport service.

      3-1

    • Go to the user interface of Data Transport.

      3-2

  2. Basic operations

    1. In the Data Transport user interface, you can see nine options numbered from 1 through 7, 9, and 0. The details of these operations are as follows:

      • start service: Start the Data Transport service process
      • stop service: End the Data Transport service process
      • submit job: Create and submit jobs
      • delete job: Delete jobs
      • re-try job: Retry failed jobs
      • re-run local tasks in job: Rerun previously submitted local tasks in a job
      • get job status: Obtain the job status
      • Reset password: Reset the password
      • exit menu: Exit the user interface
    2. After logging in for the first time, enter 9 to reset the password. The new password must contain at least 10 characters, with a combination of uppercase letters, lowercase letters, numbers, and special characters.

      4-1

    3. Once the new password is set, enter 1 and use the new password to start the service process of Data Transport.

      4-2

  3. Download

    1. Once the service process starts, enter 3 to create and submit jobs. When creating the job, select the job type (1 for download, 2 for upload), and follow the prompt to enter required information, such as the job name.

      4-3

    2. Select 1 to download, enter the source path and the target path, and then confirm the download job.

      4-5

    3. After submitting the job, enter 7 to view the job status.

      7

      The parameters include:

      • JobName: The name of the job
      • JobState: The status of the job
      • PendingTasks: The number of tasks to be executed
      • DispatchedTasks: The number of tasks sent
      • RunningTasks: The number of tasks being executed
      • SucceedTasks: The number of tasks that have completed execution
      • FailedTasks: The number of failed tasks
      • ScanFinished: Whether the scan is complete

      A job status of Running indicates that the job is being executed. A job status of Succeed indicates that the job has completed data transmission. If the job fails, enter 5 to run the failed job again.

  4. Other operations

    1. Once the data transmission is complete, enter 2 to end the service process of Data Transport.

      4-6

    2. Before the service process of Data Transport starts, or after it ends, enter 4 to specify the job name and delete the previously created job.

      4-7

    3. Enter 0 to exit the user interface of Data Transport and return to the system interface.

      4-9

  5. View the logs

    While the jobs are running, log information such as the status is saved under /opt/Cube/InstallPackage/cube/logs (example path). The main logs are master.log and worker.log.

    1. View master.log

      This log provides an overview of the jobs, including job name, status, total number of jobs, number of jobs already executed, number of failed jobs, and whether all the files have been scanned.

      masterlog

    2. View worker.log

      You can view information, such as the status, ID, and size of a specific job. You can also view the specific job files.

      workerlog

Thank you! We've received your feedback.