- 1 Installing, Starting, Upgrading and Uninstalling Emergent
- 2 Optional steps
- 3 Debugging Crashes and Known Issues
Installing, Starting, Upgrading and Uninstalling Emergent
InstallingYou can install emergent on Ubuntu using
apt-getbut first you need to add our repository. To do that first become
rootby entering this into your terminal followed by your password: Next make sure you are using the
Add the public key to your keyring. We sign our packages so you can be sure that you are getting emergent and not malicious software. You can install without the key but it is easy to be safe.
Next add emergent's repository to your system. This will update any previous entry you had for emergent, so if you have upgraded your version of Ubuntu you should run this code again. Highlight the following code, right click, and select copy. Then right click on your terminal, select paste and finally press enter.
You're now ready to install emergent. Just run these commands:Lastly, you should exit the root user. Just enter
Note for Linux Mint Users: Replace the Mint release name in sources.list with the codename of Ubuntu that your Mint release is based on.
StartingFrom the command line just type
NOTE: On Ubuntu 12.4 (Precise) you will see an error when you start emergent: "Unable to load library icui18n" -- this is due to a bug in Qt 4.8.1 and may be safely ignored.
UpgradingFirst become root by entering this into your terminal followed by your password:
Finally update your package cache and install emergent:
If you run into any problems, first uninstall emergent, and then try reinstalling it. If that doesn't fix it for you please e-mail the emergent-users mailing list.
UninstallingRun this code in your terminal followed by your password:
Ensure you have the correct video driver
Follow these instructions on the Ubuntu community wiki in order to ensure you have the most advanced, up to date drivers for your particular video card.
Software OpenGL (mesa)
If you have an old video card or are running emergent on a computer without a video card you can still get it to work using a software implementation of OpenGL. It will be slower since it uses the CPU to render but it will work. First become root:
Note: As of Lucid Lynx these instructions are no longer required - it happens correctly and automatically. However, if you are running Karmic or earlier they are necessary.
Next paste the following code into your terminal to install mesa:
To complete this process, you will also need to change your library path as indicated in the section below. Before you do that, exit the root user.
Change Your Library Path
If you are using the mesa drivers or are building from source, you will need to permanently change your path to look in
/usr/lib so that newer libraries are used.
Then paste this code into your terminal to update your library path in your
Finally, you will need to run this command to update your shell environment:
You may need to repeat these steps after upgrading your version of Ubuntu.
Add an Emergent Icon to the Startup MenuFirst become root:
Next paste this into your terminal:
In KDE, you can now navigate to
K Menu > Edutainment > Miscellaneous > Emergent and drag that to your panel if you like. On Gnome it shows up in
Menu > Education > Emergent.
Crash in svn operation within emergent: remove kwallet integration with svn
If svn-based operations within emergent crash, try this, to disable the kwallet integration of SVN: set the following config option in your .svn/config file:
password-stores = gnome-keyring
i.e. remove kwallet from the list of password-stores
Debugging Crashes and Known Issues
Conflict with Qt4
Emergent will crash if you build it against Qt version 5 and then somehow it ends up linking Qt4 libraries at runtime. Do:
lldd `which emergent`
to see which libraries emergent is linking against -- if you see libQt*.4 then this is the source of the problem.
Most likely culprit is the quarter library. Currently investigating how to fix.