Install the CorneliOS Web OS




Documentation > Installation and Administration > Install the CorneliOS Web OS


CorneliOS can be download as Open Source software under the GPL, which means that you can use it for free.

Step 1 of 5: Download CorneliOS


First you'll have to get the CorneliOS software. Click onto the following link to download the latest CorneliOS sources from sourceforge.net:

http://sourceforge.net/projects/cornelios

Make sure you're downloading the latest release. The one installed on this server is CorneliOS 1.12r27 as of December 27, 2011, so you should use this one or even a newer one if available.

Step 2 of 5: Move the files to your server


After downloading the software and unzipping the ZIP file you should see the following files and directories:

CHANGELOG.txt
dev
DOCUMENTATION.txt
GFDL.txt
GPL.txt
INSTALL.txt
installer.pl
LICENSE.txt
README.txt
software.zip
TEST_REPORT.txt


The files required for the installation of the software are:

installer.pl
software.zip


You'll have to put both of them into the cgi-bin directory on your server. You may do so by a) using an FTP client or by b) sending them using SCP. If you have direct access to your server (or if you're installing the software onto your local Linux or MacOSX computer) you'll simply have to c) move the files into the correct location.

Option A: Upload using an FTP client

Use your FTP client to upload both files (installer.pl and software.zip) to the cgi-bin directory on your server. Make sure the security settings of both files are set to "755" once the files are on the server - most FTP clients offer an option to check and set these settings.

Option B: Upload using SCP

To use SCP you'll need SSH access on your server. Use the "scp" command to send the files to the server (replace "username" by your actual username and replace "/path/to/your/" by the actual path to your cgi-bin directory):

scp installer.pl username@example.com:/path/to/your/cgi-bin/
scp software.zip username@example.com:/path/to/your/cgi-bin/


Make sure that the security settings for both files are "755" on the server. You may check this by logging into your server using SSH:

ssh username@example.com
cd /path/to/your/cgi-bin/
ls -al


The server should now list the files in your cgi-bin directory, this should look more or less like this:

rwxr-xr-x 1 apache apache      6490 Sep 29 20:24 installer.pl
rwxr-xr-x 1 apache apache  36291251 Sep 29 20:25 software.zip


It is very important to make sure that the security settings are "rwxr-xr-x" for both files. If they are not, type the following:

chmod 755 installer.pl
chmod 755 software.zip


Option C: Move files to local directory

If you're installing the software on your local computer (Linux or MacOSX, this will NOT work on a Windows machine!), just move both files into your cgi-bin directory using your mouse, or move them using a terminal/shell:

cd /path/to/your/cornelios/package/
mv installer.pl /path/to/your/cgi-bin
mv software.zip /path/to/your/cgi-bin
cd /path/to/your/cgi-bin/
chmod 755 installer.pl
chmod 755 software.zip



Step 3 of 5: Run the installer


You may either run the installer in your web browser, or in your terminal/shell. In some cases you won't have access to a shell (on many hosted systems for example), here you'll have to use the web browser option.

Option A: Install using your web browser

Enter the following URL in your browser (replace www.example.com by your actual domain name or IP address):

http://www.example.com/cgi-bin/installer.pl

This will take some time - please be patient and do NOT reload the page!, It may take some time before your browser window displays the installation log. As soon as the page is loaded your software will be ready.

Option B: Install using a terminal/shell

If you have SSH access to your server (or if you're installing the software on your local machine) you may install the software using a terminal/shell. The advantage of this option is the fact that you'll get some live feedback and you can see what's being done:

ssh username@example.com (ignore this line if you're installing on your local computer)
cd /path/to/your/cgi-bin/
./installer.pl




Step 4 of 5: Test your installation


1. Enter the IP address or domain of your CorneliOS machine in your web browser:

http://www.example.com

You should now get a default welcome message, it has been generated by the CorneliOS website display engine (WDE). This is the CorneliOS demo site, its contents can be found in /var/www/demo. Note: we're talking about the CorneliOS /var directory (/path/to/your/site/var/), NOT your UNIX /var directory!). You may create your own site inside /var/www/main, or create even more sites inside /var/www .

If this does not work, try accessing the CorneliOS WDE using the direct URL:

http://www.example.com/cgi-bin/web.pl

2. You should be able to launch the CorneliOS application engine (CORA - should display a login window) in your browser by entering the following URL:

http://www.example.com/cgi-bin/cora.pl

3. You should be able to launch the desktop login window in your browser by entering the following URL:

http://www.example.com/cgi-bin/desktop.pl

Step 5 of 5: Change the root password


As soon as your software has been installed you may login as root user (aka superuser). The default root password after installing a new CorneliOS system is "root", therefore it is VERY IMPORTANT to instantly change this password now. Proceed to the basic setup page to learn how to change the root password.

Troubleshooting


  • If nothing is happening at all you probably have to take a look at your web server config.
  • If you're getting an "Internal Server Error" there may be something wrong with your web server setup. Check your httpd.conf (or whatever web server config file involved), make sure to chmod everything to 755, make sure all files can be read and written by the webserver, make sure SSI (Server Side Includes) support is enabled, Perl is installed (and more or less up to date), the CPAN CGI modules are there and so on... (if you don't understand these recommendations then this release is probably not for you :-).
  • If you're getting some kind of a "Software Error" you probably need to install some more CPAN modules. Check your Apache error log.
  • If you can't login, please check the access rights and make sure all directories can be written by Apache (/var/sessions for example).
  • If you can't resolve problems and you're stuck, you may still contact us (info@cornelios.org).




Working with CorneliOS


Installation and Administration


Develop with and for CorneliOS





(c)2006-2012 Joopita Research | Privacy Policy | Sitemap | Contact Us
FeaturesDownloadsDocumentationCommunityDonateShop