source: other-projects/is-sheet-music-encore/trunk/README.txt@ 33319

1. Source the SETUP.bash file

  source ./SETUP.bash

Assumes you are in the directory where this README file is located.
  Sets IS_SHEET_MUSIC_ENCORE_HOME to this directory 

  It will install a portable/relocatable Perl if not already done
  so, and set PATH to it.

  It will set various environment variables needed to run the code
====

2. If your system does not have openssl-dev installed, (includes header and
libraries to compile up code that uses ssl) and 'apt install libssl-dev'
isn't an option, then do the following:

  tar xvzf openssl-1.1.1b.tar.gz

  cd openssl-1.1.1b
  ./config --prefix=$IS_SHEET_MUSIC_ENCORE_HOME/openssl
  make
  make install
====

3. Now install the Perl packages/modules needed with cpanm (cpan-minus):

  If openssl-dev already installed then:
    cpanm CGI
    cpanm OAuth::Lite
    cpanm LWP::Protocol::https
    

  If you have had to compile up your own openssl, then do the following
  (note, since it is a bit harder to get the customized INC, and FLAGS down
   to the dependency-installed packages, then there are a few more
   packages to install, and the order in certain places is important)
  

    CONFIG_ARGS="INC=\"$CFLAGS\" LDDLFLAGS=\"-shared -L/usr/local/lib -fstack-protector-strong $LDFLAGS\" LDFLAGS=\"-fstack-protector-strong $LDFLAGS\""

    cpanm Crypt::OpenSSL::Random  --configure-args "$CONFIG_ARGS"

    cpanm Crypt::OpenSSL::RSA --configure-args "$CONFIG_ARGS"

    cpanm OAuth::Lite --configure-args "$CONFIG_ARGS"

    cpanm CGI --configure-args "$CONFIG_ARGS"

    cpanm --notest NET::SSLeay --configure-args "$CONFIG_ARGS"

    cpanm LWP::Protocol::https  --configure-args "$CONFIG_ARGS"