--- doc/build/ubuntu12LTS_install.frag 2012/07/30 13:04:37 1.1 +++ doc/build/ubuntu12LTS_install.frag 2022/03/26 19:00:51 1.5 @@ -33,10 +33,10 @@ The installation process takes the follo
  • Log in to LON-CAPA
  • -
    +

    1. Obtain Ubuntu 12.04 LTS .iso file

    -Ubuntu 12.04 LTS (server install) isos can be obtained from the Ubuntu Server download page
    +Ubuntu 12.04 LTS (server install) isos can be obtained from the Ubuntu Server download page
    An .iso file (either 32 bit or 64 bit) can be burned to a CD.

    @@ -56,7 +56,7 @@ DHCP is not supported.

    3. Ubuntu 12.04 LTS installation

    -Installing Ubuntu Linux is easy. +Installing Ubuntu Linux is straightforward. Documentation is available from https://help.ubuntu.com/community/Installation/ Most of the installation screens are self explanatory. @@ -86,30 +86,35 @@ There are a few steps that require comme

    The base system will be installed. Once that is complete you will have the option to select additional software collections. Leave all unselected.

    - Finish installing your server, reboot it, and log in with the username you created during installation. -

    Firewall Configuration
    -
    Use ufw to allow incoming traffic for the following services: - ssh, www, https -
    +

    +

    Firewall Configuration

    +

    +Use ufw to allow incoming traffic for the following services: +ssh, www, https +

    +sudo apt-get install ufw
     sudo ufw default deny
     sudo ufw enable
     sudo ufw allow ssh
     sudo ufw allow www
     sudo ufw allow https
     
    -
    E-mail: Postfix Installation
    -
    Configure to "Internet Site" to allow LON-CAPA to send e-mail to users.
    +

    E-mail: Postfix Installation

    +

    +Configure to "Internet Site" to allow LON-CAPA to send e-mail to users. +

     sudo apt-get install postfix
     
    -
    E-mail: Postfix Configuration
    -
    If you need to change the postfix configuration in the future use:
    +

    E-mail: Postfix Configuration

    +

    +If you need to change the postfix configuration in the future use: +

     sudo dpkg-reconfigure postfix
     
    -

    4. Update your system

    @@ -122,13 +127,6 @@ sudo apt-get upgrade

    If kernel packages were updated, reboot your system before continuing with the installation.

    -

    -Add LON-CAPA ubuntu repository to your /etc/apt/sources.list file. -

    -
    -sudo apt-get install python-software-properties
    -sudo apt-add-repository 'deb http://install.loncapa.org/ubuntu precise main'
    -

    5. Installing LON-CAPA

    Import the LON-CAPA encryption key

    @@ -136,6 +134,34 @@ wget http://install.loncapa.org/versions
     sudo apt-key add APT-GPG-KEY-loncapa.asc
     sudo apt-get update
     
    +

    Add LON-CAPA ubuntu repository to /etc/apt/sources.list

    +

    Execute:

    +
    +sudo apt-get install python-software-properties
    +sudo add-apt-repository 'deb http://install.loncapa.org/ubuntu precise main'
    +
    +

    +You can display which repositories are currently enabled by using: +

    +
    +grep '^deb ' /etc/apt/sources.list |grep ' precise '
    +
    +

    The output should contain:

    +
    +deb http://us.archive.ubuntu.com/ubuntu precise main
    +deb http://us.archive.ubuntu.com/ubuntu precise universe
    +deb http://install.loncapa.org/ubuntu precise main
    +
    +

    If the Ubuntu universe repository is absent it can be added using:

    +
    +sudo add-apt-repository universe
    +
    +

    If other Ubuntu repositories, e.g., restricted and multiverse are enabled, +you can disable them, as they are not needed for LON-CAPA, by using:

    +
    +sudo add-apt-repository --remove restricted
    +sudo add-apt-repository --remove multiverse
    +

    Install prerequisites

    Execute:

    @@ -143,6 +169,15 @@ sudo apt-get install loncapa-prerequisit
     

    This may take some minutes due to LON-CAPA's large number of dependencies.

    +

    Secure MySQL

    +

    Execute:

    +
    +sudo mysql_secure_installation
    +

    +Answer “Y” (yes) to the prompts to: +(a) remove anonymous users, +(b) restrict root user access to the local machine, +and (c) remove the test database.

    Retrieve and execute LON-CAPA setup program

    Retrieve the LON-CAPA setup script and dependencies with the following command: @@ -182,7 +217,7 @@ Once a choice has been entered for all n

  • Configure Apache web server
  • Configure start-up of services
  • Check firewall settings
  • -
  • Stop services not used by LON-CAPA,
    +
  • Stop services not used by LON-CAPA,
    e.g., services for a print server: cups daemon
  • Download LON-CAPA source code in readiness for installation
  • @@ -205,7 +240,7 @@ for it to function at all. Below is a l
    Each site or school which installs LON-CAPA needs its own domain. Here at MSU we use 'msu'. You should choose something short but meaningful. Restriction: One word, no hyphens, underscores, or - special characters.
    Domain names which include a departmental + special characters.
    Domain names which include a departmental abbreviation are not recommended as although LON-CAPA may start in a single department, other departments frequently join subsequently. For a domain name: 'msu' is a superior choice to 'msuphys' for example. @@ -233,12 +268,11 @@ for it to function at all. Below is a l

    Configuring LON-CAPA

    -To configure and install LON-CAPA, become root and execute the following commands: +To configure and install LON-CAPA execute the following commands:

    -sudo -i
    -cd /root/loncapa-X.Y.Z     (X.Y.Z should correspond to a version number like '2.11.0')
    -./UPDATE
    +cd ../loncapa-X.Y.Z  (X.Y.Z should correspond to a version number like '2.11.0')
    +sudo ./UPDATE
     

    You will need to enter the LON-CAPA configuration information you determined @@ -254,18 +288,19 @@ invoked below requires that you enter th Replace USERNAME and DOMAIN with an appropriate username and your domain.

    -cd /root/loncapa-X.Y.Z/loncom/build
    -perl make_domain_coordinator.pl USERNAME DOMAIN
    +cd loncom/build
    +sudo perl make_domain_coordinator.pl USERNAME DOMAIN
    +cd
     

    7. Start/Restart Services

    The LON-CAPA network services take a moment to start. Most misconfigurations -will be apparent at this step. Lastly, exit from root status to resume use of your regular account. +will be apparent at this step.

    -/etc/init.d/loncontrol start
    -/etc/init.d/apache2 restart
    +sudo /etc/init.d/loncontrol start
    +sudo service apache2 restart
     exit
     

    @@ -281,7 +316,7 @@ Point a web browser at your new machine coordinator. Congratulations!

    -
    +

    If things aren't working right

    If you've followed the steps above and the server doesn't start or you think