Xilinx Louvain Modularity Alveo Product Installation

Follow the steps below to install the Louvain Modularity Alveo Product. Skip the collaboration section if only deploying.

Installing Louvain Modularity Library from a Pre-built Package

  • Get the installation package amd-graphanalytics-install-1.5.9.tar.gz from the Database Analytics POC Secure Site.

  • Install Xilinx Louvain Modularity and Community Detection Alveo products and dependencies (XRT, XRM, and Alveo firmware packages)

tar xzf amd-graphanalytics-install-1.5.9.tar.gz
cd amd-graphanalytics-install && ./install.sh -p louvainmod

Setting up the Alveo Accelerator Card

The Cosine Similarity Alveo Product requires the following Alveo cards and their corresponding firmware versions to be installed on each Alveo card to use. * U50: xilinx_u50_gen3x16_xdma_201920_3 * U55C: xilinx_u55c_gen3x16_xdma_base_2

Check and install the firmware by following the steps below:

  • Run xbutil scan command to check the status of all Alveo cards on the server.

/opt/xilinx/xrt/bin/xbutil scan

  • Look at the final rows of the output to see what shell is installed on each card. The example below shows the end of the output for a server with three Alveo U50 cards, all containing the correct shell.

[0] 0000:81:00.1 xilinx_u50_gen3x16_xdma_201920_3 user(inst=131)
[1] 0000:04:00.1 xilinx_u55c_gen3x16_xdma_base_2 user(inst=130)

  • If all cards to use contain the right shell, skip the remainder of this section.

  • Issue the following command to flash the cards.

U50
sudo /opt/xilinx/xrt/bin/xbmgmt flash --update --shell xilinx_u50_gen3x16_xdma_201920_3

U55C
sudo /opt/xilinx/xrt/bin/xbmgmt flash --update --shell xilinx_u55c_gen3x16_xdma_base_2

  • Cold reboot the server after flashing is done.

Note

If you only need to build applications utilizing Xilinx GraphAnalytics products, you can skip the section “Collaborating on Louvain Modularity Product” below.

Collaborating on Louvain Modularity Product

The Louvain Modularity product is an open-source project hosted on github, you can collaborate with Xilinx and contribute to the development of the product.

  • Clone the graphanalytics repository using git.

git clone https://github.com/Xilinx/graphanalytics.git
cd graphanalytics
git submodule update --init --recursive

All commands below are executed from the root directory of the repository.

  • Install required development packages.

sudo scripts/devdeps.sh

  • Build and install the Cosine Similarity package. The example below shows installation using the Ubuntu apt package manager.

cd louvainmod
make dist
sudo apt install --reinstall ./package/xilinx-louvainmod-0.6_18.04-x86_64.deb