Deploy ossimport in standalone mode

Prerequisites

Ensure the following requirements are met:

• Java 1.7 or 1.8 is installed.

Download and configure ossimport

1. Download and decompress ossimport-2.3.7.zip. After decompression, the directory structure is as follows:

      ossimport
      ├── bin
      │   └── ossimport2.jar  # JAR package containing the Master, Worker, TaskTracker, and Console modules
      ├── conf
      │   ├── local_job.cfg   # Migration job configuration file
      │   └── sys.properties  # System parameters configuration file
      ├── console.bat         # Windows command-line tool for running tasks
      ├── console.sh          # Linux command-line tool for running tasks
      ├── import.bat          # Windows one-click import script (start, migration, verification, and retry)
      ├── import.sh           # Linux one-click import script (start, migration, verification, and retry)
      ├── logs                # Log directory
      └── README.md           # ossimport description file

2. Edit conf/sys.properties and conf/local_job.cfg for your migration. Do not modify the following items. Configuration file examples. > Important: Verify all parameters in sys.properties and local_job.cfg before submitting a job. Parameters cannot be changed after submission.

   • The workingDir, workerUserName, workerPassword, and privateKeyFile parameters in conf/sys.properties

   • The name and path of the conf/local_job.cfg file

   • The jobName parameter in conf/local_job.cfg

Run a migration job

ossimport provides two ways to run migration jobs:

• One-click import -- Runs all migration steps through a single script. Best for first-time users.

• Step-by-step import -- Runs each migration step individually through Console commands.

View job status and logs

After a job is submitted, the Master splits it into tasks, the Worker executes the tasks, and the TaskTracker collects task status. The following directory structure shows key files generated after a job completes:

ossimport
├── bin
│   └── ossimport2.jar          # JAR package for standalone mode
├── conf
│   ├── local_job.cfg           # Migration job configuration file
│   └── sys.properties          # System parameters configuration file
├── console.sh                  # Command-line tool
├── import.sh                   # One-click import script
├── logs
│   ├── import.log              # Migration logs
│   ├── job_stat.log            # Job status logs
│   ├── ossimport2.log          # ossimport run logs for standalone mode
│   └── submit.log              # Job submission logs
├── master
│   ├── jobqueue                # Jobs not yet split into tasks
│   └── jobs
│       └── local_test          # Job name
│           ├── checkpoints     # Checkpoints from Master splitting the job into tasks
│           │   └── 0
│           │       └── 034DC9DD2860B0CFE884242BC6FF92E7.cpt
│           ├── dispatched      # Tasks dispatched to the Worker but not yet complete
│           │   └── localhost
│           ├── failed_tasks    # Failed tasks
│           ├── pending_tasks   # Tasks not yet dispatched
│           └── succeed_tasks   # Successfully completed tasks
│               └── A41506C07BF1DF2A3EDB4CE31756B93F_1499744514501@localhost
│                   ├── audit.log   # Task run logs (use for error diagnosis)
│                   ├── DONE        # Mark file indicating task completion
│                   ├── error.list  # Task errors
│                   ├── STATUS      # Task status: Failed or Completed
│                   └── TASK        # Task description
└── worker                      # Tasks currently running (managed by Master after completion)
    └── jobs
        └── local_test
            └── tasks

Verify migration results

ossimport does not verify data consistency or integrity after migration. After a job completes, verify that the data at the source and destination match.

Troubleshooting

Common causes of migration failures: