G-WAN Complete install process for Ubuntu 11.10 (both for the 32 and the 64 OS versions). G-WAN (Global Web Area Network) is both a web server (for static web pages) and a web application server (for rich dynamic web pages). However, one of its singularity, along the first one that is its exceptional performances vs. any other competitor, is to be able to use a lot of programming languages to create dynamic web pages to make Web2 sites, including all the compiled languages using the GCC collection such as ANSI C, C++, ADA, Cobol, D, Fortran, Modula 2/3 or Pascal, but also Objective C and Objective C++, as well as several scripting interpreted programming languages such as Go, Java, Javascript server-side, LUA or Python (via specific handlers), to allow Web developers to develop rich interactive Web2 sites with their programming language of choice! And the list above isn t finished since other useful and very used programming languages such as BASIC (using the excellent QB64 compiler) or PHP (via a multipurpose FastCGI handler) are in the way to be soon available for G-GAN. However, even if all these programming languages (current or future) may be used with G-WAN, its natural native language of choice is: ANSI C! Why? I m not here to compare the pros and cons of all these programming languages (even if I ve my own preference), but I just want to explain why the ANSI C programming language is the natural G-WAN s fit. The GCC ANSI C compiler is naturally installed with every single UNIX like distribution, whatever its release and both in the relevant 32 or 64 bit versions. Period! So, if you need to use G-WAN from scratch without installing any other package and using the best of its performances, you can do so in only four steps: - Download G-WAN from its website (~300 Kb) @ www.gwan.ch/download - Unpack G-WAN into a folder (usually into /opt/gwan_linux??-bit) where?? is 32 or 64 - Open a console and go to the directory where you ve unpacked G-WAN - Start G-WAN (./gwan). That s it! No more, no less (and my job terminates here LoL). However, if you need to allow G-WAN to use more than the 1024 TCP-IP simultaneous connections (the by default system limit), you ll have to start G-WAN using the following command line: sudo./gwan Meanwhile, launching G-WAN this way will link it to the terminal session from which it was started, and if you close this terminal session you will also stop G-WAN! Oops! So, if you need to start G-WAN independently of the terminal session (i.e. as an independent deamon that will allow you to close the terminal session while G-WAN still runs), please use the following command line: sudo./gwan d where the d parameter means deamon.
But now, let s go back to the different G-WAN s supported languages. When you download the G-WAN package, G-WAN comes with several real life small samples to help you understand how it can be used. However, even if most of these samples are pure ANSI C codes, some of them request external libraries (such as the Tokyocabinet), and some other samples using other programming languages than ANSI C (such as Objective C++ or Java) request to install different relevant parquets. The goal of this manual is not only to tell you what are these different parquets to install, but more importantly to show you (using screeshots) how to install them. So, this manual will now try to explain how to do so for Ubuntu 11.10. The complete list of the component required to play with all the G-WAN sample is: - g++ - libtokyocabinet-dev - libsqlite3.0 - gobjc++ - openjava-jdk - and sooner than later, both QB64 and PHP. If you just installed Ubuntu 11.10 (whatever 32 or 64 bit) on your computer, and want to install G-WAN and play with all its demo samples, how can you do that? First, if you just installed UBUNTU 11.10 from its CD, you have to update your fresh UBUNTU 11.10 install with a bunch of stuff using a bunch of command lines. But if you re a true Linux newbie (and don t understand anything to the command line), don t worry, I m not anymore a command line fan either (I m too old and both my 2 friends Alzheimer and Microsoft Windows helped me to forget how to use these old dogs - LoL). However, sometimes I m obliged to use some of them! So, be happy, my memory isn t totally out of order and I ll show you exactly what must be done with console screenshots if you re obliged to use a command line. I hope this document will help you.
If you just started UNBUNTU and have opened your user session, you should have a screen like this: The first thing to do after a fresh install is to update your system. To do so, click on the Update Manager icon.
This will open the following dialog: From here, click on the [Settings ] button.
This will open the following dialog: On the Update tab, select the Pre-released updates (oneiric-proposed) option. This will open the following new dialog: Enter your password and click on the [Authenticate] button.
Then on the Other Software tab, select the Canonical Partners option and click on the [Close] button.
Update the list of the Software to be modified by clicking on the [Check] button, then once the list of the package will be updated, click on the [Install Updates] button. Then enter your password and click on the [Authenticate] button.
Then, be patient! (LoL)! The time needed to download and install all the updates depends both on your Internet connection bandwidth and on your computer speed (CPU, RAM and Disks). On my test machine (AMD Athlon FX2-64 8 GB HDD Velociraptor 10.000 RPM) and with a 2 Mb Internet connection, the complete process to update Ubuntu 11.10 as described above needed approximately 45 minutes. Once the update process is complete, reboot your system.
Once you ve rebooted, open the Dash Home and click on the More Apps icon.
Then type the word synaptic into the Search Applications entry field.
Then, double click on the Synaptic Package Manager icon to install this software.
This will open the following dialog:
Then, select the three unselected Add-ons (Program that can find unusued packages, Debian Documentation Browser and Generates programs menu for all menu-aware applications) and click on the [Apply Changes] button. Enter your password and click on the [Authenticate] button.
Then click on the [Install] button.
Once the Synaptic Package Manager is installed, you can add it to the Launcher.
Then, start the Synaptic Package Manager by clicking on its icon. Enter your password and click on the [Authenticate] button.
The Synaptic Package Manager should look like this:
Enter the word libtokyo into the Quick filter entry field. This will show you the following selection:
Then, select the libtokyocabinet-dev package: In the following dialog, click on the [ Mark] button.
Then, click on the [ Apply] button of the following dialog.
Once the libtokyocabinet componants will be installed, the relevant package will show a green selection area.
Then enter the word libsqlite3 into the Quick filter entry field.
Select the libsqlite3-dev package and click on the [ Apply] button. Then validate your selection by clicking on the [Apply] button of the following dialog.
Once the libsqlite3-dev package will be installed, the relevant package will show a green selection area.
Then type le word g++ into the Quick filter entry field and select the g++ package. Confirm the additional required changes.
And install the required g++ components. Once the g++ components will be installed, the relevant packages will show a green selection area.
Then enter the word openjjk-6 into the Quick filter entry field and select the openjdk-6-jdk package. Accept the additional required changes.
And install these packages. Once the g++ components will be installed, the relevant packages will show a green selection area.
Finally, enter the word gobjc++ into the Quick filter entry field and select the gobjc++-4.6 package. Accept the additional required changes.
And install these packages. Once the Objective C:C++ components will be installed, the relevant packages will show a green selection area
Now, you re done with all the optional packages required by G-WAN to play with all its samples. Connect to the G-WAN web site @ www.gwan.ch and select the Download tab. Depending of your OS version (32 or 64 bit), download and save the relevant G-WAN package (32 or 64 bit).
Then, open the folder where you downloaded G-WAN by right clicking on the G-WAN file. This will open the following dialog.
Then double click on the G-WAN package. This will open the following dialog where you ve to right click on the G-WAN folder and select the Extract option from the pull-down menu.
Then, select the place where you want to install G-WAN (for this presentation, I put it on the desktop). Once the extraction is done, close the following dialog.
Close all the windows and reboot your system. Once you ve rebooted, open the Dash home and select the More Apps icon.
Start a Terminal session.
From the console, go to the directory where you installed G-WAN and launch it.
Yes, we re going to use a command line! Type: cd Desktop/gwan_linux??-bit &&./gwan where?? is 32 or 64 depending of the G-WAN version you installed. After few seconds, you should then receive the following answer form G-WAN.
Then start your browser at the following address: localhost:8080
Then you will access to the index.html page of your local G-WAN server.
Select the Server Report link. This page shows both the version of G-WAN (here the 3.3.7 32-bit) and the Ubuntu version (here 11.10 32 bit).
From the index page, select the loan link.
Then, compute this loan using the default ANSI C programming language. The result was done (on my old machine) in 0.06 ms.
Then, do the same computation, but using the Java scripted language. The result was done in 52.46 ms. (e.g. in 874 more times than the same computation done with the ANSI C language)! Choose your camp Camarade!
Now, in the address entry field, enter the following command : localhost:8080/?hello.mm This is a short sample using Objective C++. Now, you can also play with all the other samples that are located into the CSP folder. Have fun. ***************** This is the end (for today as of March 15, 2012) of this manual. I hope it may help some of you, especially if you re like me a true Newbie with Linux. Cheers.