Export data from Hipchat Data Center
You can export the data from your Hipchat Data Center deployment, either to migrate to a new deployment, or for message archive purposes. See Export and import data from Hipchat Data Center for a list of what an export contains.
On this page:
To automate exports, you can download and customize the shell script hosted in: https://hipchat-server-stable.s3.amazonaws.com/utils/hipchat_server_remote_exporter.sh.
Exporting using the CLI
You can export your Hipchat data from Hipchat Data Center using the CLI.
Run the following command to export the data, replacing your_password with the password you'll use to protect the resulting archive file.
hipchat export --export -p your_password| 引数 | 注意 |
|---|---|
--export or -e | This is the argument that starts the export packaging process. |
--passphrase or -p | To protect your archive file, you're required to provide this password when you import your data into Hipchat Data Center. We don't store this password, so be sure to remember it. |
The following table lists additional (optional) arguments for your export.
| 引数 | 注意 |
|---|---|
| Display help content for exports. Use this as a standalone argument, and not paired with the actual export argument. |
| Check the status of your export, which can take a few hours, depending on how much data you have. Use this as a standalone argument, and not paired with the actual export argument. |
| Include 1-to-1 chat history in the export. |
| Include files (attachments) in the export. |
--notify | Space-separated list of email addresses, in addition to the Hipchat Data Center admin, to get an email when the export job is finished. 例: hipchat export -e -p your_password --notify her@example.com him@example.com |
Example export command
Here's a sample command to use for an export that includes 1-to-1 chats and files, and notifies two people when the export finishes:
hipchat export --export --include_oto --include_attachments --passphrase your_password --notify jim@example.com pam@example.comFor more help with the commands, type hipchat export in the CLI.
Check the status of your export job
Depending on how much data you have, the export can take a few hours.
To check the status of your Hipchat Data Center export job, run the following command:
hipchat export --checkA message appears, giving the status of the export.
Cancel an export job
If you need to cancel an export job that's in progress, you can run the following command:
hipchat export --cancel
Decrypting the exported files
To view the contents of your exported files without importing them into Hipchat Data Center, run the following command to decrypt the archive file:
openssl aes-256-cbc -d -in path_to_encrypted_file -out path_to_decrypted_file -pass pass:your_password
The following table explains those arguments more.
| 引数 | 注意 |
|---|---|
aes-256-cbc | This is the cipher to use to decrypt the file. |
-d | This argument is the command to decrypt the file. |
-in | Use this to specify the path to the archive file you're about to decrypt. |
-out | Use this to specify the path where you want to output the decrypted file. |
-pass pass: | Enter the password you created when you exported the archive file. |
Purge exported files
You can also purge exported files by their age in days. To delete export files that are older than 7 days old, run the following command:
hipchat export --purge-older-than 7