ontarioxo - home

<h1>Using the XO laptop</h1>
 <h2> </h2>
 <h2> </h2>
 These are my notes, but you might find <a class="wiki_link_ext" href="http://www.catmoran.com/olpc" rel="nofollow">these</a> better!<br />
<h2>Updating the build - e.g from 650 to 653</h2>
 <h3>Using olpc-update</h3>
 <br />

<pre class="text">    su -l<br/>    olpc-update -rv //build-number//</pre>
Use the tab key to get the xo to complete unambiguous commands or file names<br />
<br />
<h3>Using a complete install</h3>
 <br />
<ol><li>With the laptop off, insert the USB drive containing the two files fs.zip and os653.img in its top-level directory (assuming you want build 653).<ul><li>You can get them here:<ul><li><a class="wiki_link_ext" href="http://download.laptop.org/xo-1/os/official/653/jffs2/fs.zip" rel="nofollow" target="_blank">http://download.laptop.org/xo-1/os/official/653/jffs2/fs.zip</a></li><li><a class="wiki_link_ext" href="http://download.laptop.org/xo-1/os/official/653/jffs2/os653.img" rel="nofollow" target="_blank">http://download.laptop.org/xo-1/os/official/653/jffs2/os653.img</a></li></ul></li></ul></li><li>Power up the laptop while holding down the four gamepad buttons (X, O, Square, and Check). Release the buttons when the screen says to do so.</li><li>Watch while the screen shows the NAND being erased and rewritten, and the laptop reboots.</li></ol><br />
That's it. You should then be prompted for name and colors, with the laptop having about 70% free drive space.<br />
<br />
If this doesn't work, erase the USB drive and download the files again. They could be corrupt. Y<br />
<br />
<h1><img src="/i/anchor.gif" class="WikiAnchor" alt="Anchor" id="wikitext@@anchor@@S1-RPM-USING" title="Anchor: S1-RPM-USING"/></h1>
 RPM has five basic modes of operation (not counting package building): installing, uninstalling, upgrading, querying, and verifying. This section contains an overview of each mode. For complete details and options try <strong>rpm --help</strong>, or turn to <a class="wiki_link_ext" href="http://www.redhat.com/docs/manuals/linux/RHL-7-Manual/ref-guide/s1-rpm-other-resources.html" rel="nofollow">the section called //Other RPM Resources//</a> for more information on RPM.<br />
<h2><img src="/i/anchor.gif" class="WikiAnchor" alt="Anchor" id="wikitext@@anchor@@S2-RPM-INSTALLING" title="Anchor: S2-RPM-INSTALLING"/></h2>
 RPM packages typically have file names like <tt>foo-1.0-1.i386.rpm</tt>, which includes the package name (<tt>foo</tt>), version (<tt>1.0</tt>), release (<tt>1</tt>), and architecture (<tt>i386</tt>). Installing a package is as simple as:<br />

<pre class="text">rpm -ivh foo-1.0-1.i386.rpm<br/>foo</pre>
I have had to add --nodeps when trying to install a package that failed to work with yum<br />
<br />
<h2><a class="wiki_link_ext" href="http://wiki.laptop.org/go/Xfce" rel="nofollow">XFCE</a></h2>
 startxfce4<br />
<br />
<h3>Using external storage for programs</h3>
 <a class="wiki_link_ext" href="http://olpcnews.com/forum/index.php?topic=1600.0" rel="nofollow" target="_blank">http://olpcnews.com/forum/index.php?topic=1600.0</a><br />
This has some ideas <a class="wiki_link_ext" href="http://forum.eeeuser.com/viewtopic.php?id=7694&amp;p=1" rel="nofollow" target="_blank">http://forum.eeeuser.com/viewtopic.php?id=7694&amp;p=1</a> and some links to other ideas.<br />
<br />
<h3>Getting Frame not to appear instructions</h3>
 http://wiki.laptop.org/go/Ask_OLPC_a_Question_about_Software#How_to_disable_the_auto_Frame_appearance_when_mousing_into_hot_corners<br />
