%Z% %I% %W% %G% %U%

IBM Spectrum Archive Single Drive Edition Version 2.2.1.1 (8319)

Licensed Materials - Property of IBM

IBM Spectrum Archive Single Drive Edition Version 2.2.1.1 for Linux and Mac OS X

Copyright IBM Corp. 2010, 2015

This file is part of the IBM Spectrum Archive Single Drive Edition for Linux and Mac OS X
(formally known as IBM Linear Tape File System)

IBM Spectrum Archive Single Drive Edition for Linux and Mac OS X is free software;
you can redistribute it and/or modify it under the terms of the GNU Lesser
General Public License as published by the Free Software Foundation,
version 2.1 of the License.

The IBM Spectrum Archive Single Drive Edition for Linux and Mac OS X is distributed in the
hope that it will be useful, but WITHOUT ANY WARRANTY; without even the
implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
or download the license from <http://www.gnu.org/licenses/>.

--------------------------------------------------
 INSTALL document for Linux and Mac OS X platforms
--------------------------------------------------

1. Online user's guidance

   Refer to the information in the online IBM Spectrum Archive Single Drive Edition documentation
   before installing IBM Spectrum Archive Single Drive Edition on your system.

   Online IBM Spectrum Archive Single Drive Edition Single Drive Edition documentation is available on IBM Knowledge Center 
   and can be found at:
     http://www.ibm.com/support/knowledgecenter/STQNYL


2. System Requirements:

  Operating System:
      - RHEL 5.7, 5.8 and 5.9      (x86, x86_64)
      - RHEL 6.2 and 6.4           (x86, x86_64, and ppc64)
      - SLES 11.1, 11.2 and 11.3   (x86, x86_64)
      - Mac OS X 10.6
      - Mac OS X 10.7
      - OS X 10.8
      - OS X 10.9

  Tested Tape Drives (use with the latest version of drive firmware):
      - IBM LTO Generation 6 Tape Drives
        (IBM TS2360, IBM TS2260, drives in IBM 7226 Multimedia Storgae Enclosure, or OEM drives)
      - IBM LTO Generation 5 Tape Drives
        (IBM TS2350, IBM TS2250, drives in IBM 7226 Multimedia Storgae Enclosure, or OEM drives)
      - TS1140 Enterprise Drive
      - TS1150 Enterprise Drive

  For information about connectivity and configurations for the IBM Spectrum Archive Single Drive Edition on IBM branded tape drives,
  refer to the online IBM Spectrum Archive Single Drive Edition Single Drive Edition documentation that is available on IBM Knowledge Center:
     http://www.ibm.com/support/knowledgecenter/STQNYL

  For information about latest versions of drive firmware,
  and hardware interoperability known issues and limitations, refer to the IBM System Storage Interoperation Center (SSIC).

  The IBM SSIC can be found at the following website:
    http://www.ibm.com/systems/support/storage/config/ssic

  For OEM branded tape drives, ask your supplier about the interoperability.

3. Linux Systems based on rpm package manager

  3.1 Installation of IBM Spectrum Archive Single Drive Edition Single Drive Edition

    # rpm -Uhv ./ltfssde-2.2.1.1-[revision]-[distribution].[arch].rpm

  3.2 Uninstallation of IBM Spectrum Archive Single Drive Edition Single Drive Edition

    # rpm -e ltfssde-2.2.1.1-[revision]

    Specify the current IBM Spectrum Archive Single Drive Edition version as the 2nd argument. The correct version can be obtained
    according to the procedures shown below in Section 3.3 Verify current IBM Spectrum Archive Single Drive Edition version.

  3.3 Verify current IBM Spectrum Archive Single Drive Edition version

    $ rpm -qa | grep ltfssde

  3.4 Making rpm package from src.rpm

    # rpmbuild --rebuild ltfssde-2.2.1.1-[distribution].src.rpm

  3.5 Compile from source tarball (for all distributions)

    $ tar -xvzf ltfssde-2211-[revision].tar.gz
    $ cd ltfssde-2.2.1.0
    $ ./configure
    $ make
    $ su
    # make install

4. Mac OS X based on pkg

  4.1 Prerequisites

    IBM Spectrum Archive Single Drive Edition requires the following software to be installed before %P%:

      - OSXFUSE 2.5.6
      - ICU 4.8.1.1

  4.2. Install

    [ICU 4.8.1.1]
      Double click ICUFramework-4.8.1.1.pkg and follow the instructions.

    [IBM Spectrum Archive Single Drive Edition]
      Double click ltfssde-2.2.1.1-[revision]-OSX10.6.pkg and follow the instructions
      All commands are installed under /Library/Frameworks/LTFS.framework/Versions/Current/usr/bin.

  4.3. Uninstall

    [ICU 4.8.1.1]
      Erase the /Library/Frameworks/ICU.framework directory.

    [IBM Spectrum Archive Single Drive Edition]
      Erase the /Library/Frameworks/LTFS.framework directory.

  4.4. Compile from source tarball

    Apple Developer Tools is required to build IBM Spectrum Archive from the source tarball.

      $ tar -xvzf ltfssde-2211-[revision].tar.gz
      $ cd ltfssde-2.2.1.1
      $ ./build_osx_package.sh

    The package will be built at ltfssde-2211/distribution/LTFS.pkg
