Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »


  1. Download the Hipchat to Mattermost migration executable file named HC2MM.

  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 is referred to as WORKING_DIRECTORY.

  3. 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.  Enter the valid credentials by following the descriptions given on the table provided here.  Here is an example of the app.properties file.

  4. Launch the application. For Linux/Unix go to step 17. 


  5. For Windows/Mac: You will see the following graphical user interface.  Fill the fields accordingly using the table provided here.



  6. Hipchat Server/IP address: this is the server name or IP address of the Hipchat Server


  7. Hipchat Server User 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.

  8. Hipchat Server User Password: The password for the above entered Hipchat Server User Id.  

  9. Hipchat Server Environment: Amazon Web Services or Linux/Unix
     
  10. 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.

  11. Mattermost Server/IP address: this is the server name or IP address of the Mattermost Server

     

  12. 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 Hipchat  admin password or Hipchat PEM file location is needed.
       

  13. Mattermost Server User Password: The password for the above entered Hipchat Server User Id.  

  14. Mattermost Server Environment: Amazon Web Services or Linux/Unix

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

  16. Click Migrate to launch the migration process.
      

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


    Users created in Mattermost will need to reset their passwords.

    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.

    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.

    HC2MM has been tested on a maximum of 4500 users.



  • No labels