...
- Download the Hipchat to Mattermost migration executable file named HC2MM.
- Copy the executable file to any machine that can access both your Hipchat server and your Mattermost server. The directory on which the executable is saved and run is referred to as WORKING_DIRECTORY.
If the machine is running Windows or Mac go to step 4. If the machine is running Linux or Unix create a properties file called app.properties in the WORKING_DIRECTORY or download this example of the app.properties file. Edit the app.properties file to enter the valid credentials by following the descriptions given on the table provided here.
Launch the application. For Linux/Unix go to step 17.
For Windows/Mac: You will see the following graphical user interface. Fill the fields accordingly using the table provided here.
Hipchat Server/IP address: this is the server name or IP address of the Hipchat Server
- Hipchat Server User Admin Id: This is the system username of a user having access to export data from the Hipchat server.
If Hipchat is running in AWS then a PEM file is required to access the server from the machine where the application is executed. see Amazon EC2 Key Pairs for information on PEM files.
If Hipchat is running in a Linux/Unix environment, either Hipchat admin password or Hipchat PEM file location is needed. - Hipchat Server User Admin Password: The password for the above entered Hipchat Server User server Admin Id.
- Hipchat Server Environment: Amazon Web Services or Linux/Unix.
- Hipchat PEM file location: This is the location of the PEM file present on the machine on which the application is running. It can be selected using the browse button.
Mattermost Server/IP address: this is the server name or IP address of the Mattermost Serverserver.
Mattermost Server User Id: This is the system username (here on referred to as "admin") with access to export data from the Mattermost server.
If Mattermost is running in AWS, then a PEM file is required to access the server from the machine where the application is executed. see Amazon EC2 Key Pairs for information on PEM files.
If Mattermost is running in a Linux/Unix environment, either Mattermost admin password or Mattermost server PEM file location is needed.
- Mattermost Server User Password: The password for the above entered Mattermost server User Id.
- Mattermost Server Environment: Amazon Web Services or Linux/Unix.
Click Validate on the Hipchat and Mattermost panels in the user interface. This will check that the administrator's username and password are correct and verify a connection to Hipchat and Mattermost instances. Upon successful validation of both Hipchat and Mattermost panels, the Migrate button will become enabled.
Click Migrate to launch the migration process.
The HC2MM application will create flat files on both the Hipchat and Mattermost server machines as well as the server running the HC2MM application(HC2MM Application server).
Hipchat server:
export_file.targz → will be deleted after the migration process has completed
HC2MM Application server
working_directory/app.properties*
working_directory/migration.log*
Mattermost server:
mattermost.jsonl→ will be deleted after the migration process has completed
*The remaining files on the HC2MM server machine must be removed manually. Please follow your company's compliance rules regarding sensitive data files.
Info Clicking Cancel will stop the migration process and close the User Interface. Any files created will remain on the server until deleted manually.
Info Users created in Mattermost will need to reset their passwords.
Info For any issues please refer to the log file migration.log. This log file is located in the directory where the executable is save and running.
Info NOTE: Attachments from Hipchat are not currently included in the migration process to Mattermost. Profile images from Hipchat are not currently included in the migration process to Mattermost.
Info HC2MM has been tested on a maximum of 4500 users.
...