INSTALL

To install chapi on a machine running the old clearinghouse:

 1. Install the chapidev branch of proto-ch in the usual way:

  * use Makefile.sync on your own laptop
  * do-make-install.sh on your portal

 2. Copy the chapi tree from your laptop onto your VM

  * rsync -aztv /path/to/chapi/chapi your-host.example.com:

 3. Run the installer on your VM

  * $HOME/chapi/tools/install_chapi <VM CNAME e.g. ch-ph.gpolab.bbn.com>

 4. Create a chapi config file if you don't already have one

  * cp /etc/geni-chapi/example-chapi.ini /etc/geni-chapi/chapi.ini
  * edit /etc/geni-chapi/chapi.ini
   - Set chrm.authority to your VM CNAME
   - Set db_url if necessary
   - Review and update other settings as appropriate
  * sudo service apache2 restart


To update the chapi code with a newer version:

 1. Copy the chapi package from your laptop onto your VM

  * rsync -aztv /path/to/chapi/chapi your-host.example.com

 2. Build chapi on your VM

  * cd "${HOME}"/chapi
  * autoreconf --install
  * ./configure --prefix=/usr --sysconfdir=/etc --bindir=/usr/local/bin \
                --sbindir=/usr/local/sbin
  * make
  * sudo make install
  * sudo service apache2 restart