From d8e5e0e68f6c041a81e4e497dcb206f0786f49d2 Mon Sep 17 00:00:00 2001 From: Lee Matos Date: Mon, 16 Jan 2017 17:20:55 +0000 Subject: Update README.md to include troubleshooting instructions --- doc/workflow/importing/README.md | 51 ++++++++++++++++++++++++++-------------- 1 file changed, 34 insertions(+), 17 deletions(-) (limited to 'doc/workflow/importing/README.md') diff --git a/doc/workflow/importing/README.md b/doc/workflow/importing/README.md index 2d91bee0e94..15aeb59037f 100644 --- a/doc/workflow/importing/README.md +++ b/doc/workflow/importing/README.md @@ -1,17 +1,34 @@ -# Migrating projects to a GitLab instance - -1. [Bitbucket](import_projects_from_bitbucket.md) -1. [GitHub](import_projects_from_github.md) -1. [GitLab.com](import_projects_from_gitlab_com.md) -1. [FogBugz](import_projects_from_fogbugz.md) -1. [Gitea](import_projects_from_gitea.md) -1. [SVN](migrating_from_svn.md) - -In addition to the specific migration documentation above, you can import any -Git repository via HTTP from the New Project page. Be aware that if the -repository is too large the import can timeout. - -### Migrating from self-hosted GitLab to GitLab.com - -You can copy your repos by changing the remote and pushing to the new server; -but issues and merge requests can't be imported. +# Migrating projects to a GitLab instance + +1. [Bitbucket](import_projects_from_bitbucket.md) +1. [GitHub](import_projects_from_github.md) +1. [GitLab.com](import_projects_from_gitlab_com.md) +1. [FogBugz](import_projects_from_fogbugz.md) +1. [Gitea](import_projects_from_gitea.md) +1. [SVN](migrating_from_svn.md) + +In addition to the specific migration documentation above, you can import any +Git repository via HTTP from the New Project page. Be aware that if the +repository is too large the import can timeout. + +### Migrating from self-hosted GitLab to GitLab.com + +You can copy your repos by changing the remote and pushing to the new server; +but issues and merge requests can't be imported. + +### Troubleshooting Migration issues. + +You'll need admin access to the Gitlab Instance. You can run the following commands: + +``` +gitlab-rails console production +project = Project.find_with_namespace('group/user/project') +project.import_error +# If you are confident that the errors are minor, you could manually finish the import +# This could have unintended side effects, so work to fix the import errors before trying this. +project.import_finish + +``` + +This output will let you know what was causing the errors for the import +so that you can correct them. \ No newline at end of file -- cgit v1.2.1