Parashift AlfStream Trial Module

The Parashift AlfStream Trial Module is a 30 day trial for AlfStream which includes the following:

  • AlfStream
  • AlfStream Sync
  • Parashift Version Service

You can request a free 30 day trial by filling out the form here

Usage

Usage is the same as AlfStream Sync, but the installation is more streamlined.

Setting up trial instances

It is recommended to use our Salt formulas to install the trial instances. This is the official way to install AlfStream and is easy to configure and run.

Note

The Trial requires Internet Connection for each instance for Activation.

When you set up a trial, you will be provided with:

  • A token for the trial subscription which will expire normally within 30 days
  • A copy of the AlfStream Trial amp for both share and repo sides of Alfresco
  • A copy of the AlfStream Trial kar for running the camel route within Apache Karaf

Automatic Setup

You can automatically have both instances set up using Salt Stack and our Salt Formulas.

The automatic setup will:

  • Install Alfresco with the AlfStream Trial module
  • Install Karaf with the AlfStream Trial routes

Requirements

You will need:

  • The trial token provided to you by Parashift
  • 2 Blank Virtual Machines with either:
    • CentOS or Redhat 6/7
    • Ubuntu LTS 14.04 or 16.04
  • The hostnames of each server for the configuration

Installation

On Each server, run the following commands, to install salt formulas:

curl -L https://repo.parashift.com.au/bootstrap.sh -o bootstrap.sh
sudo sh bootstrap.sh

Create a salt pillar formula, storing it at /srv/pillar/local.sls with the following contents, changing alfresco.remote.url to the hostname of the other server and adding your token provided:

roles:
  - alfresco
  - karaf

paramp:
  token: <Your Token Here>

alfresco_modules:
  - alfresco:dynamic-extensions:1.4.2
  - parashift:alfstream-trial:1.2.1

karaf_modules:
  - parashift:alfstream-trial:1.2.1

alfresco:
 version: 5.2.0
 solr: True

karaf:
  config:
   - alfstream.remote.url=http://<Remote Server Hostname>:8080/alfresco
   - alfstream.remote.username=admin
   - alfstream.remote.password=admin
   - alfstream.local.url=http://127.0.0.1:8080/alfresco
   - alfstream.local.username=admin
   - alfstream.local.password=admin

Note

Reverse the local and remote configurations for the other server so that they can talk to eachother.

Run the following:

salt-call --local state.highstate

Manual setup

You can manually install the amps and kar files to Alfresco and Karaf if you have more specialised environments.

Alfresco Setup

You will need to install Alfresco as per normal instructions here

For the AMP installation, the following will be required on the repo end:

  • Alfresco Dynamic Extensions:
  • Parashift AlfStream Trial Repo AMP

The following will be required on the share end:

  • Parashift AlfStream Trial Share AMP

Karaf Setup

You will need to follow this step on both sides:

  • Follow the instructions for installing Karaf from the Quickstart here: Karaf Manual

  • Create a or update the config file at /<path_to_karaf_install>/etc/com.parashift.cfg with the following properties:

  • alfstream.local.url: the Local alfresco instance (normally localhost, but could be a different server)

  • alfstream.local.username: the Local alfresco admin username
  • alfstream.local.password: the Local alfresco admin password
  • alfstream.remote.url: the Remote alfresco instance
  • alfstream.remote.username: the Remote alfresco admin username
  • alfstream.remote.password: the Remote alfresco admin password

As an example:

alfstream.remote.url=http://sidea.dev.parashift.local:8080/alfresco
alfstream.remote.username=admin
alfstream.remote.password=admin
alfstream.local.url=http://localhost:8080/alfresco
alfstream.local.username=admin
alfstream.local.password=admin
  • Add the provided Camel KAR file from the trial link into the deploy directory