Ado::Manual::Installation - Various ways to install Ado
We strongly recommend using Ado with your own Perl (not the system-wide)! This will give you freedom to install modules from CPAN etc.
Get a precompiled Perl distro like "Citrus Perl" (http://www.citrusperl.com/download.html) or "ActivePerl Community Edition" (http://www.activestate.com/activeperl/downloads) for your OS, or build your own using App::perlbrew.
Ado can be downloaded from CPAN and installed manually or installed directly from CPAN using cpan or cpanm commandline tools.
cpan
cpanm
Ado is meant to be installed into a folder of your choice. It can go into the siteprefix folder of your non-system Perl distro or in its own folder. When installing Ado in its own folder, you may want to add the /path/to/ado/bin to your $PATH environment variable.
siteprefix
/path/to/ado/bin
$PATH
To install manually Ado after downloading, run the following commands:
tar -zxf Ado-X.XX.tar.gz cd Ado-X.XX/ perl Build.PL --install_base $HOME/opt/ado #or simply perl Build.PL ./Build installdeps ./Build ./Build test ./Build install
cpanm Ado #or cpan[1]> install Ado Running install for module 'Ado' Running make for B/BE/BEROV/Ado-0.26.tar.gz ... ... BEROV/Ado-0.26.tar.gz ./Build install install -- OK
Installing Ado under your own perlbrew environment
perlbrew init perlbrew install -n perl-5.18.1 --as ado -j 3 perlbrew switch ado perlbrew install-cpanm cpanm Ado
Installing Ado using Carton
echo 'requires "Ado";' > cpanfile carton install carton exec local/bin/ado daemon
Be warned that local::lib, installed on some shared hosting providers' machines, sets the environment variables $PERL5LIB, $PERL_LOCAL_LIB_ROOT, $PERL_MB_OPT, $PERL_MM_OPT. If you are aware and expect Ado to be installed in $PERL_LOCAL_LIB_ROOT (usually ~/perl5) then fine. If you are using your own Perl and not the provided on the machine, you have to reset those variables while installing Ado. Otherwise you may be unpleasantly surprised. For ActivePerl it may be best to install Ado dependencies using PPM. Ado is available as PPM package too.
$PERL5LIB, $PERL_LOCAL_LIB_ROOT, $PERL_MB_OPT, $PERL_MM_OPT
$PERL_LOCAL_LIB_ROOT
~/perl5
export PERL_MB_OPT='--install_base /home/you/example.com' #your own perl is already in $PATH and dependencies are installed perl Build.PL ./Build install
Ado::Manual, Ado, Mojolicious::Guides,
Copyright 2013-2014 Красимир Беров (Krasimir Berov).
This program is free software, you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License v3 (LGPL-3.0).
To install Ado, copy and paste the appropriate command in to your terminal.
cpanm Ado
CPAN shell
perl -MCPAN -e shell install Ado
For more information on module installation, please visit the detailed CPAN module installation guide.