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

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 Portal
  • Vidispine Middleware
  • Vidispine Transcoder
  • Solr
  • Postgresql
  • nginx
  • Elastic Search
  • rabbitmq
  • memcached
  • rsyslogd
  • supervisor

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.

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. If the wizard asks you to initialize vidispine you respond “yes”.

Steps for upgrading

Warning

Do not upgrade to 3.3 or later from 2.3 or earlier version of Portal. If you need to upgrade such a system, please apply the upgrades up to 2.4.x and then install Portal 3.3. Upgrades from earlier than 2.4 to Portal 3.3 and later are not supported.

It is possible to upgrade a previous installation of portal with the following procedure

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_2.x.y.tar

Extract the package supplied to you:

tar xvf Portal_2.x.y.tar

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

cp key_* Portal_2.x.y/key

For a fresh install you must run “setup”:

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

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

  • Cantemo Portal
  • Vidispine Middleware
  • Vidispine Transcoder
  • Solr
  • Postgresql

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.

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_3.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.