<br />
<h3><strong>Keyboard Shortcuts</strong></h3>
 <a class="wiki_link_ext" href="http://wiki.laptop.org/go/Keyboard_Shortcuts" rel="nofollow">Link to Keyboard Shortcuts</a><br />
<h2> </h2>
 <h2>Rsync</h2>
 From <a class="wiki_link_ext" href="http://www.linux.com/feature/117236" rel="nofollow" target="_blank">http://www.linux.com/feature/117236</a><br />
Making local copies<br />
Suppose you have an external USB or FireWire drive, and you want to copy data from your home directory to your external drive. A good way to do this would be to keep all your important data under a single top-level directory and then copy it to a backup directory on the external drive using a command like:<br />
rsync -avh /home/usr/dir/ /media/disk/backup/<br />
<br />
<h2>midnight commander</h2>
 *<br />
a more intuitive file manager<br />
<br />
<ul><li><strong>mc</strong> is a linux clone of the old Norton commander DOS program.</li></ul>&gt;<br />
&gt; Open the terminal activity and become root by typing: (-y answers &quot;Yes&quot; for you)<br />

<pre class="text">    su -l<br/>    yum -y install mc</pre>
<ul class="quotelist"><li>When the download and install is complete, exit root mode:</li></ul>&gt;<br />

<pre class="text">    exit</pre>
<br />
<ul class="quotelist"><li>You can then run midnight commander. Do not run <strong>mc</strong> from root mode unless you are sure of what you are doing!</li></ul>
<pre class="text">    mc</pre>
<h2>Getting online</h2>
 <a class="wiki_link_ext" href="http://wiki.laptop.org/go/WPA_Manual_Setting#Option_4:_Manual_Script" rel="nofollow" target="_blank">http://wiki.laptop.org/go/WPA_Manual_Setting#Option_4:_Manual_Script</a><br />
<br />
<h2>For projecting on a Windows machine</h2>
 Obtain UltraVNC – you will need the Viewer:<br />
http://www.uvnc.com/index.html<br />
You will also need the XO software: <a class="wiki_link_ext" href="http://wiki.laptop.org/go/VNC_Launcher" rel="nofollow" target="_blank">http://wiki.laptop.org/go/VNC_Launcher</a><br />
There are two versions for corresponding OS on the XO<br />
You could read more about the process under this title: <a class="wiki_link_ext" href="http://wiki.laptop.org/go/Remote_display" rel="nofollow" target="_blank">Cloning a current Sugar session (using VNC)</a> but essentially you run the VNC software on the XO then run the viewer on the PC, key<br />
in the IP address that is shown on the XO at the top of the verbose text and bingo! The mouse on the PC<br />
seems to do most things except make the frame appear by running into the corners.<br />
<img src="/i/anchor.gif" class="WikiAnchor" alt="Anchor" id="wikitext@@anchor@@boa" title="Anchor: boa"/><br />
<h2>boa (Web Server)</h2>
 To install:<br />

<pre class="text">    su -l<br/>    yum -y install boa</pre>
<br />
To run:<br />

<pre class="text">    cd /var/log<br/>    mkdir boa<br/>    /usr/sbin/boa</pre>
<br />
To find out what the IP is:<br />

<pre class="text">    ifconfig</pre>
Look next to eth0 for 192.168.whatever (for example).<br />
The configuration file is in /etc/boa if, for instance you want to change where your content lives. The default is in /var/www/boa/html, which is where the web pages to be served need to be.<br />
<br />
To access the files from another computer on the network simply enter the address <a class="wiki_link_ext" href="http://192.168.whatever/" rel="nofollow">http://192.168.whatever</a>.<br />
<br />
<h2>mplayer</h2>
 <br />
