Version: DEV

Migrate from Greenlight

PILOS provides an easy to use command to import all Greenlight users (incl. ldap), rooms and shared accesses.

Preparing migration from other host

If you plan to run PILOS on a different host than Greenlight, you have to adjust the docker-compose.yml inside the Greenlight directory to publish the database port.

Change the port configuration for the db service from:

ports:
    - 127.0.0.1:5432:5432

to:

ports:
    - 5432:5432

Also make sure the internal firewall of the OS and no external firewall is not blocking access to the port and from the host PILOS is running on.

If you want to import Room presentations, copy Greenlight's active storage directory to the PILOS app storage at /storage/app/migration/presentations and specify --presentation-path=migration/presentations at the command line. Successfully imported presentation files will be copied to a different location.

Running migration command

The command will output the process of the import and informs about failed user, room and shared access import.

Note If a room with the same room id already exists in PILOS it will NOT be imported and the shared accesses are ignored.

Greenlight 2

Usage:
  import:greenlight-v2 <host> <port> <database> <username> <password>

Arguments:
  host                  ip or hostname of postgres database server
  port                  port of postgres database server
  database              Greenlight database name, see Greenlight .env variable DB_NAME
  username              Greenlight database username, see Greenlight .env variable DB_USERNAME
  password              Greenlight database password, see Greenlight .env variable DB_PASSWORD

Options:
      --no-confirm                             do not ask if the import should be committed
      --default-role[=DEFAULT-ROLE]            name of the default role for imported local users (case-insensitive)
      --room-prefix[=ROOM-PREFIX]              prefix for imported room names (empty string is allowed)
      --room-type[=ROOM-TYPE]                  name of the room type for imported rooms
      --presentation-path[=PRESENTATION-PATH]  path to room presentations, relative to /storage/app
      --auth-provider-map[=AUTH-PROVIDER-MAP]  JSON mapping of user authentication providers (Greenlight => PILOS)

Example

docker compose exec app \
    pilos-cli import:greenlight-v2 \
    localhost \
    5432 \
    greenlight_production \
    postgres \
    12345678

Example (non-interactive)

docker compose exec app \
    pilos-cli import:greenlight-v2 \
    --no-confirm \
    --default-role=User \
    --room-prefix='' \
    --room-type=Meeting \
    --presentation-path=migration/presentations \
    --auth-provider-map='{"shibboleth":"shibboleth","google":"oidc"}' \
    localhost \
    5432 \
    greenlight_production \
    postgres \
    12345678

Greenlight v3

Usage:
  import:greenlight-v3 [options] [--] <host> <port> <database> <username> <password>

Arguments:
  host                                         ip or hostname of postgres database server
  port                                         port of postgres database server
  database                                     Greenlight database name
  username                                     Greenlight database username
  password                                     Greenlight database password

Options:
      --no-confirm                             do not ask if the import should be committed
      --default-role[=DEFAULT-ROLE]            name of the default role for imported local users (case-insensitive)
      --room-prefix[=ROOM-PREFIX]              prefix for imported room names (empty string is allowed)
      --room-type[=ROOM-TYPE]                  name of the room type for imported rooms (case-insensitive)
      --presentation-path[=PRESENTATION-PATH]  path to room presentations, relative to /storage/app

Example

docker compose exec app pilos-cli import:greenlight-v3 \
    localhost \
    5432 \
    greenlight-v3-production \
    postgres \
    12345678

Example (non-interactive)

docker compose exec app pilos-cli import:greenlight-v3 \
    --no-confirm \
    --default-role=User \
    --room-prefix='' \
    --room-type=Meeting \
    --presentation-path=migration/presentations \
    localhost \
    5432 \
    greenlight-v3-production \
    postgres \
    12345678

Adjust nginx

PILOS is running on the same host

To use PILOS as a drop-in replacement for Greenlight 2 or Greenlight 3, remove all greenlight related nginx configuration and run PILOS on the same host following the instructions in the getting started guide.

Greenlight 2: PILOS is running on a different host

Please replace the following section of the Greenlight nginx configuration:

location /b {
  proxy_pass          http://127.0.0.1:5000;
  proxy_set_header    Host              $host;
  proxy_set_header    X-Forwarded-For   $proxy_add_x_forwarded_for;
  proxy_set_header    X-Forwarded-Proto $scheme;
  proxy_http_version  1.1;
}

location /b/cable {
  proxy_pass          http://127.0.0.1:5000;
  proxy_set_header    Host              $host;
  proxy_set_header    X-Forwarded-For   $proxy_add_x_forwarded_for;
  proxy_set_header    X-Forwarded-Proto $scheme;
  proxy_set_header    Upgrade           $http_upgrade;
  proxy_set_header    Connection        "Upgrade";
  proxy_http_version  1.1;
  proxy_read_timeout  6h;
  proxy_send_timeout  6h;
  client_body_timeout 6h;
  send_timeout        6h;
}

# Allow larger body size for uploading presentations
location ~ /preupload_presentation$ {
  client_max_body_size 30m;

  proxy_pass          http://127.0.0.1:5000;
  proxy_set_header    Host              $host;
  proxy_set_header    X-Forwarded-For   $proxy_add_x_forwarded_for;
  proxy_set_header    X-Forwarded-Proto $scheme;
  proxy_http_version  1.1;
}

# Only needed if using presentations and deployed at a relative root (ex "/b")
# If deploying at "/", delete the section below

location /rails/active_storage {
  return 301 /b$request_uri;
}

with

location /b {
    return 301 https://DOMAIN.TLD$request_uri;
}

This will redirect all traffic to PILOS. If you don't use the /b base path for Greenlight adjust the code accordingly. Replace DOMAIN.TLD with the hostname of your PILOS installation.

Greenlight 3: PILOS is running on a different host

Replace the content of the file /etc/greenlight/nginx/greenlight-v3.nginx (Greenlight Standalone) or /usr/share/bigbluebutton/nginx/greenlight-v3.nginx (Greenlight part of BigBlueButton) with

location @bbb-fe {
    return 301 https://DOMAIN.TLD$request_uri;
}

This will redirect all traffic to PILOS. Replace DOMAIN.TLD with the hostname of your PILOS installation.

Enable Greenlight compatibility mode

To enable support for the most common Greenlight URLs set the following .env variable

GREENLIGHT_COMPATIBILITY=true

If your Greenlight was running in a subdirectory (Greeenlight 2 is running in /b by default) adjust the .env variable. Do not include the slash /.

GREENLIGHT_PATH=b

Note We don't support Greenlight compatibility mode for Greenlight 2 installations without a prefix like /b. You also need to make sure the prefix does not collide with PILOS URLs (check routes in: routes/api.php, routes/web.php and resources/js/router.js )

Shutdown Greenlight

To shutdown Greenlight run this command inside the Greenlight directory

docker-compose down

Preparing migration from other host​

Running migration command​

Greenlight 2​

Greenlight v3​

Adjust nginx​

PILOS is running on the same host​

Greenlight 2: PILOS is running on a different host​

Greenlight 3: PILOS is running on a different host​

Enable Greenlight compatibility mode​

Shutdown Greenlight​