Installation Manual for 2.16 on Ubuntu
These instructions are a work in progress.
These instructions cover the installation of WeBWorK 2.16 for Ubuntu Server 20.04 LTS, XXX and XXX. Specific OS instruction are embedded within this document
If you are just upgrading WeBWorK, especially if you already have existing WeBWorK courses, see Upgrading_WeBWorK_with_Github.
Also, it is assumed that you have an operating system installed. You can visit for instructions on installing the operating system or google how to install your favorite linux flavor. Also make sure the OS is upgraded to all patches within the version you are running.
Contents
Notation
First some short comments on notation we will be using. We will use <key>
to indicate that you should press a specific key (e.g. <Enter>
, <Tab>
, <F12>
, etc.). Sometimes we will also use e.g. <wwadmin password>
to indicate you have to enter the wwadmin password.
^
will indicate the <Ctrl>
key so e.g. ^X
is really shorthand for <Ctrl> <X>
, i.e. press the Ctrl key and hit the X key.
Install Software Packages
Ubuntu Software Packages
On Ubuntu and other Debian linuxes, the following instructions will get needed software packages installed.
Here is the list of Ubuntu packages that need to be installed.
apache2
cpanminus
curl
dvipng
gcc
git
libapache2-request-perl
libarray-utils-perl
libcrypt-ssleay-perl
libdatetime-perl
libdata-dump-perl
libemail-address-xs-perl
libemail-sender-perl
libexception-class-perl
libextutils-xsbuilder-perl
libfile-find-rule-perl-perl
libgd-perl
libhtml-scrubber-perl
libiterator-perl
libiterator-util-perl
libjson-perl
liblocale-maketext-lexicon-perl
libmime-tools-perl
libmoox-options-perl
libnet-ip-perl
libnet-ldap-perl
libnet-oauth-perl
libossp-uuid-perl
libpadwalker-perl
libpath-class-perl
libphp-serialization-perl
libpod-wsdl-perl
libsoap-lite-perl
libsql-abstract-perl
libstring-shellquote-perl
libtemplate-perl
libtext-csv-perl
libtimedate-perl
libuuid-tiny-perl
libxml-parser-easytree-perl
libxml-parser-perl
libxml-writer-perl
make
netpbm
preview-latex-style
texlive
texlive-latex-extra
unzip
To install all of these packages in one fell swoop, first become root:
$ sudo su [sudo] password for wwadmin: <wwadmin password>
and then run the command (obviously you want to use cut and paste)
# apt install apache2 cpanminus curl dvipng gcc git libapache2-request-perl \ libarray-utils-perl libcrypt-ssleay-perl libdancer-perl libdancer-plugin-database-perl \ libdata-dump-perl libdatetime-perl libemail-address-xs-perl libemail-sender-perl \ libexception-class-perl libextutils-xsbuilder-perl libfile-find-rule-perl-perl \ libgd-perl libhtml-scrubber-perl libiterator-perl libiterator-util-perl libjson-perl \ liblocale-maketext-lexicon-perl libmime-tools-perl libmoox-options-perl libnet-ip-perl libnet-ldap-perl \ libnet-oauth-perl libossp-uuid-perl libpadwalker-perl libpath-class-perl \ libphp-serialization-perl libpod-wsdl-perl \ libsoap-lite-perl libsql-abstract-perl libstring-shellquote-perl libtemplate-perl \ libtext-csv-perl libtimedate-perl libuuid-tiny-perl libxml-parser-easytree-perl \ libxml-parser-perl libxml-writer-perl make netpbm \ preview-latex-style texlive texlive-latex-extra unzip
If prompted, you can always accept the default (hit <Enter>
). When the process finishes, enter
# exit
to return to a regular user.
Installation of Other Perl Modules
We will use cpanm
to install other perl modules.