Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Open
matterdoc opened this issue Jan 13, 2021 · 0 comments
Labels

Comments

@matterdoc
Copy link

matterdoc commented Jan 13, 2021

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.
@cwarnermm cwarnermm removed the Hacktoberfest null label Jan 18, 2022
@cwarnermm cwarnermm changed the title Request for Documentation: Migration process from an Omnibus install to a normal one Help Wanted: Migration process from an Omnibus install to a normal one Jan 18, 2022
@cwarnermm cwarnermm added Good First Issue Suitable for first-time contributors Difficulty/1:Easy and removed Difficulty/2:Medium labels Sep 24, 2024
@cwarnermm cwarnermm changed the title Help Wanted: Migration process from an Omnibus install to a normal one Help Wanted: Document migration process from an Omnibus install to a normal one Sep 24, 2024
@cwarnermm cwarnermm removed the Hacktoberfest null label Nov 1, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

2 participants