scst-3.x-debian

Debian dkms-enabled packaging for SCST

Begin GLS 2018-04-09 Update

Changes to how to unpack and run scst-files.tar (see below).

Begin GLS 2017-07-23 Update

GLS 2017-07-29 Update

NOTE: The issues are RESOLVED and this now SHOULD WORK (yay!)

for creating SCST DKMS Packages on Debian-based systemd-enabled Linuxes

I apologize for the delays getting the issues resolved.

Thanks for your patience.

SCST

More information on the SCST project here: http://scst.sourceforge.net/

Install SCST using this Git

To use this github archive to build and install latest SCST source code as DKMS modules to Ubuntu 15.04+ (15.04-17.04+)

Go to this link here:

https://github.com/gstanden/orabuntu-lxc

and download orabuntu-lxc zip archive

or if you prefer direct wget:

wget https://github.com/gstanden/orabuntu-lxc/archive/master.zip

and then unzip the archive and navigate to:

cd orabuntu-lxc-master/orabuntu/archives

where you will find the scst-files.tar archive.

Untar this archive as shown below:

sudo tar -xvPf scst-files.tar

and then

cd /opt/olxc/home/scst-files

Edit the create-scst.sh file as needed for your requirements and available disk/sizing requirements.

Then run the

./create-scst.sh

script which will do EVERYTHING required to configure SCST and calls this scst-3.x-debian github.

The create-scst.sh and associated scripts which are called does all of the following:

• Installs SCST (for most kernels install DKMS-enabled SCST modules which auto-rebuild across kernel updates)
• Creates an SCST target, group and LUNs (optional: edit the create-scst-oracle.sh script to suit specific requirements)
• Creates an appropriate /etc/multipath.conf file for the hardware and system running
• Backs up the existing /etc/multipath.conf (if any) and installs the new /etc/multipath.conf
• Logs in via iscsi-initiator and configures on-boot properties of SCST SAN

DKMS

DKMS means among other things that you will not have to recompile SCST everytime you upgrade kernel.

DKMS takes care of this for you automatically.

References

The following reference was my main relevant reference.

This work could not have been accomplished without the below reference and

the original scst-3.x-debian github by Martijn Grendelman.

More on DKMS here: https://help.ubuntu.com/community/Kernel/DkmsDriverPackage

Sincere thanks and recognition to the following people who established this github before I forked it.

Credits

Martijn Grendelman credits Fajar A. Nugraha and Adrian Stachowski for early work on this. This github was forked from really great github by Martijn Grendelman. Words are hardly adequate to express my thanks to these pioneering developers.

Notes

This fork should work with any SCST version although it has only been tested so far with SCST 3.3.0 (latest release)

This fork has been updated for systemd-enabled Debian-based Linuxes (e.g. Ubuntu 17.04 which has been tested).

• tested means scst-dkms modules built/installed successfully

Releases and Kernels Tested and Known to Work with DKMS:

Ubuntu Desktop 64-bit:

• Ubuntu 14.04 Trusty Tahr 3.13.0-125-generic
• Ubuntu 15.04 Vivid Vervet 3.19.0-84-generic
• Ubuntu 15.10 Wily Werewolf 4.2.0-42-generic
• Ubuntu 16.04 Xenial Xerus 4.10.0-30-generic (16.04.3 HWE kernel ONLY)
• Ubuntu 16.10 Yakkety Yak 4.8.0-59-generic
• Ubuntu 17.04 Zesty Zapus 4.10.0-28-generic

Ubuntu Server:

• (not yet tested - test results coming soon)

Releases and Kernels Tested that DO NOT WORK with DKMS:

Ubuntu Desktop 64-bit:

• Ubuntu 16.04 Xenial Xerus 4.4.x-x-generic

• Note: Script will do a non-DKMS SCST install if kernel 4.4.* MUST be used.

• Note: Strongly recommend automatic update to the 16.04.3 HWE kernel so that SCST DKMS can be used.

• Note: Install DKMS on an early 4.4.x-x-generic 16.04 kernel eg. 4.4.0-31-generic will work but -

• Note: SCST DKMS breaks on update to 16.04 4.4.0-87,88,89-generic so use HWE 4.10 HWE kernel on 16.04

(The above tests were done on VirtualBox VM's which had all available updates applied to a vanilla install)

This fork should work on all systemd-enabled Debian-based linuxes (e.g. Linux Mint if using systemd) (not tested yet)

If you test it out, recommend using a dedicated test VM first.

Building SCST with this doesn't require any advanced packaging knowledge, anyone with basic linux skills can use.

Roadmap

An update to support pre-systemd Debian-based releases (e.g. Ubuntu 14.04) is coming very soon.

If you need to install dkms-enabled SCST on pre-systemd Debian-based release (e.g. Ubuntu 14.04) then:

(1) Please use the original github this was forked from: https://github.com/tinuzz/scst-3.x-debian

(2) Read: https://sites.google.com/site/nandydandyoracle/scst/scst-debian-dkms-package-build-from-source-ubuntu-14-04

Orabuntu-LXC

SCST is the ISCSI Linux SAN which is bundled with my Orabuntu-LXC: https://github.com/gstanden/orabuntu-lxc

This work on SCST is driven by that project, but the SCST work is quite general and can be used for any purpose.

Configure SCST SAN

Edit create-scst.sh before running and modify parameters on create-scst-oracle.sh to suit your requirements.

If you do not edit create-scst-oracle.sh it will run fine with defaults set to Oracle-RDBMS-centric values.

The scripts are easily readable in bash, so you can customize them to meet your needs.

Uninstall

To uninstall SCST after installing with this fork:

Run the create-scst-uninstall.sh file in the scst-files.tar archive

A reboot after running create-scst-uninstall.sh is recommended but not mandatory

If you don't reboot, be sure to kill orphan SCST processes and unload SCST modules

After reboot check:

ps -ef | grep scst

lsmod | grep scst

Removal should be complete.

Optionally, you are now ready to reinstall again using this fork following the exact same procedure:

	(just run the build-debian-dkms-scst.sh script as before)

End GLS 2017-07-23 Update

This is an unofficial repository containing Debian packaging for SCST 3.x. The work was originally done by Fajar A. Nugraha <ubuntu-ppa at fajar dot net> and I think Adrian Stachowski <ast at marum dot de> before that, for the packages that can be found in this Launchpad PPA, that serves SCST packages for Ubuntu Precise, Trusty and Utopic:

https://launchpad.net/~scst/+archive/ubuntu/3.0.x/+packages

Since I haven't been able to find something similar for Debian Jessie or Wheezy, I adapted Fajar's work for Debian Jessie.

The quick'n'dirty howto for this repo is this:

• check out the source code for SCST from Souceforge (Svn) or Github (Git)
• check out this repository as 'debian' in the source tree
• dpkg-buildpackage / pdebuild / ...

Get the source code here:

• http://sourceforge.net/p/scst/svn/HEAD/tree/branches/3.1.x/
• https://github.com/bvanassche/scst/tree/svn-3.1.x

Use this command to check out a tested revision from Subversion:

svn checkout svn://svn.code.sf.net/p/scst/svn/branches/3.1.x/@6796 scst-3.1.0

The packaging and the resulting packages HAVE NOT BEEN THOROUGHLY TESTED. Use them at your own risk. The contents of this repository on every tagged commit /should/ at least produce a clean build with pbuilder.

If your build fails, you can try this before starting your build tool:

export CFLAGS="-Ipwd/scst/include -D_GNU_SOURCE"