Installing Zymonic from Scratch: Difference between revisions
Amasidlover (talk | contribs) No edit summary |
(Added more details) |
||
Line 43: | Line 43: | ||
documentation for it - the Installer/updater command is further |
documentation for it - the Installer/updater command is further |
||
documented in the full documentation. |
documented in the full documentation. |
||
=More details - NOT COMPLETE YET= |
|||
For setting up Zymonic from scratch on a Ubuntu server, you will need to do the following: |
|||
=Become root user= |
|||
This saves time typing sudo constantly. After setup is finished it's ill advised to continue using it. |
|||
sudo su |
|||
=Install required packages= |
|||
This gets the required server applications installed. |
|||
apt install build-essential checkinstall zlib1g-dev -y |
|||
apt install subversion |
|||
apt install make |
|||
apt install autoconf |
|||
apt install libexpat1-dev |
|||
apt install libtool |
|||
apt install graphviz |
|||
apt install libssl-dev |
|||
apt install libnet-ssleay-perl |
|||
apt install libcrypt-ssleay-perl |
|||
apt install libio-socket-ssl-perl |
|||
apt install apache2 |
|||
=Install required ssl= |
|||
This sets up SSL |
|||
mkdir ~/perl5 |
|||
mkdir ~/perl5/perlbrew |
|||
mkdir ~/perl5/perlbrew/openssl |
|||
cd ~/perl5/perlbrew/openssl |
|||
wget https://www.openssl.org/source/openssl-1.1.1.tar.gz |
|||
tar -xf openssl-1.1.1.tar.gz |
|||
cd openssl-1.1.1 |
|||
./config shared --prefix=$PERLBREW_ROOT/openssl |
|||
make |
|||
make test |
|||
=Checkout any required repositories to root= |
|||
This gets the core Zymonic module checked out onto the server, feel free to add more repositories of XML for Zymonic systems. |
|||
svn co https://svn.zednax.com/svn/zymonic/trunk /root/trunk |
|||
=Make repositories/filepaths= |
|||
This sets the Zymonic filesystem up. |
|||
cd /root/trunk/modules/Zymonic |
|||
perl Makefile.PL && make install |
|||
cd /root/trunk/modules/MANIFESTS |
|||
perl Makefile.PL && make install |
|||
mkdir /var/errors |
|||
mkdir /etc/zymonic |
|||
vi /etc/zymonic/error.conf [PUT ERROR CONFIG DETAILS IN HERE] |
|||
=Install required CPAN modules= |
|||
These are required for Zymonic to be able to use the external dependencies. |
|||
cpan XML::Parser |
|||
cpan XML::Simple |
|||
cpan Exception::Class |
|||
cpan Date::Manip |
|||
cpan Date::Calc |
|||
cpan Clone |
|||
cpan POSIX::strptime |
|||
cpan File::Slurp |
|||
cpan DBI |
|||
cpan File::Which |
|||
cpan GraphViz |
|||
cpan CGI |
|||
cpan XML::LibXML |
|||
cpan JSON |
|||
cpan Taint::Util |
|||
cpan Data::Compare |
|||
cpan HTML::FormatText::WithLinks |
|||
cpan Crypt::CBC |
|||
cpan Crypt::OpenSSL::RSA |
|||
cpan IPC::ShareLite |
|||
cpan Term::ReadKey |
|||
cpan Net::SSLeay |
|||
cpan IO::Socket::SSL |
|||
cpan Config::Simple |
|||
cpan Apache::ConfigParser |
|||
cpan Sys::Info::OS |
|||
cpan Sys::Info::Driver::Linux::OS |
|||
cpan Text::CSV::Encoded |
|||
cpan Business::CreditCard |
|||
cpan Data::Structure::Util |
|||
cpan List::MoreUtils |
|||
cpan Locale::Currency::Format |
|||
cpan MIME::Lite |
|||
cpan Mail::Sendmail |
|||
cpan Unix::Syslog |
|||
cpan Module::Reload |
|||
=Configuring Apache= |
|||
(Assuming you're using apache2) |
|||
Due to zymonic forcing https, you will need to configure apache to allow https. |
Revision as of 08:54, 27 August 2019
Before starting
Before starting you need to be familiar with the following terms/concepts:
Repository - this is where code resides and is maintained by the developers. In general the guide uses the term repository to refer to a location on a version control server that contains one or more 'manifests'.
Manifest - In the context of Zymonic a Manifest contains a list of files to be installed and instructions to run after install that the installer will use to install the files needed to provide a particular piece of functionality, e.g., Core or Decryptor
Installing Zymonic from Scratch
Checkout the Zymonic code from our repository to a working copy
Follow instructions in [zymonic working copy]/modules/Zymonic/README
Correct as of 04-10-2018:
1) cd to [zymonic working copy]/modules/Zymonic
2) sudo perl Makefile.PL && sudo make install
3) cd to [zymonic working copy]/modules/MANIFESTS
4) sudo perl Makefile.PL && sudo make install
5) For each additional repository desired, checkout the working copy, locate the MANIFESTS subdirectory and do
sudo perl Makefile.PL && sudo make install
- note the base name (i.e. filename with no directory or .pm extension) of the file in MANIFESTS/lib/Zymonic/Manifest/ that ends with _manifests.pm - should also be documented in the MANIFESTS/README file.
6a) sudo zymonic_toolkit_curses.pl Installer - then select 'Installer -> install' from the menu, populate the manifests field with a comma separated list with no spaces of core, core_manifest and all of the _manifest files identified in 5 e.g. core,core_manifests,medoc_manifests,zednax_manifests - populate the remainder of options as appropriate for your server.
6b) If you do not have curses or don't wish to use it then do; sudo zymonic_toolkit.pl Installer install --manifests [ list of manifests
e.g. core,core_manifests,medoc_manifests,zednax_manifests ]
7) Under guidance from your supplier/developer install the remaining needed manifests, create and config build a system and then build the documentation for it - the Installer/updater command is further documented in the full documentation.
More details - NOT COMPLETE YET
For setting up Zymonic from scratch on a Ubuntu server, you will need to do the following:
Become root user
This saves time typing sudo constantly. After setup is finished it's ill advised to continue using it.
sudo su
Install required packages
This gets the required server applications installed.
apt install build-essential checkinstall zlib1g-dev -y apt install subversion apt install make apt install autoconf apt install libexpat1-dev apt install libtool apt install graphviz apt install libssl-dev apt install libnet-ssleay-perl apt install libcrypt-ssleay-perl apt install libio-socket-ssl-perl apt install apache2
Install required ssl
This sets up SSL
mkdir ~/perl5 mkdir ~/perl5/perlbrew mkdir ~/perl5/perlbrew/openssl cd ~/perl5/perlbrew/openssl wget https://www.openssl.org/source/openssl-1.1.1.tar.gz tar -xf openssl-1.1.1.tar.gz cd openssl-1.1.1 ./config shared --prefix=$PERLBREW_ROOT/openssl make make test
Checkout any required repositories to root
This gets the core Zymonic module checked out onto the server, feel free to add more repositories of XML for Zymonic systems.
svn co https://svn.zednax.com/svn/zymonic/trunk /root/trunk
Make repositories/filepaths
This sets the Zymonic filesystem up.
cd /root/trunk/modules/Zymonic perl Makefile.PL && make install cd /root/trunk/modules/MANIFESTS perl Makefile.PL && make install mkdir /var/errors mkdir /etc/zymonic vi /etc/zymonic/error.conf [PUT ERROR CONFIG DETAILS IN HERE]
Install required CPAN modules
These are required for Zymonic to be able to use the external dependencies.
cpan XML::Parser cpan XML::Simple cpan Exception::Class cpan Date::Manip cpan Date::Calc cpan Clone cpan POSIX::strptime cpan File::Slurp cpan DBI cpan File::Which cpan GraphViz cpan CGI cpan XML::LibXML cpan JSON cpan Taint::Util cpan Data::Compare cpan HTML::FormatText::WithLinks cpan Crypt::CBC cpan Crypt::OpenSSL::RSA cpan IPC::ShareLite cpan Term::ReadKey cpan Net::SSLeay cpan IO::Socket::SSL cpan Config::Simple cpan Apache::ConfigParser cpan Sys::Info::OS cpan Sys::Info::Driver::Linux::OS cpan Text::CSV::Encoded cpan Business::CreditCard cpan Data::Structure::Util cpan List::MoreUtils cpan Locale::Currency::Format cpan MIME::Lite cpan Mail::Sendmail cpan Unix::Syslog cpan Module::Reload
Configuring Apache
(Assuming you're using apache2) Due to zymonic forcing https, you will need to configure apache to allow https.