Mirror mode

Mirror mode allows you to deploy your OBM infrastructure without internet access on remote hosts.

It can also helps you to work on obm-deploy without internet access (eg. in the train).

Be carefull ! Currently, mirror mode only supports OBM 2.x.

Table of contents


How it works

Mirror mode main goal is to make a copy of all packages and files involved in the installation process on you own computer.

Then, it redirects remote hosts repositories to your computer by hacking their /etc/hosts file and by updating download URLs when needed.


Install source system

First, you need to install an obmfull system on a remote host with Internet access.

It will be used to copy all needed packages to your local computer.

It's required to use default obmfdull-example without any customization.

For more information about this step, please refer to our quickstart guide.

$ ansible-playbook -i obmfull-example obm.yml


Ensure your remote hosts have access to your computer

We can't help you at this point.


Build ressources directory

To build your ressources directory, you need to use provided shell script.


Install a fully fonctionnal web server

We can't help you at this point.


Configure needed virtualhosts

A sample nginx configuration file can be found [here].

An Apache configuration will be provided as soon as possible.


Manually install libselinux-python on remote hosts

The most important limitation of mirror is that it can't deploy libselinux-python by itself on remote hosts.

You need to install it manually using your favorite package manager or integrate it into your VM templates.


Sync time using your own computer (optional)

If you have a functionnal NTP server on your computer and want to keep remote hosts in sync with it, you can specify your own IP address in config.yml using ntp_server variable.

Otherwise, remote hosts will be synced only once, when you install them.