...
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
...
Mattermost Server/IP address: this is the server name or IP address of the Mattermost server.
...
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.
...
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.
...
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. |