Installed using the instructions at <a class="wiki_link_ext" href="http://thepete.com/xo/index.php" rel="nofollow">thepete.com</a> .<br />
Run using<br />
Put your media files (avi, mp4, mov, mp3, etc) on an SD card or USB stick and in Terminal enter:<br />
<em>./mplayer -fs /media/SD/video.avi</em> (This assumes your SD card's name is &quot;SD&quot;.)<br />
good thread at http://olpcnews.com/forum/index.php?topic=863.0<br />
and at http://olpcnews.com/forum/index.php?topic=2067.msg16182#msg16182<br />
<h2>vlc</h2>
 <br />
http://www.olpcnews.com/forum/index.php?topic=685.msg5294;topicseen<br />
May need to download key from http://www.videolan.org/vlc/download-fedora.html<br />
<h2>openoffice</h2>
 <ul><li>/usr/lib</li></ul>
<pre class="text">     yum -y install openoffice.org-writer<br/>     yum -y install openoffice.org-calc<br/>     yum -y install openoffice.org-draw openoffice.org-impress</pre>
or use the download and instructions at http://download.openoffice.org/common/instructions.html or better ones at http://documentation.openoffice.org/setup_guide2/2.x/en/SETUP_GUIDE.pdf<br />
<h2>skype</h2>
 <br />
<h2>firefox</h2>
 <ul><li>/usr/lib</li><li>installing firefox requires that you remove its exclusion from the XO's repository list</li></ul>
<pre class="text">    nano /etc/yum.repos.d/olpc-koji-ship2.repo<br/>    yum install firefox</pre>
some good notes about the built in browser http://bilug.org/2008/01/15/xo-fixing-browser-flash-performance/<br />
<h3> </h3>
 <h3>Firefox Plugins Page</h3>
 https://addons.mozilla.org/en-US/firefox/browse/type:7<br />
<h2>flash-plugin</h2>
 http://wiki.laptop.org/go/Adobe_Flash<br />
<br />

<pre class="text">    su -l<br/>    wget http://fpdownload.macromedia.com/get/flashplayer/current/flash-plugin-9.0.48.0-release.i386.rpm<br/>    rpm -i flash-plugin-9.0.48.0-release.i386.rpm<br/>    exit</pre>
<h2>Java Plug-in</h2>
 <h3><img src="/i/anchor.gif" class="WikiAnchor" alt="Anchor" id="wikitext@@anchor@@Linux" title="Anchor: Linux"/></h3>
 On Linux, Mozilla <strong>requires</strong> JRE 1.4.2 or later.<br />
Mozilla 1.4 and later, and Mozilla Firefox, are compiled with gcc 3.x. A gcc 3.x compatible version of the Java plugin must be used. JRE 1.4.2 and later contain a compatible plugin.<br />
If you installed the Java Runtime Environment 5.0 Update 9, this plugin is /usr/java/jre1.5.0_09/plugin/i386/ns7/libjavaplugin_oji.so - and to install it for Mozilla (including Mozilla Firefox), do the following:<br />
<ul><li>Open a terminal</li><li>Change to your Mozilla (or Mozilla Firefox) plugins directory (maybe /usr/lib/firefox-2.0.0.8/plugins)</li><li>Issue the following command: ln -s /usr/java/jre1.5.0_09/plugin/i386/ns7/libjavaplugin_oji.so ./libjavaplugin_oji.s<ul><li>or ln -s /usr/java/jrel.6.0_03/plugin/i386/ns7/libjavaplugin_oji.so</li></ul></li></ul><img src="http://plugindoc.mozdev.org/images/important.gif" alt="Important!" title="Important!" /> If you install your JRE in a different way (self extracting package, debian package, etc), libjavaplugin_oji.so will quite likely be in a different location. Do not just blindly use the command listed above!<br />
<img src="http://plugindoc.mozdev.org/images/faq.png" alt="Note:" title="Note:" /> In JRE 1.4.2, this file was in plugin/i386/ns610-gcc32<br />
<img src="http://plugindoc.mozdev.org/images/important.gif" alt="Important!" title="Important!" /> Always make a <strong>symbolic link</strong>, as shown above, instead of copying the plugin. If you copy the plugin, your browser will crash every time you open a page containing a Java applet. You have been warned!<br />
If you are using an older Linux distribution, you may need to install the gcc3 support libraries, as the gcc 3.2 version of the Java plugin requires libgcc_s.so.1 to operate. You may be able to find packages using <a class="wiki_link_ext" href="http://www.google.com/" rel="nofollow">Google</a>.<br />
If you are using an old or unofficial build of Mozilla (1.4a or later) or Mozilla Firefox, you can check which compiler was used by entering about:buildconfig in the location bar and pressing enter. You will see a line such as &quot;gcc version 3.3.2&quot;, which will show the compiler that was used. If gcc2.9x was used, you need to use the ns7-gcc29 or ns610 plugin, not the ns7 or ns610-gcc32 plugin.<br />
<br />
<h3>For a collection of card solitaire games:</h3>
 <br />
To install:<br />
Open terminal activity and type:<br />
su -<br />
yum install PySolFC<br />
logout<br />
<br />
To run solitaire game, go to terminal activity and type:<br />
pysol<br />
<br />
<h2>glchess</h2>
 <br />
<h2>gis geometry</h2>
 <br />
<h2>feh</h2>
 http://linuxbrit.co.uk/feh/<br />
To turn your XO into a photo frame you need to down load and install a program called feh.<br />
<br />
go to the sugar terminal, use the terminal icon, and type: (hit enter at the end of each line)<br />

<pre class="text">su - [this puts you at the root so you can do a yum install]<br/>yum install feh [Answer &quot;y&quot; when prompted to install the program.]<br/>exit [this returns you to the sugar terminal you started with]</pre>
To use feh:<br />
Put your jpg files on a SD card or a flash drive and plug it into the XO.<br />
Go to the sugar terminal, use the terminal icon.<br />
Type the following at the sugar terminal:<br />

<pre class="text">feh -F -D 5 --scale-down /media/SD/<br/>[this assumes your SD card is named SD. use the name of your SD card or your USB drive in place of SD]</pre>
<br />
-F plays full screen, you need this or small pictures will be copied several times on the screen.<br />
<br />
-D plays the slide show with the number, in this case 5, being the number of seconds to wait between slides.<br />
<br />
Q will quit [it may take a picture or two to quit. CTRL+q will also quit]<br />
<br />
For more information type feh --help for the help file.<br />
<br />
<h2>EPUB files</h2>
 http://justwriteclick.com/2008/01/20/how-to-download-and-copy-epub-files-using-the-xo-laptop/<br />
<br />
<h3>Audacity</h3>
 type &quot;su&quot; (without quotation marks).<br />
<br />
Then type &quot;yum install audacity&quot; (without quotes).<br />
<br />
<h2>Random YUM Ideas from http://blogs.fruxant.com/sebas/sebas.php</h2>
 IMPORTANT FOR BEGGINERS<br />
Before continue this tutorial, you need to knowledge of SSH or you may ruin your server.<br />
If you need installation support, better order this service from us, we will do this job for you for only 100USD.<br />
We will need to get from you SSH access with root access.<br />
ORDER LINK<br />
So login with SSH and enter as root.<br />
1. Verify if YUM is installed. If yes I will proceed to edit /etc/yum.conf. If not, I will install from RPM. In order to use yum, you first need to add a few lines in /etc/yum.conf from page, browsing right OS. http://3es.atomicrocketturtle.com/ YUM is installed in latest FEDORA by default.<br />
2. Edit /etc/yum.conf to be like this, but in time it can change. Always use only your version PSA channel.<br />
Automatic configuration<br />
Using Lynx (yum -y install lynx):<br />
lynx -source http://3es.atomicrocketturtle.com/installers/atomic.sh | sh<br />
Using Wget:<br />
wget http://3es.atomicrocketturtle.com/installers/atomic.sh<br />
sh ./atomic.sh<br />
3. Install some useful tools like, JOE - text editor, Midnight Commander and LYNX text based navigator.<br />
shell: yum install joe mc lynx<br />
4. Also we do an update of packages for yum with, to be up to date.<br />
shell: yum update<br />
5. In PLESK create a domain, usually each of us have a default domain, and this domain users we change to have access with SSH. Is important to create this user (domain) and not go forward to change root access. Of course you can create later as well, just if you disable root, you cannot access server with SSH.<br />
Next I change the root password as well, from default value.<br />
shell: passwd root (same, will ask for password) - WRITE this down somewhere, in your notes.<br />
After this, I follow the description from http://www.crucialparadigm.com/resources/tutorials/secure-server-securing/disable-direct-root-login.php or later, the ELS installer will do this.<br />
6. Now edit some files to be easier to navigate in SSH, like:<br />
shell: joe /etc/bashrc<br />
and add these lines. This will help not to write all the times cd /home/http/vhosts/ just execute phttpd and you are already there. You may create your own rules of course.<br />
alias bye=&quot;exit&quot;<br />
alias ns=&quot;netstat -lpn&quot;<br />
alias pmysql=&quot;cd /var/lib/mysql&quot;<br />
alias phttpd=&quot;cd /var/www/vhosts&quot;<br />
This last is for when apache dies and semaphore is not cleared and apache will not restart. Just you enter killhttpd and then start apache.<br />
Edit<br />
shell: joe /root/.bashrc<br />
and add a line like:<br />
echo 'ALERT - Root Shell Access (YOURSERVERNAME) on:' `date` `who` | mail -s &quot;Alert: Root Access from `who | cut -d&quot;(&quot; -f2 | cut -d&quot;)&quot; -f1`&quot; YOUREMAIL<br />
This will help to know each time when someone logged in as root, which is theoretically only you, the ELS installer will do this.<br />
You will get on root login a mail to your mail address with subject ALERT - Root Shell Access (YOURSERVERNAME) on:, from which IP is entered and so on.<br />
YOURSERVERNAME and YOUREMAIL must be changed with your data.<br />
7. Because YUM update installed MySQL 4, change also my.cnf and update tables to MySQL 4 compatible. In latest distros, there is already MySQL 5.<br />
shell: /usr/bin/mysql_fix_privilege_tables --user=admin --password=`cat /etc/psa/.psa.shadow`<br />
shell: joe /etc/my.cnf<br />
<br />
<br />
<h2>Sonata</h2>
 Development is internal and not hosted.<br />
<img src="/i/anchor.gif" class="WikiAnchor" alt="Anchor" id="wikitext@@anchor@@Bundles" title="Anchor: Bundles"/><br />
<h3>[<a class="wiki_link_ext" href="http://wiki.laptop.org/index.php?title=Sonata&amp;action=edit&amp;section=9" rel="nofollow">edit</a>] Bundles</h3>
 <a class="wiki_link_ext" href="http://ywwg.com/olpc/sonata-11.xo" rel="nofollow">sonata-11.xo</a> is known to work with build 542. http://wiki.laptop.org/images/7/7b/Sonata-11.xo works on 653 build.<br />
<img src="/i/anchor.gif" class="WikiAnchor" alt="Anchor" id="wikitext@@anchor@@Functional_Test" title="Anchor: Functional_Test"/><br />
<h2>[<a class="wiki_link_ext" href="http://wiki.laptop.org/index.php?title=Sonata&amp;action=edit&amp;section=10" rel="nofollow">edit</a>] Functional Test</h2>
 Open the Sonata Activity.<br />
Right click and select properties. Ensure connection to mpd server.<br />
Place ogg or other files in ~/.mpd/Music<br />
Since space is limited on the XO internal storage if your goal is to play audio files from local source it may be helpful to create a symbolic link to the actual files located on an external device, such as an SD card or USB drive. This will save space on the XO's internal storage.<br />

<pre class="text">ln -s /media/path/to/your/device /home/olpc/.mpd/Music/what_ever_you want_to_call_your_link<br/>for example:<br/>ln -s /media/disk/misc/ /home/olpc/.mpd/Music/misc<br/></pre>
See http://olpcnews.com/forum/index.php?topic=587.msg16206#msg16206