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).
|
 |
|