Linux

  1. Download the Hipchat to Mattermost migration file named HC2MM.jar. Java is required - Please see HC2MM Getting Started guide.

  2. 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.

  3. Create app.properties file in the WORKING_DIRECTORY. Fill the fields accordingly using the table provided here. Sample app.properties file.
              

  4. Execute .jar file:


    HC2MM execute command
    java -jar HC2MM.jar

             

  5. The HC2MM process will create flat files on both the Hipchat and Mattermost environments as well as the WORKING_DIRECTORY running the HC2MM application (HC2MM Application environment).

    Hipchat environment:

             Folder hipchat_export/ → contains flat files that will be deleted after the migration process has completed

    HC2MM Application server

             Folder hipchat_export/ → contains flat files that will be deleted after the migration process has completed

             working_directory/app.properties

             working_directory/migration.log*

             working_directory/mattermost.jsonl

    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.