Abqorian Planet

It's been a while since my last post. This time I'd like to share my experience about installing Player/Stage on PCLinuxOS. So, how to install Player/Stage on PCLinuxOS?

First of all, some of you might wondering what Player/Stage is. Player/Stage is a software released under GNU GPL license to support development in robotic research. It was from a project formerly known as Player Project founded by Brian Gerkey, Richard Vaughan and Andrew Howard.

For more information about Player/Stage, visit its project website at SourceForge. If you are installing Player/Stage on OpenSuSE go to this post. Let's get to the main topic, "How to install Player/Stage on PCLinuxOS?"

The first thing you need to do is to install the dependencies for Player/Stage. To do this, make sure you already have the latest link on your repositories and you are connected to internet. Click here to read on how to update your repository on PCLinuxOS.

After updating your repository, type these words on Synaptic's search box. These packages are compulsory for installing Player/Stage. fortran, libconfig, libtool, pkg-config, gtk, sed, cmake, geos, statgrab, swig, gnomecanvas, imagemagick, glut, libltdl and gsl.

For a more general packages for solving dependency issue before installing Player/Stage, read my post about General Requirement for Player/Stage.

After installing those dependency packages, you'll have to install Player first before installing Stage. Although Player was available in PCLinuxOS repository, from my experience it's best to build the application from source.

Installing Player
If you decide to install Player from the repository, you'll get difficulty to run the code you made. I still don't know why, but I guess it has something to do with the library linkages.

If you build Player from the source, you could define the library linkages and the directory to which Player will be installed. By the way, PCLinuxOS didn't provide Stage in its repository.

