# dm

**Repository Path**: hiekay/dm

## Basic Information

- **Project Name**: dm
- **Description**: DM (Data Migration) 是一体化数据同步任务管理平台，支持全量备份和 MariaDB/MySQL binlog 增量同步，设计的主要目的是： 标准化 （例如:工具运
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2019-01-29
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Data Migration Platform

[![Build Status](https://internal.pingcap.net/idc-jenkins/job/build_dm/badge/icon)](https://internal.pingcap.net/idc-jenkins/job/build_dm/)
![GitHub release](https://img.shields.io/github/tag-pre/pingcap/dm.svg)
[![Coverage Status](https://coveralls.io/repos/github/pingcap/dm/badge.svg)](https://coveralls.io/github/pingcap/dm)
[![Go Report Card](https://goreportcard.com/badge/github.com/pingcap/dm)](https://goreportcard.com/report/github.com/pingcap/dm)

**DM** is an integrated platform, supports migrating data from MySQL/MariaDB to TiDB.

## Architecture

![architecture](https://pingcap.com/images/docs/dm-architecture.png)

## Documentation

* [Detailed documentation](https://pingcap.com/docs/tools/data-migration-overview/)
* [简体中文文档](https://github.com/pingcap/tidb-tools/blob/docs/docs/dm/zh_CN/README.md)

## Building

To check the source code, run test cases and build binaries, you can simply run:

```bash
make build
```

If you only want to build binaries, you can run:
```bash
make dm-worker  # build DM-worker

make dm-master  # build DM-master

make dmctl      # build dmctl
``` 

When DM is built successfully, you can find binaries in the `bin` directory.

## Installing

* The best way to install DM is via [DM-Ansible](https://pingcap.com/docs/tools/data-migration-deployment/)
* deploy DM manually
  ```
  # Download the DM package.
  wget http://download.pingcap.org/dm-latest-linux-amd64.tar.gz
  wget http://download.pingcap.org/dm-latest-linux-amd64.sha256

  # Check the file integrity. If the result is OK, the file is correct.
  sha256sum -c dm-latest-linux-amd64.sha256

  # Extract the package.
  tar -xzf dm-latest-linux-amd64.tar.gz
  cd dm-latest-linux-amd64
  ```

## Config File

* all sample config files can be found in directory `conf` of dm tarball
* sample config file of dm-master: `bin/dm-master -print-sample-config`
* sample config file of dm-worker: `bin/dm-worker -print-sample-config`


## Contributing
Contributions are welcomed and greatly appreciated. See [CONTRIBUTING.md](./CONTRIBUTING.md)
for details on submitting patches and the contribution workflow.

## License
DM is under the Apache 2.0 license. See the [LICENSE](./LICENSE) file for details.