Import from HipChat

Article summary

Did you find this summary helpful?

Thank you for your feedback

There are currently two different HipChat importers. One for HipChat cloud and another for HipChat enterprise.

HipChat cloud

To start importing values from HipChat you first need to have an instance of Rocket.Chat running. You can do that on your own.

If you already have an instance running and administration privileges, you can follow these steps:

Export data from HipChat
Wait until your download is ready and download it (it will be a .zip file)
Go to https://[your_rocket_chat].rocket.chat/admin/import and click the "Start" button on the "HipChat" item
Choose your downloaded .zip file and wait until Rocket.Chat can read it (it can take a few minutes, depending on the size of your HipChat export)
Deselect any items you don't want to import
At the top of the page, click Start Importing

To import your current data from HipChat Server / Data Center into Rocket.Chat, please do the following.

This is a copy from the HipChat Server / Data Center documentation:

Browse to the fully qualified domain name you've configured for your HipChat Server, for example https://hipchat.yourcompany.com/
Log in to the web user interface (UI) using your administrator email and password
Click Server admin > Export
To include files and one-to-one chat history in the export, select the checkboxes
Create a password to protect your archive file in the Password and Confirm Password fields. You're required to provide this password when you import your data into HipChat Server. We don't store this password, so be sure to remember it
Click Export. Depending on how much data you have, it may take a few hours to export the data. When it's finished, you'll receive an email with a link to download the file
When you receive the email, click the link in the email to download the archive file

Decrypt the exported file: openssl aes-256-cbc -d -in path_to_encrypted_file.tar.gz.aes -out path_to_decrypted_file.tar.gz -pass pass:your_password . See the table below for descriptions of the command line arguments
Ensure the file generated is a tar.gz file, otherwise Rocket.Chat won't accept it
Go to https://[your_rocketchat]/admin/import/prepare/hipchatenterprise
Choose your decrypted tar.gz file and wait until Rocket.Chat can read it (it can take a few minutes, depending on the size of your export)
Deselect any items you don't want to import
At the top of the page, click on Start Importing

Argument	Notes
`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.

In case you get digital envelope routines:EVP_DecryptFinal_ex:bad decrypt:../crypto/evp/evp_enc.c:541: while decrypting, add the parameter -md md5
If the import fails for large HipChat exports, it may help not to export file attachments. Refer to https://github.com/RocketChat/Rocket.Chat/issues/11693.
If you still have problems contact us at [email protected] and provide your server logs if available.

Was this article helpful?

On this page