Skip to content

Latest commit

 

History

History
132 lines (99 loc) · 3.6 KB

install-senzing-with-local-rpm.md

File metadata and controls

132 lines (99 loc) · 3.6 KB

How to install Senzing with local RPM

Overview

Instructions for downloading Senzing RPMs and installing the Senzing API from the downloaded RPMs.

Contents

  1. Download RPM
  2. RPM filenames
  3. Volumes
  4. EULA
  5. Install RPM

Download RPM

  1. ✏️ Specify the directory where Senzing RPM should be downloaded on the local host. Example:

    export SENZING_RPM_DIR=~/Downloads

  2. Run the docker container. This will download the RPM files. This step only needs to be performed once for each version of the Senzing RPM. If the files were previously downloaded, skip to RPM filenames section. Example:

    sudo docker run \
  --rm \
  --volume ${SENZING_RPM_DIR}:/download \
  senzing/yumdownloader

RPM filenames

  1. Identify the downloaded filenames. Example:

    cd ${SENZING_RPM_DIR}
ls -latr

    The files should be near the bottom of the list.

  2. ✏️ Specify the Senzing RPM filenames. Example:

    export SENZING_API_RPM=senzingapi-3.5.1-23104.x86_64.rpm
export SENZING_DATA_RPM=senzingdata-v4-4.0.0-23084.x86_64.rpm

Volumes

  1. ✏️ Specify the directory where Senzing should be installed on the local host. Example:

    export SENZING_VOLUME=/opt/my-senzing
    1. ⚠️ macOS - File sharing must be enabled for SENZING_VOLUME.
    2. ⚠️ Windows - File sharing must be enabled for SENZING_VOLUME.

  2. Identify directories on the local host. Example:

    export SENZING_DATA_DIR=${SENZING_VOLUME}/data
export SENZING_DATA_VERSION_DIR=${SENZING_DATA_DIR}/1.0.0
export SENZING_ETC_DIR=${SENZING_VOLUME}/etc
export SENZING_G2_DIR=${SENZING_VOLUME}/g2
export SENZING_VAR_DIR=${SENZING_VOLUME}/var

EULA

To use the Senzing code, you must agree to the End User License Agreement (EULA).

  1. ⚠️ This step is intentionally tricky and not simply copy/paste. This ensures that you make a conscious effort to accept the EULA. Example:

    export SENZING_ACCEPT_EULA="<the value from this link>"

Install RPM

  1. ⚠️ Remove existing Senzing installation. If SENZING_VOLUME set incorrectly, this could be dangerous. So the first step is to verify the value of SENZING_VOLUME. Example:

    echo ${SENZING_VOLUME}

    If SENZING_VOLUME has the correct value, the next step is to delete the directory. Example:

    sudo rm -rf ${SENZING_VOLUME}

  2. Run docker container to install Senzing. Example:

    sudo docker run \
  --env SENZING_ACCEPT_EULA=${SENZING_ACCEPT_EULA} \
  --rm \
  --volume ${SENZING_DATA_DIR}:/opt/senzing/data \
  --volume ${SENZING_G2_DIR}:/opt/senzing/g2 \
  --volume ${SENZING_ETC_DIR}:/etc/opt/senzing \
  --volume ${SENZING_VAR_DIR}:/var/opt/senzing \
  --volume ${SENZING_RPM_DIR}:/data \
  senzing/yum -y localinstall /data/${SENZING_API_RPM} /data/${SENZING_DATA_RPM}

  3. Once complete, the Senzing API will be installed into ${SENZING_VOLUME}.