Version 1 (modified by Jamie McClelland, 3 years ago) (diff)


Red/Mosh Re-organization

The red control panel and filesystem layout of our MOSH servers limits us in several critical ways.

This proposal for re-organization has the following goals:

  • Prepare MOSH'es to handle a network file system as an intermediate step in our container infrastructure project
  • Make it easier to move user accounts and web sites from one membership to another
  • Eliminate the confusing "hosting order" - so user accounts, DNS records, email lists, etc are linked directly to a membership, rather than being part of a hosting order collection

Phase one: File system re-organization

The first step is to change the file system layout on MOSH'es.

Currently, user home directories are stored in /home/members/<member-short-name>/sites/<hosting-order-identifier>/users/<username> and web sites are stored in /home/members/<member-short-name>/sites/<hosting-order-identifier>/{web,include,logs}.

Since the membership name is part of the home directory and web paths, moving a web site or username to a different membership requires a tedious and error prone process of updating the user account home directory, web site DirectoryRoot, etc.

In addition, web sites and user paths are grouped together, making it harder to separate user accounts used for email from those used to secure FTP to update a web site.

New Layout

The proposed new layout would be:

  • Home directories: /home/members/users/<username>
  • Web directories: /home/members/sites/<hosting-order-id>/{web,include,logs,conf/apache,conf/php}

A web site's apache configuration would live in conf/apache and /etc/apache2/sites-enabled/<hosting-order-id>.conf would be a symlink to it. A web site's php pool configuration file would live in conf/php and /etc/php/7.0/fpm/pool.d/<hosting-order-id>.conf would be a symlink to it.


Since all MOSH servers have /home as a single partition, moving web site and user directories around should take minimal disk i/o.

As part of the transition, we could both:

  • perform a sed replacement for any instance of the old path with the new path (so php configuration files are properly updated)
  • leave a symlink from the old location to the new location in case anything was missed


Once completed, this step would achive the goal of making it easier to move users and web sites between memberships since the only record of what membership a user or web site belongs to would be in the control panel database.

Phase two: eliminate the hosting order

The hosting order would be renamed "web site" (and the hosting-order-id in the path above would simply be renamed web-site-id in the database). We would still keep the following items grouped together:

  • web configuration
  • web application
  • mysql database
  • mysql username
  • schedule job (cron job)

However, the following items would be moved up to the member level:

  • Email address
  • Email list
  • High volume email list
  • DNS

We would eliminate Hosting order access - we would no longer support access control based on a web site.


With this step done, we would no longer have hosting orders

Phase three: network file system

Once we have a network file system available, the various network drives would be mounted in /media, e.g. /media/fs/<id>/{users,sites,databases}.

We could transition each MOSH on a case-by-case basis by simply moving all data from /home/members to their respective locations on the network file system and then replacing the directories in /home/members with symlinks to /media/fs.

Depending on the network file system chosen, we could store MySQL databases and maintain symlinks in /var/lib/mysql.

Phase four: central authentication and authorization

The last phase before deploying containers is to replace /etc/passwd, /etc/shadow, and /etc/group with a central authentication/authorization system (NIS with ldap or mysql).

With this step in place, every MOSH would have every login available on it.

Now, moving a web site between MOSH'es would require:

  • Creating symlinks on the target MOSH (home directories, web config, php config, databases) and reloading necessary services. Now everything is available on both servers at the same time. NOTE: the web files can live on both servers at the same time, but the database has to be removed from one server before it is started on the other to avoid data corruption.
  • Update DNS (or preferably the internal routing mechanism so it can be instant).
  • Remove symlinks from old MOSH

Phase five: containers and beyond

Once these pieces are in place, switching to a container based system is relatively simple as user and web directories can easily be mounted inside a container.