SUNScholar/Install Ubuntu

From Libopedia
Revision as of 10:54, 15 August 2010 by Bibboek (talk | contribs) (1 revision)
Jump to navigation Jump to search
Please read about capacity planning before setting up a production repository system.



We use the LTS versions of Ubuntu for our servers. For more information about the Ubuntu 8.04 LTS server go to:

The server installation CD can be downloaded from:

Burn the above ISO image to a blank CD. Do not copy it as data, it MUST be burned as an ISO image !


This is debatable, but a fairly powerful machine with enough disk storage space using RAID to hold double your anticipated digital archives is recommended for future capacity.

Before Installation

Hostname selection

It is assumed you have decided on a hostname for your server. At the University of stellenbosch we chose For more information about our hostname selection, please read the web analytics wiki page. You can decide on something like: Discuss the hostname selection with your campus network administrator first before finalising on a name. Whatever you decide, it is very important that you do not change it later.


It is fairly easy to install the Ubuntu 8.04 LTS server software.

However we are also going to add additional components required for the DSpace installation.

Please take careful note of the installation screenshots ! 
Use the "TAB" key and arrow keys to move between items.
Use the "SPACE" key to select items.
Use the "ENTER" key to activate buttons.

Ubuntu 8.04 LTS Installation Screenshots





  • Language selection. Select "South Africa".


Keyboard setup. Select "No".




  • Hostname setup. Type in the hostname of the server.



  • Partition setup. Select manual.





  • Create "dspace" admin user. Enter full name.


  • Create "dspace" admin user. Enter username.


  • Create "dspace" admin user. Enter password.


  • Create "dspace" admin user. Confirm password.



  • Setup installation type. Select "LAMP", "OpenSSH" and "PostgreSQL" installation.


  • Setup installation type. The correct selection is displayed.


  • Select "Continue" and press "Enter" on the keyboard.


  • Setup "MySQL" root password.



After Installation

Hostname registration

You need to contact the campus network administrator and register your servers MAC address for TCP/IP hostname registration. To get your servers MAC address type the following in a terminal as the dspace or root user:

sudo ifconfig

Something like the following should scroll by:

dspace@ir2:~$ sudo ifconfig
[sudo] password for dspace: 
eth0      Link encap:Ethernet  HWaddr 00:0c:29:02:3e:00  
          inet addr:  Bcast:  Mask:
          inet6 addr: fe80::20c:29ff:fe02:3e00/64 Scope:Link
          RX packets:81959326 errors:23 dropped:0 overruns:0 frame:0
          TX packets:55609424 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000 
          RX bytes:3646385659 (3.3 GB)  TX bytes:1837131118 (1.7 GB)
          Interrupt:16 Base address:0x1424 

lo        Link encap:Local Loopback  
          inet addr:  Mask:
          inet6 addr: ::1/128 Scope:Host
          UP LOOPBACK RUNNING  MTU:16436  Metric:1
          RX packets:2843219 errors:0 dropped:0 overruns:0 frame:0
          TX packets:2843219 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:0 
          RX bytes:1171132031 (1.0 GB)  TX bytes:1171132031 (1.0 GB)

Take note of: HWaddr 00:0c:29:02:3e:00 from the third line above, this is the MAC address that your campus network administrator will need in order to register your server. Of course yours will be different to the one above. MAC address's are normally unique per network adapter per computer. There are two options for network setup namely, use a static IP address or use DHCP for assigning the IP address. Use the DHCP method for assigning the IP address and request the campus network administrator to do so. More information about networking can be found here:

Setup the software repositories

After you have correctly registered your servers TCP/IP hostname, then you can setup the software repositories. For more information about software repositories go to:

Step 1

On your client PC with the Ubuntu desktop live CD, click on: Applications => Accessories => Terminal to open a command line terminal.

Step 2

Login to your remote server as the "dspace" user by typing as follows in the terminal.

ssh dspace@%hostname%

Replace %hostname% with the hostname of your server.

Step 3

Type the following in a console/terminal/xterm to back up the original file:

sudo cp /etc/apt/sources.list /etc/apt/sources.list-backup

Type the following in a console/terminal/xterm to edit a new file:

sudo nano /etc/apt/sources.list

Tip: It is always a good idea to maximise the open nano window so that the copy and paste of long lines does not wrap around.

Step 4

Delete all of the existing contents in the /etc/apt/sources.list file using the CTL+K key repeatedly and then add the following using the copy and paste functions of "nano" and "firefox";

deb hardy main restricted universe multiverse
deb hardy-updates main restricted universe multiverse
deb hardy-security main restricted universe multiverse

Step 5

Save the file by typing CTL+O. Exit "nano" by typing CTL+X.

Step 6


sudo aptitude update

to update the repository list.

Step 7


sudo aptitude dist-upgrade

to upgrade to the latest software.

Next Procedure

Well done with the installation of your Ubuntu server !!

If everything is OK, then proceed to the setup of the server for the Dspace installation.