From a31c63972f1bb32df01616ac8821a7f14bef8f30 Mon Sep 17 00:00:00 2001 From: Graeme Robertson Date: Thu, 4 Aug 2016 17:41:28 +0000 Subject: [PATCH 1/3] Create homer-cassandra and homestead-prov-cassandra packages --- Makefile | 1 + debian/.gitignore | 2 + debian/control | 16 +++- debian/crest.install | 4 +- debian/homer-cassandra.install | 1 + debian/homer-cassandra.postinst | 75 +++++++++++++++++++ debian/homestead-prov-cassandra.install | 1 + debian/homestead-prov-cassandra.postinst | 75 +++++++++++++++++++ .../clearwater/cassandra-schemas/homer.sh | 0 .../infrastructure/scripts/homer-cassandra | 38 ++++++++++ .../clearwater/infrastructure/scripts/homer | 3 - .../homestead_provisioning.sh | 0 .../scripts/homestead-prov-cassandra | 38 ++++++++++ .../infrastructure/scripts/homestead-prov | 3 - 14 files changed, 246 insertions(+), 11 deletions(-) create mode 100644 debian/homer-cassandra.install create mode 100644 debian/homer-cassandra.postinst create mode 100644 debian/homestead-prov-cassandra.install create mode 100644 debian/homestead-prov-cassandra.postinst rename {homer.root => homer-cassandra.root}/usr/share/clearwater/cassandra-schemas/homer.sh (100%) create mode 100755 homer-cassandra.root/usr/share/clearwater/infrastructure/scripts/homer-cassandra rename {homestead.root => homestead-prov-cassandra.root}/usr/share/clearwater/cassandra-schemas/homestead_provisioning.sh (100%) create mode 100755 homestead-prov-cassandra.root/usr/share/clearwater/infrastructure/scripts/homestead-prov-cassandra diff --git a/Makefile b/Makefile index aa99f5f..ee7065a 100644 --- a/Makefile +++ b/Makefile @@ -7,6 +7,7 @@ DEB_MAJOR_VERSION := 1.0${DEB_VERSION_QUALIFIER} DEB_NAMES := crest DEB_NAMES += homer homer-node DEB_NAMES += homestead-prov +DEB_NAMES += homer-cassandra homestead-prov-cassandra MAX_LINE_LENGTH ?= 99 diff --git a/debian/.gitignore b/debian/.gitignore index 90000ad..34e5d47 100644 --- a/debian/.gitignore +++ b/debian/.gitignore @@ -8,3 +8,5 @@ /homer-node/ /homestead/ /homestead-prov/ +/homer-cassandra/ +/homestead-prov-cassandra/ diff --git a/debian/control b/debian/control index 90b9d00..99299dc 100644 --- a/debian/control +++ b/debian/control @@ -17,15 +17,25 @@ Description: crest, a Cassandra powered generic RESTful HTTP server platform Package: homer-node Architecture: any -Depends: homer, clearwater-cassandra -Description: homer-node, the Cassandra powered XDMS node +Depends: homer, homer-cassandra +Description: Homer, the Cassandra powered XDMS node Package: homer Architecture: any Depends: crest -Description: homer, the Cassandra powered XDMS +Description: Homer, the Cassandra powered XDMS Package: homestead-prov Architecture: any Depends: crest Description: Provisioning backend for Homestead, the Cassandra powered HSS gateway + +Package: homer-cassandra +Architecture: any +Depends: clearwater-cassandra, clearwater-infrastructure +Description: Commissions a Cassandra node so that it can be used as a backend for the homer package + +Package: homestead-prov-cassandra +Architecture: any +Depends: clearwater-cassandra, clearwater-infrastructure, homestead-cassandra +Description: Commissions a Cassandra node so that it can be used as a backend for the homestead-prov package diff --git a/debian/crest.install b/debian/crest.install index 29b0de4..ffbde88 100644 --- a/debian/crest.install +++ b/debian/crest.install @@ -1,3 +1,3 @@ -.crest-eggs/* usr/share/clearwater/crest/.eggs/ -src/metaswitch/crest/tools usr/share/clearwater/crest/src/metaswitch/crest/ +.crest-eggs/* /usr/share/clearwater/crest/.eggs/ +src/metaswitch/crest/tools /usr/share/clearwater/crest/src/metaswitch/crest/ src/metaswitch/crest/tools/sstable_provisioning/* /usr/share/clearwater/crest/tools/sstable_provisioning diff --git a/debian/homer-cassandra.install b/debian/homer-cassandra.install new file mode 100644 index 0000000..84bcde5 --- /dev/null +++ b/debian/homer-cassandra.install @@ -0,0 +1 @@ +homer-cassandra.root/* / diff --git a/debian/homer-cassandra.postinst b/debian/homer-cassandra.postinst new file mode 100644 index 0000000..80ec80d --- /dev/null +++ b/debian/homer-cassandra.postinst @@ -0,0 +1,75 @@ +#/bin/sh + +# @file homer-cassandra.postinst +# +# Project Clearwater - IMS in the Cloud +# Copyright (C) 2016 Metaswitch Networks Ltd +# +# This program is free software: you can redistribute it and/or modify it +# under the terms of the GNU General Public License as published by the +# Free Software Foundation, either version 3 of the License, or (at your +# option) any later version, along with the "Special Exception" for use of +# the program along with SSL, set forth below. This program 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 General Public License for more +# details. You should have received a copy of the GNU General Public +# License along with this program. If not, see +# . +# +# The author can be reached by email at clearwater@metaswitch.com or by +# post at Metaswitch Networks Ltd, 100 Church St, Enfield EN2 6BQ, UK +# +# Special Exception +# Metaswitch Networks Ltd grants you permission to copy, modify, +# propagate, and distribute a work formed by combining OpenSSL with The +# Software, or a work derivative of such a combination, even if such +# copying, modification, propagation, or distribution would otherwise +# violate the terms of the GPL. You must comply with the GPL in all +# respects for all of the code used other than OpenSSL. +# "OpenSSL" means OpenSSL toolkit software distributed by the OpenSSL +# Project and licensed under the OpenSSL Licenses, or a work based on such +# software and licensed under the OpenSSL Licenses. +# "OpenSSL Licenses" means the OpenSSL License and Original SSLeay License +# under which the OpenSSL Project distributes the OpenSSL toolkit software, +# as those licenses appear in the file LICENSE-OPENSSL. + +# +# see: dh_installdeb(1) + +set -e + +# summary of how this script can be called: +# * `configure' +# * `abort-upgrade' +# * `abort-remove' `in-favour' +# +# * `abort-remove' +# * `abort-deconfigure' `in-favour' +# `removing' +# +# for details, see http://www.debian.org/doc/debian-policy/ or +# the debian-policy package + +# dh_installdeb will replace this with shell code automatically +# generated by other debhelper scripts. + +#DEBHELPER# + +case "$1" in + configure) + # Restart clearwater-infrastructure in order to trigger the + # homer-cassandra script. + service clearwater-infrastructure restart + ;; + + abort-upgrade|abort-remove|abort-deconfigure) + ;; + + *) + echo "postinst called with unknown argument \`$1'" >&2 + exit 1 + ;; +esac + +exit 0 diff --git a/debian/homestead-prov-cassandra.install b/debian/homestead-prov-cassandra.install new file mode 100644 index 0000000..bb197cf --- /dev/null +++ b/debian/homestead-prov-cassandra.install @@ -0,0 +1 @@ +homestead-prov-cassandra.root/* / diff --git a/debian/homestead-prov-cassandra.postinst b/debian/homestead-prov-cassandra.postinst new file mode 100644 index 0000000..9f53963 --- /dev/null +++ b/debian/homestead-prov-cassandra.postinst @@ -0,0 +1,75 @@ +#/bin/sh + +# @file homestead-prov-cassandra.postinst +# +# Project Clearwater - IMS in the Cloud +# Copyright (C) 2016 Metaswitch Networks Ltd +# +# This program is free software: you can redistribute it and/or modify it +# under the terms of the GNU General Public License as published by the +# Free Software Foundation, either version 3 of the License, or (at your +# option) any later version, along with the "Special Exception" for use of +# the program along with SSL, set forth below. This program 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 General Public License for more +# details. You should have received a copy of the GNU General Public +# License along with this program. If not, see +# . +# +# The author can be reached by email at clearwater@metaswitch.com or by +# post at Metaswitch Networks Ltd, 100 Church St, Enfield EN2 6BQ, UK +# +# Special Exception +# Metaswitch Networks Ltd grants you permission to copy, modify, +# propagate, and distribute a work formed by combining OpenSSL with The +# Software, or a work derivative of such a combination, even if such +# copying, modification, propagation, or distribution would otherwise +# violate the terms of the GPL. You must comply with the GPL in all +# respects for all of the code used other than OpenSSL. +# "OpenSSL" means OpenSSL toolkit software distributed by the OpenSSL +# Project and licensed under the OpenSSL Licenses, or a work based on such +# software and licensed under the OpenSSL Licenses. +# "OpenSSL Licenses" means the OpenSSL License and Original SSLeay License +# under which the OpenSSL Project distributes the OpenSSL toolkit software, +# as those licenses appear in the file LICENSE-OPENSSL. + +# +# see: dh_installdeb(1) + +set -e + +# summary of how this script can be called: +# * `configure' +# * `abort-upgrade' +# * `abort-remove' `in-favour' +# +# * `abort-remove' +# * `abort-deconfigure' `in-favour' +# `removing' +# +# for details, see http://www.debian.org/doc/debian-policy/ or +# the debian-policy package + +# dh_installdeb will replace this with shell code automatically +# generated by other debhelper scripts. + +#DEBHELPER# + +case "$1" in + configure) + # Restart clearwater-infrastructure in order to trigger the + # homestead-prov-cassandra script. + service clearwater-infrastructure restart + ;; + + abort-upgrade|abort-remove|abort-deconfigure) + ;; + + *) + echo "postinst called with unknown argument \`$1'" >&2 + exit 1 + ;; +esac + +exit 0 diff --git a/homer.root/usr/share/clearwater/cassandra-schemas/homer.sh b/homer-cassandra.root/usr/share/clearwater/cassandra-schemas/homer.sh similarity index 100% rename from homer.root/usr/share/clearwater/cassandra-schemas/homer.sh rename to homer-cassandra.root/usr/share/clearwater/cassandra-schemas/homer.sh diff --git a/homer-cassandra.root/usr/share/clearwater/infrastructure/scripts/homer-cassandra b/homer-cassandra.root/usr/share/clearwater/infrastructure/scripts/homer-cassandra new file mode 100755 index 0000000..4d56731 --- /dev/null +++ b/homer-cassandra.root/usr/share/clearwater/infrastructure/scripts/homer-cassandra @@ -0,0 +1,38 @@ +#!/bin/bash + +# @file homer-cassandra +# +# Project Clearwater - IMS in the Cloud +# Copyright (C) 2016 Metaswitch Networks Ltd +# +# This program is free software: you can redistribute it and/or modify it +# under the terms of the GNU General Public License as published by the +# Free Software Foundation, either version 3 of the License, or (at your +# option) any later version, along with the "Special Exception" for use of +# the program along with SSL, set forth below. This program 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 General Public License for more +# details. You should have received a copy of the GNU General Public +# License along with this program. If not, see +# . +# +# The author can be reached by email at clearwater@metaswitch.com or by +# post at Metaswitch Networks Ltd, 100 Church St, Enfield EN2 6BQ, UK +# +# Special Exception +# Metaswitch Networks Ltd grants you permission to copy, modify, +# propagate, and distribute a work formed by combining OpenSSL with The +# Software, or a work derivative of such a combination, even if such +# copying, modification, propagation, or distribution would otherwise +# violate the terms of the GPL. You must comply with the GPL in all +# respects for all of the code used other than OpenSSL. +# "OpenSSL" means OpenSSL toolkit software distributed by the OpenSSL +# Project and licensed under the OpenSSL Licenses, or a work based on such +# software and licensed under the OpenSSL Licenses. +# "OpenSSL Licenses" means the OpenSSL License and Original SSLeay License +# under which the OpenSSL Project distributes the OpenSSL toolkit software, +# as those licenses appear in the file LICENSE-OPENSSL. + +# Create Cassandra schema +/usr/share/clearwater/cassandra-schemas/homer.sh || /bin/true diff --git a/homer.root/usr/share/clearwater/infrastructure/scripts/homer b/homer.root/usr/share/clearwater/infrastructure/scripts/homer index edef66b..a00acbf 100755 --- a/homer.root/usr/share/clearwater/infrastructure/scripts/homer +++ b/homer.root/usr/share/clearwater/infrastructure/scripts/homer @@ -51,6 +51,3 @@ then s/^CASS_HOST = .*$/CASS_HOST = "'$(escape $cassandra_hostname)'"/g' < /usr/share/clearwater/homer/templates/local_settings.py >/tmp/local_settings.py.$$ mv /tmp/local_settings.py.$$ /usr/share/clearwater/homer/local_settings.py fi - -# Create Cassandra schema -/usr/share/clearwater/cassandra-schemas/homer.sh || /bin/true diff --git a/homestead.root/usr/share/clearwater/cassandra-schemas/homestead_provisioning.sh b/homestead-prov-cassandra.root/usr/share/clearwater/cassandra-schemas/homestead_provisioning.sh similarity index 100% rename from homestead.root/usr/share/clearwater/cassandra-schemas/homestead_provisioning.sh rename to homestead-prov-cassandra.root/usr/share/clearwater/cassandra-schemas/homestead_provisioning.sh diff --git a/homestead-prov-cassandra.root/usr/share/clearwater/infrastructure/scripts/homestead-prov-cassandra b/homestead-prov-cassandra.root/usr/share/clearwater/infrastructure/scripts/homestead-prov-cassandra new file mode 100755 index 0000000..8f204a0 --- /dev/null +++ b/homestead-prov-cassandra.root/usr/share/clearwater/infrastructure/scripts/homestead-prov-cassandra @@ -0,0 +1,38 @@ +#!/bin/bash + +# @file homer-cassandra +# +# Project Clearwater - IMS in the Cloud +# Copyright (C) 2016 Metaswitch Networks Ltd +# +# This program is free software: you can redistribute it and/or modify it +# under the terms of the GNU General Public License as published by the +# Free Software Foundation, either version 3 of the License, or (at your +# option) any later version, along with the "Special Exception" for use of +# the program along with SSL, set forth below. This program 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 General Public License for more +# details. You should have received a copy of the GNU General Public +# License along with this program. If not, see +# . +# +# The author can be reached by email at clearwater@metaswitch.com or by +# post at Metaswitch Networks Ltd, 100 Church St, Enfield EN2 6BQ, UK +# +# Special Exception +# Metaswitch Networks Ltd grants you permission to copy, modify, +# propagate, and distribute a work formed by combining OpenSSL with The +# Software, or a work derivative of such a combination, even if such +# copying, modification, propagation, or distribution would otherwise +# violate the terms of the GPL. You must comply with the GPL in all +# respects for all of the code used other than OpenSSL. +# "OpenSSL" means OpenSSL toolkit software distributed by the OpenSSL +# Project and licensed under the OpenSSL Licenses, or a work based on such +# software and licensed under the OpenSSL Licenses. +# "OpenSSL Licenses" means the OpenSSL License and Original SSLeay License +# under which the OpenSSL Project distributes the OpenSSL toolkit software, +# as those licenses appear in the file LICENSE-OPENSSL. + +# Create Cassandra schema +/usr/share/clearwater/cassandra-schemas/homestead_provisioning.sh || /bin/true diff --git a/homestead.root/usr/share/clearwater/infrastructure/scripts/homestead-prov b/homestead.root/usr/share/clearwater/infrastructure/scripts/homestead-prov index 063ab9a..4d48b33 100755 --- a/homestead.root/usr/share/clearwater/infrastructure/scripts/homestead-prov +++ b/homestead.root/usr/share/clearwater/infrastructure/scripts/homestead-prov @@ -32,6 +32,3 @@ then mv /tmp/local_settings.py.$$ /usr/share/clearwater/homestead/local_settings.py fi - -# Create Cassandra schema -/usr/share/clearwater/cassandra-schemas/homestead_provisioning.sh || /bin/true From bc0211d578eee987af1393059475ae77b6205780 Mon Sep 17 00:00:00 2001 From: Graeme Robertson Date: Tue, 9 Aug 2016 10:54:54 +0000 Subject: [PATCH 2/3] Move bulk provisioning tools to cassandra service packages --- debian/crest.install | 2 -- debian/homer-cassandra.install | 2 ++ debian/homestead-prov-cassandra.install | 2 ++ docs/Bulk-Provisioning Numbers.md | 11 ++++------- .../crest/tools/sstable_provisioning/README.md | 8 ++++---- 5 files changed, 12 insertions(+), 13 deletions(-) diff --git a/debian/crest.install b/debian/crest.install index ffbde88..06816d4 100644 --- a/debian/crest.install +++ b/debian/crest.install @@ -1,3 +1 @@ .crest-eggs/* /usr/share/clearwater/crest/.eggs/ -src/metaswitch/crest/tools /usr/share/clearwater/crest/src/metaswitch/crest/ -src/metaswitch/crest/tools/sstable_provisioning/* /usr/share/clearwater/crest/tools/sstable_provisioning diff --git a/debian/homer-cassandra.install b/debian/homer-cassandra.install index 84bcde5..b63ccd0 100644 --- a/debian/homer-cassandra.install +++ b/debian/homer-cassandra.install @@ -1 +1,3 @@ homer-cassandra.root/* / +src/metaswitch/crest/tools /usr/share/clearwater/crest/src/metaswitch/crest/ +src/metaswitch/crest/tools/sstable_provisioning/* /usr/share/clearwater/crest/tools/sstable_provisioning diff --git a/debian/homestead-prov-cassandra.install b/debian/homestead-prov-cassandra.install index bb197cf..e653528 100644 --- a/debian/homestead-prov-cassandra.install +++ b/debian/homestead-prov-cassandra.install @@ -1 +1,3 @@ homestead-prov-cassandra.root/* / +src/metaswitch/crest/tools /usr/share/clearwater/crest/src/metaswitch/crest/ +src/metaswitch/crest/tools/sstable_provisioning/* /usr/share/clearwater/crest/tools/sstable_provisioning diff --git a/docs/Bulk-Provisioning Numbers.md b/docs/Bulk-Provisioning Numbers.md index db94813..a15e3fb 100644 --- a/docs/Bulk-Provisioning Numbers.md +++ b/docs/Bulk-Provisioning Numbers.md @@ -3,13 +3,12 @@ Bulk-Provisioning Numbers To bulk-provision numbers, follow the following process. (There is an alternative bulk provisioning process documented [here] (https://github.com/Metaswitch/crest/blob/dev/src/metaswitch/crest/tools/sstable_provisioning/README.md) - while this is more complex to set up, it may be more suitable if you are provisioning very large sets of numbers.) -1. Log into any homestead node in your deployment. +1. Log into any Homestead Cassandra node in your deployment. 2. Create a CSV file with one row per number, and the following columns. (If you want to quickly create a contiguous range, you can use something like `. /etc/clearwater/config; for DN in {2010000000..2010099999} ; do echo sip:$DN@$home_domain ; done > users.csv`.) 1. Public SIP ID (mandatory) - 2. Private SIP ID (optional, defaults to public SIP ID, stripping - any sip: prefix) + 2. Private SIP ID (optional, defaults to public SIP ID, stripping any sip: prefix) 3. Realm (optional, defaults to domain of public SIP ID) 4. Password (optional, defaults to auto-generated random password) @@ -29,9 +28,7 @@ done > users.csv 4. Run `/usr/share/clearwater/crest/src/metaswitch/crest/tools/bulk_create.py users.csv` (or `users.auto.csv` if you used bulk\_autocomplete.py). If you need example call list data add the `--memento` option. If you want to store the passwords (in plaintext) of the subscribers add the `--plaintext_password` option. This will create a number of files in the current directory. -5. Run the resulting \*.create\_homestead.sh script on the homestead - node. -6. Copy the \*.create\_xdm.\* files to a homer node and run the - \*.create\_xdm.sh script there, as instructed. +5. Run the resulting \*.create\_homestead.sh script on the Homestead Cassandra node. +6. Copy the \*.create\_xdm.\* files to a Homer Cassandra node and run the \*.create\_xdm.sh script there, as instructed. 7. If you need call list data, copy the \*.create\_memento.\* files to a memento node and run the \*create\_memento.sh script there, as instructed. diff --git a/src/metaswitch/crest/tools/sstable_provisioning/README.md b/src/metaswitch/crest/tools/sstable_provisioning/README.md index 9091994..6e19ad5 100644 --- a/src/metaswitch/crest/tools/sstable_provisioning/README.md +++ b/src/metaswitch/crest/tools/sstable_provisioning/README.md @@ -2,11 +2,11 @@ These scripts will enable you to create a collection of sstables (Cassandra raw data) and then inject those tables directly into your Cassandra cluster. -All the scripts assume they are being run on a Homer or Homestead node with a correctly configured and balanced Cassandra cluster. +All the scripts assume they are being run on a Homer or Homestead Cassandra node and that the Cassandra clusters are correctly configured and balanced. ## Pre-requisites -* The bulk provisioning binaries - automatically installed alongside Homer/Homestead to `/usr/share/clearwater/crest/tools/sstable_provisioning` +* The bulk provisioning binaries - automatically installed on Homer/Homestead Cassandra nodes to `/usr/share/clearwater/crest/tools/sstable_provisioning` * A users CSV file - In the format output by [`bulk_autocomplete.py`](https://github.com/Metaswitch/crest/blob/dev/docs/Bulk-Provisioning%20Numbers.md) ## Disk space @@ -17,7 +17,7 @@ _For example, on AWS, instances have ony ~4Gb free so we can only provision appr ## RAM -The [Preparing the sstables](#preparing-the-sstables) step also uses quite a lot of RAM. If you're running on a homestead or homer node, Cassandra will already be using a lot of the node's RAM. For improved performance, you can stop Cassandra for the duration of that step and restart it again afterwards. This obviously causes a service outage, and so should only be used for bulk provisioning as part of initial turn-up! To stop Cassandra, run `sudo monit stop cassandra` and to restart it run `sudo monit start cassandra`. +The [Preparing the sstables](#preparing-the-sstables) step uses quite a lot of RAM, and Cassandra will likely already be using a lot of the node's RAM. For improved performance, you can stop Cassandra for the duration of that step and restart it again afterwards. This obviously causes a service outage, and so should only be used for bulk provisioning as part of initial turn-up! To stop Cassandra, run `sudo monit stop -g cassandra` and to restart it run `sudo monit start -g cassandra`. ## Preparing the sstables @@ -29,7 +29,7 @@ The sstables can be created either from CSV files describing each subscriber or In the below, `` refers to the filename of the users CSV file **without the suffix**, e.g. if the file were called `users.csv` then `` would be `users`. -Use the python executable bundled with Homer/Homestead. +Use the python executable provided on the Homer/Homestead Cassandra node. export PATH=/usr/share/clearwater/crest/env/bin:$PATH From b0ddd45511ebdf8427ee2bc2bac2524063b2c86e Mon Sep 17 00:00:00 2001 From: graemerobertson Date: Wed, 10 Aug 2016 12:04:17 +0100 Subject: [PATCH 3/3] Reword bulk provisioning README --- src/metaswitch/crest/tools/sstable_provisioning/README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/metaswitch/crest/tools/sstable_provisioning/README.md b/src/metaswitch/crest/tools/sstable_provisioning/README.md index 6e19ad5..71af64f 100644 --- a/src/metaswitch/crest/tools/sstable_provisioning/README.md +++ b/src/metaswitch/crest/tools/sstable_provisioning/README.md @@ -2,11 +2,11 @@ These scripts will enable you to create a collection of sstables (Cassandra raw data) and then inject those tables directly into your Cassandra cluster. -All the scripts assume they are being run on a Homer or Homestead Cassandra node and that the Cassandra clusters are correctly configured and balanced. +All the scripts assume they are being run on a node running the Homer or Homestead database and that the Cassandra database clusters are correctly configured and balanced. ## Pre-requisites -* The bulk provisioning binaries - automatically installed on Homer/Homestead Cassandra nodes to `/usr/share/clearwater/crest/tools/sstable_provisioning` +* The bulk provisioning binaries - automatically installed on Homer/Homestead database nodes to `/usr/share/clearwater/crest/tools/sstable_provisioning` * A users CSV file - In the format output by [`bulk_autocomplete.py`](https://github.com/Metaswitch/crest/blob/dev/docs/Bulk-Provisioning%20Numbers.md) ## Disk space @@ -29,7 +29,7 @@ The sstables can be created either from CSV files describing each subscriber or In the below, `` refers to the filename of the users CSV file **without the suffix**, e.g. if the file were called `users.csv` then `` would be `users`. -Use the python executable provided on the Homer/Homestead Cassandra node. +Use the python executable provided on the Homer/Homestead database node. export PATH=/usr/share/clearwater/crest/env/bin:$PATH