Skip to content
This repository was archived by the owner on Apr 20, 2023. It is now read-only.

Commit 9bcd37a

Browse files
committed
Updates to readme. Adding artifact.json
1 parent 4a19b16 commit 9bcd37a

File tree

2 files changed

+457
-2
lines changed

2 files changed

+457
-2
lines changed

README.md

Lines changed: 66 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,66 @@
1-
# msyql_sdk_plugin
2-
MySQL SDK Plugin for Delphix
1+
# MySQLLinux
2+
3+
## What Does a Delphix Plugin Do?
4+
Delphix is a data management platform that provides the ability to securely copy and share datasets. Using virtualization, you will ingest your data sources and create virtual data copies, which are full read-write capable database instances that use a small fraction of the resources a normal database copy would require. The Delphix engine has built-in support for interfacing with certain types of datasets, such as Oracle, SQL Server and ASE.
5+
6+
The Delphix virtualization SDK (https://github.com/delphix/virtualization-sdk) provides an interface for building custom data source integrations for the Delphix Dynamic Data Platform. The end users can design/implement a custom plugin which enable them to use custom data source like MySQL, MongoDB, Cassandra, MySQL or something else similar to as if they are using a built-in dataset type with Delphix Engine.
7+
8+
## MySQL Plugin
9+
MySQL plugin is developed to virtualize MySQL data source leveraging the following built-in MySQL technologies:
10+
Features:
11+
- Environment Discovery: MySQL plugin can discover environments where MySQL server is installed.
12+
- Ingesting Data: Create a dSource using differnt methods specified below.
13+
- VDB Creation: Single node MySQL VDB can be provisioned from the dsource snapshot.
14+
15+
Different Ways to Ingest Data ( Dsource creation )
16+
- Replication with Delphix initiated Backup: Delphix takes an initial backup from source DB to ingest data and create a dSource. Delphix also sets up a master-slave replication to keep this dSource in sync with the source database. User can select the databases they want to virtualize
17+
- Replication with User Provided Backup: User provides a backup file from source DB to ingest data and create a dSource. Delphix sets up a master-slave replication to keep this dSource in sync with your source database.
18+
- User Provided Backup with no Replication: User provides a backup file from source DB to ingest data and create a dSource. When a new backup is available, user initiates a resync of the dSource to ingest data from the new backup.
19+
- Manual Backup Ingestion: Delphix creates an empty seed datanase and User manually ingests a backup to create a dSource.
20+
21+
22+
### <a id="upload-plugin"></a>Steps to build, upload and run unit tests for plugin
23+
24+
1. Build the source code. It generates the build with name `artifacts.json`:
25+
```bash
26+
dvp build
27+
```
28+
dvp version 2.1 required.
29+
30+
2. Upload the `artifacts.json` ( generated in step 1 ) on Delphix Engine:
31+
```bash
32+
dvp upload -e <Delphix_Engine_Name> -u <username> --password <password>
33+
```
34+
35+
36+
### <a id="run_unit_test_case"></a>Download plugin logs
37+
#### Plugin Logs:
38+
Download the plugin logs using below command:
39+
40+
```dvp download-logs -c plugin_config.yml -e <Delphix_Engine_Name> -u admin --password <password>```
41+
42+
43+
### <a id="tested-versions"></a>Tested Versions
44+
- Delphix Engine: 6.0.4.0 and above
45+
- MySQL Versions 5.7.x above 5.7.6.
46+
- Linux Version: RHEL 6.x, 7.x
47+
48+
### <a id="support-features"></a>Supported Features
49+
- MySQL Replication
50+
- MySQL Manual Backup Ingestion
51+
52+
### <a id="unsupported-features"></a>Unsupported Features
53+
- MySQL Clusters
54+
- Sharded MySQL Databases
55+
56+
### <a id="contribute"></a>How to Contribute
57+
58+
Please read [CONTRIBUTING.md](./CONTRIBUTING.md) to understand the pull requests process.
59+
60+
### <a id="statement-of-support"></a>Statement of Support
61+
62+
This software is provided as-is, without warranty of any kind or commercial support through Delphix. See the associated license for additional details. Questions, issues, feature requests, and contributions should be directed to the community as outlined in the [Delphix Community Guidelines](https://delphix.github.io/community-guidelines.html).
63+
64+
### <a id="license"></a>License
65+
66+
This is code is licensed under the Apache License 2.0. Full license is available [here](./LICENSE).

artifact.json

Lines changed: 391 additions & 0 deletions
Large diffs are not rendered by default.

0 commit comments

Comments
 (0)