Skip to content

Quickstart

1. Installation

On a Linux CentOS 6, 7 or 8 box

What about other Linux distributions?

This quickstart is easily adaptable to other Linux distributions. To install on your favorite one, have a look at the complete installation guide.

# AS root USER

# First, we configure the Metwork Framework repository for 1.0 releases
cat >/etc/yum.repos.d/metwork.repo <<EOF
[metwork_1.0]
name=MetWork 1.0
baseurl=http://metwork-framework.org/pub/metwork/releases/rpms/release_1.0/portable/
gpgcheck=0
enabled=1
metadata_expire=0
EOF

# Then we install the mfbase module
yum -y install metwork-mfbase

# Let's start Metwork services
# (or "systemctl start metwork.service" if you don't have the "service" command)
service metwork start

# Done :-)

2. mfbase user

The following is done as mfbase user (there is no default password, change it with passwd mfbase command as root user if you want or use su - mfbase from root to log in as mfbase user.

When you are in mfbase user, you must see a MetWork welcome screen on your terminal like:

           __  __      ___          __        _
          |  \/  |    | \ \        / /       | |
          | \  / | ___| |\ \  /\  / /__  _ __| | __
          | |\/| |/ _ \ __\ \/  \/ / _ \| '__| |/ /
          | |  | |  __/ |_ \  /\  / (_) | |  |   <
          |_|  |_|\___|\__| \/  \/ \___/|_|  |_|\_\


Welcome on xxxx (xxxxx.meteo.fr, 192.168.1.170)
(module: MFBASE, version: integration.14.3d17536)

 14:28:51 up 18 days,  2:49,  1 user,  load average: 0.16, 0.21, 0.23

When you see that in your terminal, you can continue.

3. Creating your first plugin

Use the command bootstrap_plugin.py create foo to bootstrap a plugin named foo.

After answering the questions, you have a foo directory in your current directory.

These are the sources of your newly created plugin. Go inside with cd foo.

4. Releasing your first plugin

Use the command make release inside your foo directory. You get a .plugin file in the foo directory.

5. Installing your first plugin

Use the command plugins.install [...].plugin to install your plugin.

This will create:

  • a plugin_foo postgresql database
  • a plugin_foo postgresql username (with full rights on plugin_foo database)
  • a default password: plugin_foo for plugin_foo username

6. Testing your database

As the default port for the mfbase postgresql server is 7432, you can connect to your newly created database with this command:

psql -U plugin_foo -h localhost -p 7432 plugin_foo
# (use plugin_foo as password when prompted)

or by configuring your favorite postgresql client to:

hostname: your_mfbase_host
username: plugin_foo
password: plugin_foo
port: 7432
database: plugin_foo

7. Reference

7.1 Managing mfbase services (as mfbase user)

7.1.1 Start

With mfbase.start you start mfbase services. It's done automatically during machine start process.

The first time, an automatic initialization is done.

7.1.2 Stop

With mfbase.stop, you stop mfbase services. It's done automatically during machine shutdown process.

7.1.3 Status

With mfbase.status, you can check mfbase services. If you need to do that within a non-interactive code, please don't parse the output and use the return code ($? in shell). If the return code is 0, everything is fine.

7.1.4 Init

With mfbase.init, you can reinit your module. With this command, you will loose all your databases.

Note: services are automatically stopped, so you have to start them again after this command.

7.2 Managing mfbase plugins (as mfbase user)

7.2.1 List

plugins.list

7.2.2 Install

plugins.install FULL_PATH_TO_PLUGIN_FILE

7.2.3 Uninstall

plugins.uninstall PLUGIN_NAME_WITHOUT_PATH_EXTENSION_OR_VERSION