Skip to content

Help Wanted: Document migration process from an Omnibus install to a normal one #4237

Closed
@matterdoc

Description

@matterdoc

Context

The Mattermost Product Documentation doesn't currently include details on how to migrate from an Omnibus Mattermost deployment to a regular Mattermost deployment.

Documentation request

Document how to migrate from an Omnibus Mattermost deployment to a regular Mattermost deployment based on the details included below.

Migrating from an Omnibus Mattermost deployment to a regular deployment involves several steps, as you would need to set up a standalone Mattermost server and migrate your data. Below is a high-level outline of the steps:

  1. Prepare Your New Environment
  • Provision a new server that meets the hardware and software requirements for a standalone Mattermost server.
  • Install the prerequisites such as PostgreSQL database, storage, and other dependencies.
  1. Back up Your Current Deployment

Important note: Omnibus uses the configuration in the database feature, so your server configuration won't be in the config.json file, and your data directory would be the same that you have specified in the /etc/mattermost/mmomni.yml file, under the key data_directory

  1. Set Up the Standalone Mattermost Server
  • Install Mattermost: Follow the Mattermost deployment instructions for your operating system. See the deployment documentation for details.
  1. Configure and Restore Data
  • Database: Import your database backup into the new database server.
  • Configuration: Configure the config.json file initially to point to your new database.
    Since your configuration is stored in the database, after you import the database, Mattermost should pull its configuration from there.
  • Files: Restore the files from the data directory mentioned in your /etc/mattermost/mmomni.yml file to the new data directory.
  1. Testing
  • Test your new setup: Verify that the new Mattermost server is functioning correctly. Ensure that all data and configurations are correct and users are able to log in and access their information.
    
6. Go Live
  • Switch DNS/Load Balancer: If applicable, update any DNS records or load balancers to point to your new Mattermost server.
  • Inform Users: Notify your users of the migration and any potential downtime.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions