Compiling from 710 sources

2008-07-25T14:59:46Z

Guigolum: /* packages */

this is just an how-to about compiling for the 710 version.

==when to?==
when you want to compile for the 710 version. you may compile with other sources but..well, you may not too.<br /<
this is mor or less a memanto for myself, since i am compiling from 710

==requirements==
i am filling it when i see new requirements
you must be connected on your development station. you need an acces to a 710 working station. 

===packages===
install them with apt-get:
sudo apt-get install -y asterisk-dev squashfs-tools libavcodec-dev libavformat-dev libpostproc-dev libcaca-dev libmodplug-dev libtheora-dev libgnomevfs2-dev libflac-dev libsmbclient-dev libmad0-dev libcdio-dev transfig sgmltools-lite automake nasm x-dev libsvga1-dev dmsetup mkisofs libxcb-xv0-dev libxcb-shm0-dev libxcb-shape0-dev libaa1-dev libmagick9-dev libdirectfb-dev libpulse-dev libmpcdec-dev kdelibs4-dev qt3-qtconfig qt3-linguist qt3-dev-tools-embedded qt3-dev-tools-compat qt3-dev-tools qt3-designer qt3-assistant qt3-apps-dev libqt3-mt-dev libqt3-headers libqt3-compat-headers xorg-dev qt3-dev-tools libxcb-xv0-dev libxcb-shm0-dev libxcb-shape0-dev libmagick9-dev libmpcdec-dev quilt tcl8.4-dev libfuse-dev fuse-utils libupnp-dev libconfuse-dev subversion build-essential dh-make libmysqlclient15-dev libattr1-dev libdbus-1-dev libdbus-glib-1-dev libhal-dev libdancer-xml0-dev libbluetooth2-dev libid3-3.8.3-dev libxine-dev x11proto-core-dev libx11-dev libx11-dev x11proto-core-dev x11proto-xext-dev x11proto-xf86vidmode-dev libx11-dev libjpeg62-dev libcdparanoia0-dev libsdl1.2-dev libsdl-gfx1.2-dev libxmu-headers x11proto-record-dev libhid-dev libusb-dev libsdl-image1.2-dev libsdl-ttf2.0-dev libsdl-sge-dev libxtst-dev libxrender-dev libcddb-dev libdvdread-dev libcurl3-dev ruby1.8-dev swig libtcltk-ruby mysql-client mysql-server libmediastreamer0-dev libgtk2.0-dev libvte-dev libglade2-dev libstdc++5 liblircclient-dev fakeroot
this will take some time..

===sources===
when you are in the folder you want the sources to be into, type
svn co svn.linuxmce.org/pluto/branches/LinuxMCE-0710/
this is gonna take a while..

==preparation==
copy every file from /usr/pluto/lib from you working station to your dev station in <srcpath>/src/lib. basically, if you're compiling on your core, and you placed yourself in your sources dir, just type
cp /usr/pluto/lib/* src/lib/
then launch the command for removing the makefile args:
find . -iname Makefile -exec sed -e 's/<-mkr_t_compile_defines->/-DKDE_LMCE -DDEBUG -DTHREAD_LOG -DLOG_ALL_QUERIES -I\/opt\/libxine1-pluto\/include -I\/opt\/libsdl1.2-1.2.7+1.2.8cvs20041007\/include -I\/opt\/libsdl1.2-1.2.7+1.2.8cvs20041007\/include\/SD/' -i '{}' \;
find . -iname Makefile -exec sed -e 's/<-mkr_t_compile_libs->/-L\/opt\/libxine1-pluto\/lib -L\/opt\/libsdl1.2-1.2.7+1.2.8cvs20041007\/lib/' -i '{}' \;
finally launch ''make'' from the src/ directory

===troubles===
if you have an issue with the file File_Grids_Plugin.cpp open it(kate src/File_Grids_Plugin/File_Grids_Plugins.cpp) and replace the line 450:
false, /* resume */, 0 /* repeat */,
false, /* bypass events */
false /* dont setup av */);
by
false, 0);

if you have an error:
make: *** Mozilla_Plugin: No such file or directory. Stop.
open src/makefile and remove "Mozilla_Plugin" at line 5

if you have an error with ''Security_Plugin.cpp'' , then open it( src/Security_Plugin/Security_Plugin.cpp ) and remove the
,true, true
at the nearby end of the line

with ''Telecom_Plugin.cpp'' you have to edit src/Telecom_Plugin/Telecom_Plugin.cpp:
l2670: remove false, false at the end of the line
l2702: remove false, false at the end of the line

