mirror of https://github.com/zulip/zulip.git
105 lines
3.2 KiB
Markdown
105 lines
3.2 KiB
Markdown
# Import from HipChat (beta)
|
|
|
|
Starting with Zulip 1.9, Zulip supports importing data from HipChat,
|
|
including users, rooms, messages, avatars, and custom emoji.
|
|
|
|
**Note:** You can only import a HipChat group as a new Zulip
|
|
organization. In particular, you cannot use this tool to import data
|
|
from HipChat into an existing Zulip organization.
|
|
|
|
## Import from HipChat
|
|
|
|
First, export your data from HipChat.
|
|
|
|
{start_tabs}
|
|
{tab|cloud}
|
|
|
|
1. Log in at `yourdomain.hipchat.com/admin/`.
|
|
|
|
1. Click on the **Data Export** tab.
|
|
|
|
1. Select the data to export.
|
|
|
|
1. Click **Export**.
|
|
|
|
Once the export has completed, the export will be available to you in the
|
|
admin console.
|
|
|
|
{tab|server}
|
|
|
|
1. Upgrade to the latest version to ensure you have the latest updates to
|
|
the HipChat export dashboard.
|
|
|
|
1. Log in at the domain name configured for your Hipchat Server.
|
|
|
|
1. Click on **Server Admin > Export**.
|
|
|
|
1. Select the data to export.
|
|
|
|
1. Click **Export**.
|
|
|
|
Once the export has completed, you will receive an **email** with a link to
|
|
download the file.
|
|
|
|
!!! tip ""
|
|
If you are not on the latest version of Hipchat Server / Data Center,
|
|
you can do a command line export with `hipchat export --export`. See
|
|
HipChat's [command line export docs][cli-export] for more information.
|
|
|
|
{end_tabs}
|
|
|
|
!!! warn ""
|
|
**Note:** Only HipChat Group Administrators can export data from HipChat.
|
|
|
|
[cli-export]: https://confluence.atlassian.com/hipchatdc3/export-data-from-hipchat-data-center-913476832.html
|
|
|
|
### Import into zulipchat.com
|
|
|
|
Email support@zulipchat.com with exported HipChat archive and your desired
|
|
subdomain. Your imported organization will be hosted at
|
|
`<subdomain>.zulipchat.com`.
|
|
|
|
If you've already created a test organization at
|
|
`<subdomain>.zulipchat.com`, let us know, and we can rename the old
|
|
organization first.
|
|
|
|
### Import into a self-hosted Zulip server
|
|
|
|
First
|
|
[install a new Zulip server](https://zulip.readthedocs.io/en/stable/production/install.html),
|
|
skipping "Step 3: Create a Zulip organization, and log in" (you'll
|
|
create your Zulip organization via the data import tool instead).
|
|
|
|
Because the import tool is very new, you will need to
|
|
upgrade your Zulip server to the latest `master` branch,
|
|
using [upgrade-zulip-from-git][upgrade-zulip-from-git].
|
|
|
|
Log in to a shell on your Zulip server as the `zulip` user. To import with
|
|
the most common configuration, run the following commands, replacing
|
|
`<hipchat_export_file>` with the HipChat export file.
|
|
|
|
```
|
|
cd /home/zulip/deployments/current
|
|
./manage.py convert_hipchat_data <hipchat_export_file> --output converted_hipchat_data
|
|
./manage.py import '' converted_hipchat_data
|
|
```
|
|
|
|
This could take several minutes to run, depending on how much data you're
|
|
importing.
|
|
|
|
**Import options**
|
|
|
|
The commands above create an imported organization on the root domain
|
|
(`EXTERNAL_HOST`) of the Zulip installation. You can also import into a
|
|
custom subdomain, e.g. if you already have an existing organization on the
|
|
root domain. Replace the last line above with the following, after replacing
|
|
`<subdomain>` with the desired subdomain.
|
|
|
|
```
|
|
./manage.py import <subdomain> converted_hipchat_data
|
|
```
|
|
|
|
{!import-login.md!}
|
|
|
|
[upgrade-zulip-from-git]: https://zulip.readthedocs.io/en/latest/production/maintain-secure-upgrade.html#upgrading-from-a-git-repository
|