To install Player, it's best to switch to superuser account. Since by default,  player will be installed in /usr/local/. Although it's not really necessary. The first step is to download the source and extract it to your local directory (I'll assume you know how to extract an archive in Linux). Note that this guide uses Player version 2.1.2 although the latest version available on its website is 3.0.0. And instead of installing it in the default location, it'll be installed in user directory (/home/$USER/playerstage).

cd ~/player-<version>
make uninstall
make clean
./configure --prefix=/home/$USER/playerstage

In my case, I put extra options. I enabled lasertoranger and sonartoranger and disabled vec2map. Hence, my code becomes:

/configure --prefix=/home/$USER/playerstage --enable-lasertoranger --enable-sonartoranger --disable-vec2map
make
make install

The next step is to add the Player's executables and libraries path to system path. Type these lines in terminal (or konsole):

export PATH=$PATH:/home/$USER/playerstage/bin/
export PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/home/$USER/playerstage/lib/pkgconfig
export PLAYERPATH=$PLAYERPATH:/home/$USER/playerstage/share/stage/worlds:/home/$USER/playerstage/lib/
export LD_LIBRARY_PATH="$LD_LIBRARY_PATH:/home/$USER/playerstage/include:/home/$USER/playerstage/lib:/home/$USER/playerstage/share/player/examples/plugins/logplugin

Or you can manually add them to the your local profile file by editing these files: .bashrc or .bash_profile.
Next step is to add these lines into /etc/ld.so.conf.

/home/$USER/playerstage/lib/
/usr/local/lib

The last step is to test this installation configuration by typing this line in terminal.

pkg-config --libs playercore

It should return something like this, (might be different depending on your machine)

-L/home/$USER/playerstage/lib -lplayercore -lltdl -lpthread -lplayererror

And this line again:

pkg-config --cflags playercore

Again, it should return something like this, (might also be different)

-I/home/$USER/playerstage/include/player-2.1

If your machine return something like those, then you could try to run the application:

player ~/playerstage/share/stage/worlds/simple.cfg &

If it run well, then the installation is complete.

Installing Stage
The installation for Stage is almost the same as installing Player.

cd ~/stage-<version>
make uninstall
make clean
./configure --prefix=/home/$USER/playerstage
sudo make
sudo make install
pkg-config --libs stage
pkg-config --cflags stage

I summarized all steps above and upload it to my Google Docs, you can read the file too. If you notice that there is the word "OpenCV" in that file, just ignore it if you don't need to install it.

OpenCV is a computer vision library for researches having image manipulation/processing. If your robot involves such sensor behavior, then you'll need to install this library.

I hope this guide is useful. Inform me if you have any thing to say.

It's been quite easy and simple to add an application onto Linux distribution these days. Since most of Linux distribution has what they call repository to provide support for its distribution. It's even more easier with the graphical package manager included in its distribution.

Some of them even have mirrored their repository to local website on certain region. And some of them provide a limited repository during their distribution release in a form of DVD or extra CD companion.

In this post, I'd like to share my experience on updating repository in PCLinuxOS. Let's get started step-by-step.

1. Make sure you are connected to the internet before going on to the next step. Otherwise, it won't work.
   
2. Open your Synaptics package manager. Click KMenu (or press Windows logo on your keyboard), point to System, Configuration, Packaging, then click on Synaptics Package Manager.
   
   
   
   
   
   
   
   
   
3. Type in your root password. I'll assume you're the administrator on your Linux machine.
4. After the Synaptic window popped out, click Settings on the menu bar, then click Repositories.

5. Another window will pop up showing you the list of repository mirrors available. Check on the box to enable it. Make sure it is the site closest enough to your local region.
6. A little note. Do not remove the link on the last list, since it is for openoffice related packages.
7. When you finish, click OK to close the window.
8. Then on the main window, click Reload to get any changes you made loaded. Synaptic will download the package lists from the site you've checked before. it might takes several minutes depending on your internet speed.

That's all you need to do. You can install an application as usual, with the latest version of course. :)

There are always several packages required before installing an application on Linux operating system or at least, one. Since an application in Linux environment almost always never embed the dependency packages required upon its release. Take for example, installing Player/Stage. Visit this website for more information about Player/Stage.

Depending on the distribution, each Linux distribution require different packages installed before installing the same application.

I've been wandering the internet to solve the dependency issues while installing Player/Stage on my Linux machine. I've tried installing in onto Mandriva 2008 and 2009, OpenSuSE 9.3 and 10.0, and lastly onto PCLinuxOS.

I couldn't install Player/Stage on Ubuntu, since my machine cannot boot Debian-based Linux distribution. Although, most of the information available on the internet are about installing Player/Stage on Ubuntu.

Hence, I thought I need to write a more general information regarding requirements before installing Player/Stage, regardless of the distribution.
Once again, depending on your distribution, the name of the packages might differ.

gcc42-fortran, gcc-fortran, libgfortran42 (or g77 or any fortran compiler)
gcc, g++
opencv
libusb, -devel
libconfig (install the most recent version)
imagemagick, -devel, (or libmagick10, libmagick++10, libmagick10-devel)
libopenssl, -devel, openssl, -certs
libjpeg, -devel, libpng, -devel, libjasper, -devel, zlib, -devel, libtiff, -devel
libdc1394, -devel, libraw1394, -devel
sed
gsl
libtool (or libltdl3, -devel)
boost, -devel (might be one of these:
    libboost-dev
    libboost-thread1.33.1
    libboost-thread-dev
    libboost-signals1.33.1
    libboost-signals-dev)
swig
gawk
pkg-config
python
gtk, gtk2, -devel and gdk (the gtk is a must before installing stage)
freeglut, -devel (this is the OpenGL library)
cmake
fltk, -devel
geos or libgeos
statgrab
gnomecanvas (or libgnomecanvas)
xmms-config
gtk, -devel, (or gtk+2, -devel, gtk2, -devel)
howl
ffmpeg
ode (this package is a must before installing gazebo)

I've wrote them on a file and uploaded it to my Google Docs. You can read it there.

Write to me if you find an error or there is something needs correction. Happy installing Player/Stage.