Compiling from 710 sources

2008-07-25T14:52:13Z

Setting Up A Development Environment

2008-07-21T13:01:17Z

Guigolum: /* Setting Up the Development Environment */

[[Category: Tutorials]]
[[Category: Development]]

== Introduction ==

See also: [[Building From Source]]

I have seen a lot of questions on how to set up a development environment for LMCE.
As a person with limited programming experience in c++, I can tell you that you don't have to be a master-level programmer to get your feet wet
and examine the source code, and even make changes that add new features or fix existing bugs. It just takes a little patience, some help from experienced members,
and a willingness to learn. There is a lot of information and help available in the forums, the wiki, and the linuxmce channel on IRC freenode servers.

That being said, dev work can also be risky business. You can seriously damage your installation compiling and testing changes, so '''USE THIS INFORMATION AT YOUR OWN RISK!'''
If you really want to get started developing, the best advice I can give is to get a separate computer to set up as a development machine, so you don't damage your existing LinuxMCE installation accidentally! That way, if you make a change that LMCE really doesn't like, you won't trash your personally installation. (Too bad I don't follow my own advice, as I've done this before!)

----
''The following tutorial represents my experiences only, and may not necessarily be the best or correct way to do things - though it has worked very well for me.''

As I am a linux user, I am going to describe this process as I set up a development environment on my core from a computer running Ubuntu linux. Other linux variants will be very similar, if not the same. For Windows users, there is equivalent software that you can use, though I can't name any off of the top of my head - you will have to do your own research on that one.

Be sure to set aside a free evening to set up your development environment, as it can take several hours to complete!
----

== Preface ==
The first thing I found surprising when I went to set up my first development environment is that it must be set up on your core. To my knowledge, you can't just make changes to the source on your desktop computer, compile them on your desktop computer, then upload them to the core. Everything must reside on the core, and you can have access to the source on your normal desktop over SSH (covered later). For those that aren't keen with working with a command line over ssh, this will take some getting used to (as was my case). But, once you get used to it, its not a bad development environment, and it even got me more familiar with the command line, and linux commands, which is something I've been meaning to do anyways.
Lets get started...

== Setting Up the Development Environment ==
Once you have a LinuxMCE Core up and running, the first thing we have to do is learn how to connect to it from our Desktop computer. On my Ubuntu desktop, I open a terminal via Applications->Accessories->Terminal.
We will now use SSH to connect to out core - enter the following into the terminal:
ssh linuxmce@192.168.80.1
When prompted for a password, enter "linuxmce".
''(You may be prompted for a password several times during the setup of your development environment - this will always be "linuxmce")''

Congratulations! You are now logged into the core over SSH from a remote computer! Now its time to install some packages needed for development. In the terminal, type:
sudo apt-get install subversion build-essential ccache
This will install Subversion (SVN), which is needed to keep your local copy of the source code in sync with the latest changes, and well as some development libraries.

For my development environment, I decided to keep everything in my Home directory. The source can actually go many places, but I prefer using the Home directory. Lets go there now...
cd ~/

At this time, the source code is located in the Charon-Merge branch (though it is supposed to be eventually a full merge with pluto). To check out the most recent source code, run the following:
svn co http://svn.linuxmce.org/pluto/branches/charon-merge

And finally, lets do a compile. This is necessary to setup more development packages, populate the source code with make files, etc. (Don't worry, this won't alter your current installation!)
cd charon-merge
./configure
make

It may be required to run "make clean" if the sources have yet been compiled, since it installs required packages ont your computer

Now go take a break. This part may take a while!

'''GREAT!''' You now have the most recent version of the source code available to you and you will be able to compile changes! You can run svn update at any time from within the charon-merge directory to get the latest changes that have been committed to SVN.

Now that this is finished, you are now ready to compile changes in the source code, then copy the resulting file to the appropriate place in the core.

----
'''A quick example'''

Since I am familiar with the CM11A source, I will use it as an example...
First i cd into the CM11A directory
cd ~/lmce/src/CM11A
Next I make changes to devicepoll.cpp..
Now I want to compile my changes.. But first I have found it good practice to delete any old object files etc. before compiling, so I usually run
rm *.o
rm CM11A
This removes the last resulting CM11A binary if present, as well as the object files that might be present from my last compile.
Next I compile the changes..
make bin
Once it is finished compiling, I have a new CM11A binary that just needs moved to the right place in the core.. In this instance it is /usr/pluto/bin/ (/usr/pluto/lib/ is another hot-spot to check, usually for .so files)
First, I remove the original file that I will be replacing..
sudo rm /usr/pluto/bin/CM11A
then I copy my newly compiled binary over..
sudo cp CM11A /usr/pluto/bin/CM11A
Now with a "quick reload router" from one of my orbiters, my changes will be in effect!

