Installation

Quick Demo Install

​Use the install script to install the latest version of scorch suite in your current directory with a demo job

wget http://www.autoscorch.com/downloads/install && chmod a+x install && ./install

Normal Installation

ScOrch is designed to be used as a team collaboration tool. As such it should be installed under a common directory with group read and execute permissions and owned by a system account. It can also be installed by each user under their home directory if required, or can use private job directories or private plugin directories with a private or group scorch. The combinations offer a lot of flexibility.

The open source version, is a single script with the simplified functions embedded and reduced comments. The enterprise version is a tar file that contains scorch, license details and the functions directory with commented functions.

Bash version 4 minimum is assumed.

Select an installation directory and version

INSTALL_DIR=/tmp/scorch
VERSION=2.13.3

The following can then be used in a Unix or Linux docker shell or directly into any other bash shell (including Bash for Windows)

mkdir ${INSTALL_DIR}
curl -o ${INSTALL_DIR}/scorch.tar https://s3.eu-west-2.amazonaws.com/autoscorchdownload.com/escorch.${VERSION}.tar
cd ${INSTALL_DIR}
tar xf scorch.tar
export PATH=${PATH}:${INSTALL_DIR}
./scorch -install

Obrar installation

`obrar` is now included with `scorch`
 

ScOrch Setup

Decide on a scorch base directory, system owner account and group account.

Have your friendly system administrators create the account, group and directory as well as assigning users to the group. In the example below user scorch, group scorch and directory /opt/scorch have been chosen.

A simple way to create the users is shown below and as the directory structure for scorch handles its own logs, the directory has been given its own file system. Your organisation my have other requirements or products to setup the accounts. There may be other considerations in your organisation. If in doubt consult your Linux Support team:

$ dir_Base=/opt/scorch # Example base directory
$ adduser -U -m -d ${dir_Base} scorch # scorch framework owner

str_Group

There is a new group feature (available from 1.54) to overcome a requirement for all users to be in the same primary group. If you wish to use ScOrch for collaboration work, chose a group by un-commenting out the export str_Group line in the main scorch program

vi scorch

Then    /str_Group=     and un-comment for group directory and file creation export str_Group=scorch

Adding a new user to the group

If you wish to create new users use useradd. In this example we are adding the user bob: $ useradd -g scorch bob # User is a member of scorch only

Modifying a current user to be part of the group.

If you already have users you wish to make part of the group, use the usermod command. In this example we are adding user marc to the scorch group.

$ usermod -g scorch marc # Add scorch group to user

The above will create the base directory automatically, but this could also be made manually and need to be changed to allow the scorch group to access files.

$ chmod 750 ${dir_Base} # Allow group read/execute

Log in as the chosen system user, in this scenario the chosen system account is deploy. Extract the tar file into the chosen directory into this directory and execute it for the first time as the system user.

$ sudo -iu scorch
$ dir_Base=/opt/scorch
$ cd ${dir_Base}
$ wget https://s3.eu-west-2.amazonaws.com/autoscorchdownload.com/install
$ chmod u+x install
$ ./install

AC Version

# As root
dir_Base=/scorch
groupadd deployr
adduser -m -d ${dir_Base} deploy -G deployr
id deploy

# uid=deploy gid=deploy groups=deploy,deployr
adduser -m deployr -g deployr

# As scorch owner
sudo su - deploy
dir_Base=/scorch
cd ${dir_Base}
wget https://s3.eu-west-2.amazonaws.com/autoscorchdownload.com/install
chmod 740 install
./install
    # Enter y to set the deployr group
rm ./install

./scorch -install