Migrating data to your enterprise

After generating a migration archive, you can import the data to your target GitHub Enterprise Server instance. You'll be able to review changes for potential conflicts before permanently applying the changes to your target instance.

As a site admin, SSH into your target GitHub Enterprise Server instance.
```
$ ssh -p 122 admin@HOSTNAME
```
Using the ghe-migrator import command, start the import process. You'll need:
- Your Migration GUID. For more information, see "Preparing to migrate data to your enterprise."
- Your personal access token for authentication. The personal access token that you use is only for authentication as a site administrator, and does not require any specific scope. For more information, see "Creating a personal access token."
```
$ ghe-migrator import /home/admin/MIGRATION_GUID.tar.gz -g MIGRATION_GUID -u username -p TOKEN

> Starting GitHub::Migrator
> Import 100% complete /
```
- To specify where migration files should be staged append the command with --staging-path=/full/staging/path. Defaults to /data/user/tmp.

Reviewing migration data

By default, ghe-migrator audit returns every record. It also allows you to filter records by:

The types of records.
The state of the records.

The record types match those found in the migrated data.

Record type filters

Record type	Filter name
Users	`user`
Organizations	`organization`
Repositories	`repository`
Teams	`team`
Milestones	`milestone`
Project boards	`project`
Issues	`issue`
Issue comments	`issue_comment`
Pull requests	`pull_request`
Pull request reviews	`pull_request_review`
Commit comments	`commit_comment`
Pull request review comments	`pull_request_review_comment`
Releases	`release`
Actions taken on pull requests or issues	`issue_event`
Protected branches	`protected_branch`

Record state filters

Record state	Description
`export`	The record will be exported.
`import`	The record will be imported.
`map`	The record will be mapped.
`rename`	The record will be renamed.
`merge`	The record will be merged.
`exported`	The record was successfully exported.
`imported`	The record was successfully imported.
`mapped`	The record was successfully mapped.
`renamed`	The record was successfully renamed.
`merged`	The record was successfully merged.
`failed_export`	The record failed to export.
`failed_import`	The record failed to be imported.
`failed_map`	The record failed to be mapped.
`failed_rename`	The record failed to be renamed.
`failed_merge`	The record failed to be merged.

Filtering audited records

With the ghe-migrator audit command, you can filter based on the record type using the -m flag. Similarly, you can filter on the import state using the -s flag. The command looks like this:

$ ghe-migrator audit -m RECORD_TYPE -s STATE -g MIGRATION_GUID

For example, to view every successfully imported organization and team, you would enter:

$ ghe-migrator audit -m organization,team -s mapped,renamed -g MIGRATION_GUID
> model_name,source_url,target_url,state
> organization,https://gh.source/octo-org/,https://ghe.target/octo-org/,renamed

We strongly recommend auditing every import that failed. To do that, you will enter:

$ ghe-migrator audit -s failed_import,failed_map,failed_rename,failed_merge -g MIGRATION_GUID
> model_name,source_url,target_url,state
> user,https://gh.source/octocat,https://gh.target/octocat,failed
> repository,https://gh.source/octo-org/octo-project,https://ghe.target/octo-org/octo-project,failed

If you have any concerns about failed imports, contact GitHub Enterprise Support or GitHub Premium Support.

Completing the import on GitHub Enterprise Server

After your migration is applied to your target instance and you have reviewed the migration, you''ll unlock the repositories and delete them off the source. Before deleting your source data we recommend waiting around two weeks to ensure that everything is functioning as expected.

Unlocking repositories on the target instance

SSH into your GitHub Enterprise Server instance. For more information, see "Accessing the administrative shell (SSH)."
```
$ ssh -p 122 admin@HOSTNAME
```
Unlock all the imported repositories with the ghe-migrator unlock command. You'll need your Migration GUID:
```
$ ghe-migrator unlock -g MIGRATION_GUID
> Unlocked octo-org/octo-project
```

Unlocking repositories on the source

Unlocking repositories from an organization on GitHub.com

To unlock the repositories on a GitHub.com organization, you'll send a DELETE request to the migration unlock endpoint. You'll need:

Your access token for authentication
The unique id of the migration

The name of the repository to unlock

curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \
  -H "Accept: application/vnd.github.wyandotte-preview+json" \
  https://api.github.com/orgs/orgname/migrations/id/repos/repo_name/lock

Deleting repositories from an organization on GitHub.com

After unlocking the GitHub.com organization's repositories, you should delete every repository you previously migrated using the repository delete endpoint. You'll need your access token for authentication:

curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \
  https://api.github.com/repos/orgname/repo_name

Unlocking repositories from a GitHub Enterprise Server instance

SSH into your GitHub Enterprise Server instance. For more information, see "Accessing the administrative shell (SSH)."
```
$ ssh -p 122 admin@HOSTNAME
```
Unlock all the imported repositories with the ghe-migrator unlock command. You'll need your Migration GUID:
```
$ ghe-migrator unlock -g MIGRATION_GUID
> Unlocked octo-org/octo-project
```