Skip to content

Latest commit

 

History

History
102 lines (74 loc) · 2.94 KB

install-senzing-for-go-development.md

File metadata and controls

102 lines (74 loc) · 2.94 KB

HOWTO - Install Senzing for Go Development

The following steps show how to install and configure Senzing for Go development.

Install Senzing

This can be done by installing the Senzing package using apt, yum, or a technique using Docker containers. Once complete, the Senzing library will be installed in the /opt/senzing directory. This is important as the compiling of the Go code expects Senzing to be in /opt/senzing.

  • Using apt:

    wget https://senzing-production-apt.s3.amazonaws.com/senzingrepo_1.0.0-1_amd64.deb
sudo apt install ./senzingrepo_1.0.0-1_amd64.deb
sudo apt update
sudo apt install senzingapi

  • Using yum:

    sudo yum install https://senzing-production-yum.s3.amazonaws.com/senzingrepo-1.0.0-1.x86_64.rpm
sudo yum install senzingapi

  • Using Docker:

    This technique can be handy if you are using MacOS or Windows and cross-compiling.

    1. Build Senzing installer.

      curl -X GET \
    --output /tmp/senzing-versions-stable.sh \
    https://raw.githubusercontent.com/Senzing/knowledge-base/main/lists/senzing-versions-stable.sh
source /tmp/senzing-versions-stable.sh

sudo docker build \
    --build-arg SENZING_ACCEPT_EULA=I_ACCEPT_THE_SENZING_EULA \
    --build-arg SENZING_APT_INSTALL_PACKAGE=senzingapi=${SENZING_VERSION_SENZINGAPI_BUILD} \
    --build-arg SENZING_DATA_VERSION=${SENZING_VERSION_SENZINGDATA} \
    --no-cache \
    --tag senzing/installer:${SENZING_VERSION_SENZINGAPI} \
    https://github.com/senzing-garage/docker-installer.git#main

    2. Install Senzing.

          curl -X GET \
        --output /tmp/senzing-versions-stable.sh \
        https://raw.githubusercontent.com/Senzing/knowledge-base/main/lists/senzing-versions-stable.sh
    source /tmp/senzing-versions-stable.sh

    sudo rm -rf /opt/senzing
    sudo mkdir -p /opt/senzing

    sudo docker run \
        --rm \
        --user 0 \
        --volume /opt/senzing:/opt/senzing \
        senzing/installer:${SENZING_VERSION_SENZINGAPI}

Configure Senzing

  1. ✏️ Move the "versioned" Senzing data to the system location. Example:

      sudo mv /opt/senzing/data/4.0.0/* /opt/senzing/data/

  2. Create initial configuration. Example:

    export SENZING_ETC_FILES=( \
    "cfgVariant.json" \
    "customGn.txt" \
    "customOn.txt" \
    "customSn.txt" \
    "defaultGNRCP.config" \
    "g2config.json" \
    "G2Module.ini" \
    "stb.config" \
)

sudo mkdir /etc/opt/senzing
for SENZING_ETC_FILE in ${SENZING_ETC_FILES[@]}; \
do \
    sudo --preserve-env cp /opt/senzing/g2/resources/templates/${SENZING_ETC_FILE} /etc/opt/senzing/${SENZING_ETC_FILE}
done