A quick note - if "make bin" does not work, you may need to run "make so" for some sources that end up being library files, and yet others require just "make". I'm not sure if there is a golden rule to all of this, but I just try each of them until one of them works. Then, for the most part, you can search /usr/pluto/bin and /usr/pluto/lib to see where the resulting compiled file should go.
Also, I have noticed that a "Full reload router" is necessary if you replace a library file (*.so)

== Helpful Tools and Hints ==

'''Compiling changes and where to put them on the core'''

As stated above, I am not sure if there is a golden rule to this, but depending on what you are trying to compile, you will have to use one of the following:
make
make bin
make so
If you try one and get an error, try another one (i'm sure there is a better approach to this!)
For the most part, you should be able to search through /usr/pluto/bin and /usr/pluto/lib to see where the resulting file should go.

'''Using VNC to remotely view the on-screen orbiter'''

As an Ubuntu user, I will explain it from how I do it from Ubuntu.

First, ssh to the core, and install VNC
ssh linuxmce@192.168.80.1
Now lets install VNC
sudo apt-get install x11vnc
Ok, once it is installed, run the VNC Server from the core
x11vnc

Now that you have a VNC server running on the core, lets start the client on our Ubuntu desktop:
First, open another terminal on your desktop
now run the following command (in the new terminal, not the terminal that is SSH'd into the core!)
vncviewer 192.168.80.1:0

Now you can take professional developer-grade screenshots of our on-screen orbiters!
(There are other tools available to take full recorded screencasts of these VNC sessions, but I've never used one)
Also note, that the VNC playback is not at full framerate - this is normal.

'''Navigating the core remotely with GUI'''

Unless you like editing source code in a terminal with vim, you will want to make things easier on yourself, and set things up so you can graphically browse the directory tree on the core, and edit source code files with gedit or a similar editor...
In ubuntu, go to Places->Connect To Server
A "Connect Tto Server" window will appear. Fill it out as follows:
Service Type - SSH
Server - 192.168.80.1
Port - 22
Folder - /
User Name - linuxmce
Name to use for connection - <anything you want> (I use Access Core Files)

You will now have a network folder on your desktop that you can access files with - without having to use the command line. (the first time you will be prompted for a password, which of course is 'linuxmce'. Double clicking files will now open them in your preferred desktop editor!

'''SSH-ing into a Media Director'''

I'm sure there is a better way, but here is what I do:

1)ssh into the core
ssh linuxmce@192.168.80.1
..enter password 'linuxmce'

2) navigate to /usr/pluto/diskless
cd /usr/pluto/diskless

3) get the "moon numbers" of the media directors
ls
note that each media director has a unique 3-digit number.. you will need this number in the following steps..

4) change over to the root user:
sudo su
...enter password 'linuxmce'

5) ssh into one of the media directors
ssh moonxxx
(xxx is the 3-digit number of one of the media directors)

You are now in the Media Director's file system, be careful, as you are root!

'''Installing phpMyAdmin to examine database structure etc.'''
phpMyAdmin is a graphical (web based) mysql front end that makes looking through the vast LMCE databases effortless. While I would never recommend adding or removing anything directly to the database this way, having a view of the database structure and the ability to easily browse through the tables really helps to understand LMCE and how it works much better. It also makes for a good reference when you are looking for primary keys that are so popular as device data. Now you can look up all of your options.

First, lets ssh into the core
ssh linuxmce@192.168.80.1
(use password linuxmce)

Now lets switch to the directory where the admin web pages are stored
cd /var/www/

...and download the tarball
sudo wget http://internap.dl.sourceforge.net/sourceforge/phpmyadmin/phpMyAdmin-2.11.7-rc1-english.tar.gz

Once the tarball is finished downloading, its time to extract it
sudo tar -xzvf phpMyAdmin-2.11.7-rc1-english.tar.gz

You will now notice that if you list the directory contents (with ls), that you have a new phpMyAdmin-2.11.7-rc1-english directory. Thats fine, but who wants to type that in their web browser when they want to use phpMyAdmin. Lets rename it to something easier
sudo mv phpMyAdmin-2.11.7-rc1-english phpmyadmin

thats it! Now you can check out the database and learn from it. Again, be careful, as you can really, truely screw things up internally if you go adding and deleting entries.
To go to phpMyAdmin, in your web browser, just type 192.168.80.1/phpmyadmin