Impinj® ItemSense™ Legacy Installation Guide

This document describes the installation procedure for legacy versions of the Impinj® ItemSense™ software platform where the procedure differs from later versions.

Table of Contents

Installation Instructions

To install ItemSense 2017r1, you will need to have already downloaded the archive file. This file will be named similar to the following: is.IT-BTIC-BUT.0.1.XX.tar.bz2 As the file is roughly 1.3Gb it may take a while to download, depending on your connection.

When the archive file has been obtained:

  1. Put the file on to the target server.

    scp is.IT-BTIC-BUT.0.1.XX.tar.bz2 USERNAME@TARGET_SERVER:.


    • USERNAME should be replaced with the user on the target server.
    • TARGET_SERVER should be replaced with the hostname or IP address of the server on which you intend to install ItemSense.
  2. When the file has completed transferring to the target server, log on to the target server and navigate to the location where you copied the file. If you followed the command above, the file will be in the home directory of the user used to transfer the file on to the target server. Note: No matter where you extract the archive file to, ItemSense will always be installed to the home directory pointed to by the environment variable $HOME.

  3. From the same directory as the ItemSense archive file run the following to extract the archives contents:

    tar -xvjf is.IT-BTIC-BUT.0.1.XX.tar.bz2

    Example output:


    Note: this can take up to 2 minutes to complete, particularly the extraction of the is-container.tar file.

  4. Check that the file has extracted correctly:

    ls tarfile


    firmware  images  itemsense-prod-1.6.0.yml
  5. Enter the tarfile directory:

    cd tarfile

  6. Run the installer script with the argument "install" or "upgrade" depending on the type of installation you are performing. Note: this script should be run either as the root user or with sudo. If run as the root user ItemSense will be installed in the root user's home directory (typically /root).

    sudo bash ./ install

    Example output:

    INFO: Installing/Upgrading Itemsense
    INFO: Unable to locate previously supported version of ItemSense. Performing new install under /home/is_support.
    INFO: Installing new files
    INFO: Unpacking docker container images
    fe4c16cbf7a4: Loading layer [==================================================>] 128.9 MB/128.9 MB
    f1621398948b: Loading layer [==================================================>] 344.6 kB/344.6 kB
    6ebad06b3e49: Loading layer [==================================================>]  4.32 MB/4.32 MB
    1bc74a039df4: Loading layer [==================================================>] 1.536 kB/1.536 kB
    3310797b3a3e: Loading layer [==================================================>] 14.77 MB/14.77 MB
    9b57cb0de8c4: Loading layer [==================================================>] 44.03 kB/44.03 kB
    9bb3d5b8bde2: Loading layer [==================================================>]  5.12 kB/5.12 kB
    7702d916a821: Loading layer [==================================================>]  5.12 kB/5.12 kB
    4718e4c50ba4: Loading layer [==================================================>] 200.4 MB/200.4 MB
    23ff69eb2af2: Loading layer [==================================================>] 8.192 kB/8.192 kB
    c6080284fae2: Loading layer [==================================================>] 7.168 kB/7.168 kB
    78535633caa2: Loading layer [==================================================>] 1.536 kB/1.536 kB
    db4a198f9fa3: Loading layer [==================================================>] 3.584 kB/3.584 kB
    9dfe48bfe0b2: Loading layer [==================================================>]  7.68 kB/7.68 kB
    Loaded image: isreg/is-mariadb:10.0.28
    6650225473f3: Loading layer [==================================================>] 197.2 MB/197.2 MB
    724e9db35fe0: Loading layer [==================================================>] 208.9 kB/208.9 kB
    3973e2de72ae: Loading layer [==================================================>] 4.608 kB/4.608 kB
    5f70bf18a086: Loading layer [==================================================>] 1.024 kB/1.024 kB
    0cd01e86530e: Loading layer [==================================================>] 56.32 kB/56.32 kB
    1ef215608c77: Loading layer [==================================================>]   123 MB/123 MB
    ebe3fd02e7e0: Loading layer [==================================================>] 107.5 kB/107.5 kB
    416f17772e10: Loading layer [==================================================>] 1.294 GB/1.294 GB
    4a25411a26ad: Loading layer [==================================================>] 3.072 kB/3.072 kB
    47d6276e098a: Loading layer [==================================================>] 3.072 kB/3.072 kB
    5cf819b5200c: Loading layer [==================================================>] 3.072 kB/3.072 kB
    8a6bad46e220: Loading layer [==================================================>] 3.072 kB/3.072 kB
    ee83b3cb399c: Loading layer [==================================================>] 3.072 kB/3.072 kB
    c1f406273bff: Loading layer [==================================================>] 3.072 kB/3.072 kB
    20f1f7e7d0eb: Loading layer [==================================================>] 4.608 kB/4.608 kB
    525ec7957f2f: Loading layer [==================================================>] 4.608 kB/4.608 kB
    e2367a8885bc: Loading layer [==================================================>] 6.656 kB/6.656 kB
    aee632822548: Loading layer [==================================================>] 6.656 kB/6.656 kB
    bad25e87ab04: Loading layer [==================================================>] 163.4 MB/163.4 MB
    1fc3e5a5aed7: Loading layer [==================================================>] 227.5 MB/227.5 MB
    4f26b41745e0: Loading layer [==================================================>] 623.2 MB/623.2 MB
    Loaded image: isreg/itemsense:develop-16f25
    INFO: Firmware images
    INFO: Start the new docker compose file
    Creating network "is_support_default" with the default driver
    Creating is_support_itemsense_1
    Creating is_support_is-db_1
    INFO: Installation complete
  7. After the installation script finishes, remove the tarfile directory but keep the ItemSense archive file. If you want to uninstall ItemSense via the automated process, you will need the installation script, which is contained in the archive file.

  8. In a browser, navigate to the IMC using the server IP address or host name and port 3010:


    Note: after ItemSense starts it can take a minute or so before the IMC will be available

Upgrade ItemSense

If you are runnning a version of ItemSense that is older than 2017r1, please contact Impinj Support:

Uninstall ItemSense Via Automated Process

For information on uninstalling recent versions of ItemSense, refer to the Installation Guide.

To uninstall ItemSense via the automated process, follow these steps:

  1. Go to the directory where you put the ItemSense archive file. From this directory, change to the tarfile directory.

    Note: This automated process uses the installation script, which is located in the tarfile directory. If you removed the tarfile directory after you installed ItemSense, re-extract the archive contents to get the tarfile directory back:

    tar -xvjf is.IT-BTIC_BUT.0.1.XX.tar.bz2

  2. Determine whether the script supports the remove subcommand by running the installation script with the the -h option:

    sudo ./ -h

    The -h option displays information about the installation script. If remove is listed as a possible subcommand, it is supported and you can go to the next step; otherwise, you must manually uninstall ItemSense.

  3. Do one of the following steps to remove all or part of an ItemSense installation:

    • Run the installation script with the remove subcommand and -p option to remove the ItemSense software and all configuration and data files:

      sudo ./ remove -p

    • Run the installation script with the remove subcommand, omitting the -p option, to remove only the ItemSense software:

      sudo ./ remove