Basic Installation on Linux

Partitioning

Portal will support most common partitioning schemas. But in order to increase reliability we recommend to separate different components from each other on different partitions.

Here is a example of a partition scheme. Sizes of partitions below are intended for test and development systems. It is recommended that you at LEAST make separate partitions for /var and /srv/media1

In order to be able to change this configuration later on while the system is in use you should always make use of Linux LVM ( Logical Volume Manager )

The SQL DB size will typically be 0,4-0,9 MB / item. So for 100.000 items that means a /var/lib/pgsql/ of at least 90 GB

Sizing a Portal system

This guide will not cover a complete configuration, but will provide some basic pointers to think of when sizing a system.

  • Cores of the servers

  • Memory in each server

  • I/O to Storage and Network

  • Encoding and Decoding formats

Note

The Concurrent jobs should be configured based on the values of the above, and each system is unique.

Steps for installation

Note

substitute x.y below for your version of the software

Note

for VidiNet setup, follow VidiNet instead.

Login with an SSH Prompt to your server.

First download the Portal installer. You will receive a file named like this:

Portal_1.x.y.tar

Extract the package supplied to you:

tar xvf Portal_1.x.y.tar

Copy the keyfile supplied to you to the correct directory:

cp key_* Portal_1.x.y/key

For a fresh install you must run “setup”:

cd Portal_1.x.y
sudo ./setup

It will set up the following components on your server:

  • Cantemo

  • Vidispine Middleware

  • Vidispine Transcoder

  • Solr

  • Postgresql

  • nginx

  • Elastic Search

  • rabbitmq

  • redis

  • rsyslogd

  • ActiveMQ

  • Celery

During first setup you need to answer two questions. The first is the password for the admin user the second one is what hostname should answer/serve as your portal server.

Note

The hostname or IP from Vidispine must be included in that list. In a one server system localhost (127.0.0.1) must be included.

Installing only a specific component

To install a specfici component run sudo ./setup --components=COMPONENTS`. See ``./setup --help for a list of components

Portal Setup Wizard

After running the setup you can access http://yourserver.example.com/ using a web browser to log into Portal and complete the installation. For the first time you will need to log in with an administrator account (default username admin, password admin) and run the setup wizard.

The wizard will ask a couple of questions

Default Upload storage

A system needs a default upload storage, this must be set

Access control

When having simple access control set to true the index ACLs will be based on the groups this means that the system will keep the amount of reindexes based on acl and group changes to a minimum. However this those not support certain cases e.g case is User 1 owns a collection that User 2 has access to and then User 2 adds an item to the collection that User 1 does not have access for. Note that this will not grant any unwanted access for the item in Vidispine but rather that the search can incorrectly return assets that a user does not have access to.

With simple access control set to False the index ACLs will be both group and user based this means that it will correctly cover all the different access cases but it will have perform a lot more reindexes especially when the Group membership changes to keep the users up to date in the index.

Management command

You can run /opt/cantemo/portal/manage.py setupvs from the command line. Remember to specify the correct options.

Steps for upgrading

Note

Upgrade from Portal 4.3.7 or earlier to Portal 5 is not allowed. Please upgrade to Portal 4.3.8 first.

Note

During upgrades migrations take place and that could cause the database to grow. Make sure utilization on database partition is no more than 50%

It is possible to upgrade a previous installation of portal with the following procedure, please follow this upgrade path:

Portal 1.x -> 1.6 -> 2.4 -> 3.4 -> 4.1 -> 4.3 -> 5.1

Note

substitute x.y below for your version of the software

Login with an SSH Prompt to your server.

First download the Portal installer. You will receive a file named like this:

Portal_5.x.y.tar

Extract the package supplied to you:

tar xvf Portal_5.x.y.tar

You only need to supply a key if your key is outdated:

cp key_* Portal_5.x.y/key

For a fresh install you must run “setup”:

cd Portal_5.x.y
sudo ./setup --upgrade

It will upgrade the following components on your server if needed:

  • Cantemo

  • Vidispine Middleware

  • Vidispine Transcoder

  • Solr

  • Postgresql

  • nginx

  • Elastic Search

  • rabbitmq

  • redis

  • rsyslogd

  • ActiveMQ

  • Celery

After running the setup you should logout from the www-interface and login into Portal again, the setup wizard will be displayed in case your system needs to be reconfigured. Please respond “yes” if the wizard asks you to initialize vidispine.

Note

After a upgrade don’t forget to log out and login again! All users will be logged out automatically.

You should now be able to use a web browser to navigate to the server that you installed Portal on. If you wish, please consider to setup extra configuration options for Portal such as you email server settings, timezone and locale.

If you want to upgrade the system to run external ActiveMQ. Follow this steps:

  1. Install the ActiveMQ component

  2. Configure server.yaml and remove the embeddedBroker and point to the installed component configuration

Note

Default port for ActiveMQ is 61616 so make sure the embedded broker is shut off before trying to run the external one

Steps for updating your license key

The license key needs to be installed into multiple place in order for it to be available both to Portal and Vidispine. You can perform this update using the setup script from the installer.

Login with an SSH Prompt to your server.

Copy the keyfile supplied to you to the same directory as the setup script:

cp key_* Portal_5.x.y/key

Run the following command do update the key:

./setup --update-key

This will update the license keys for both Portal and Vidispine.

Note

If you manually put the license in the correct directory, remember to split the key between Portal and Vidispine.