Installing
|
Size: 4043
Comment:
|
Size: 4667
Comment: major update
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 5: | Line 5: |
| = Install the Ubuntu Accomplishments sytem = | = Installation = |
| Line 7: | Line 7: |
| This is still very much a work in progress and as such things need refining here. Set up the [[https://wiki.ubuntu.com/Accomplishments/Installing/ValidationServer|server component]]. | To play with accomplishments two steps have to be taken: * You need to [[#installing-core|install Ubuntu Accomplishments Daemon and Viewer]] * You need to install a set (or few sets) of accomplishments - [[#installing-uca|e.g. Ubuntu Community Accomplishments]] ''This guide presents how to install the client-side application. If you are interested in setting up a validation server, read [[https://wiki.ubuntu.com/Accomplishments/Installing/ValidationServer|how to set up the server component]].'' |
| Line 13: | Line 18: |
| You also need some additional packages. Run the following command to install them: | You also need some additional packages to build the application from source. Run the following command to install them: |
| Line 19: | Line 24: |
| == Getting The Code == Run the following to check out the code: |
= Installing the Ubuntu Accomplisments System = <<Anchor(installing-core)>> === Getting the code === Run the following to check out the latest code for both components: |
| Line 28: | Line 34: |
| You now need to install the Ubuntu Accomplishments collection (these are the different types of trophies). Grab these by running: | === Installing the Daemon === At first, use the quickly's packaging command to create a .deb package from daemon's source. {{{ cd ubuntu-accomplishments-daemon quickly package }}} Afterwards, install the resulting .deb package: {{{#!console cd ../ sudo dpkg -i accomplishments-daemon_0.1_all.deb }}} === Installing the Viewer === The Viewer provides a graphical interface for browsing accomplishments. The installation is very similar: {{{ cd ubuntu-accomplishments-viewer quickly package }}} ''(Quickly may fail to create package or create it improperly if the daemon hasn't been installed before packaging the viewer.)'' To install the Viewer's package run: {{{ cd ../ sudo dpkg -i accomplishments-viewer_0.1_all.deb }}} The Ubuntu Accomplishments System has been installed on your system. However, this application makes no sense without any accomplishments set installed. === Installing Ubuntu Community Accomplisments === <<Anchor(installing-uca)>> You are highly recommended to install Ubuntu Community Accomplishments collection (these are the different types of trophies). Grab these by running: |
| Line 47: | Line 91: |
| Now set your PYTHONPATH: | == Running The App == To start the application simply use: |
| Line 50: | Line 96: |
| export PYTHONPATH=$PYTHONPATH:/path/to/ubuntu-accomplishments-daemon }}} == Setting Up The App == A few small commands to install the .desktop file and icon: {{{ cd ubuntu-accomplishments-system sudo cp trophyinfo.desktop /usr/share/applications/ sudo cp data/media/ubuntu-accomplishments-system.svg /usr/share/pixmaps/ }}} == Running The App == === Running the daemon === To run you first need to run the daemon. You can run the daemon in one of two ways: (1) run it not as a daemon so you can see the output of the backend or (2) run it as a proper daemon background process. If you are just testing Ubuntu Accomplishments, it is recommended you run it so you can see the output (this makes it easier to let us know of errors and other issues. To run it this way type in: {{{ cd ubuntu-accomplishments-daemon twistd -noy ./bin/accomplishments-daemon }}} To kill the daemon press ''Ctrl-C''. If you would prefer to run it as a proper daemon in a background process, run it like this: {{{ twistd -y ./bin/accomplishments-daemon }}} When run as a background service you can see the output appended to a a log file in the `ubuntu-accomplishments-system` directory. To kill the daemon just run: {{{ killall -9 twistd }}} === Running the client === Now open a new terminal and from the `ubuntu-accomplishments-system` directory run the application: {{{ cd ubuntu-accomplishments-viewer quickly run |
accomplishments-viewer |
| Line 100: | Line 100: |
Note: The daemon starts automatically. In case you need to stop it, use {{{kilall -9 twistd}}}. |
|
| Line 105: | Line 107: |
| == Uninstalling == Uninstallation is as simple as removing it's two packages: {{{accomplishments-daemon}}} and {{{accomplishments-viewer}}} |
|
| Line 107: | Line 113: |
| == How do I kill the daemon? == | === How can I force a re-verification of my trophies? === |
| Line 109: | Line 115: |
| In the daemon terminal window just press `Ctrl-\` (Ctrl and Backspace) and it will kill it. | Click File -> Check Accomplishments. |
| Line 111: | Line 117: |
| == How do I clear out my trophies so I can re-verify them? == | === The application does not give me trophy for something I have accomplished! === Keep in mind that when Ubuntu One happens to lag a bit, the validation server may take some longer time to send you validated trophies. Also try re-verification your trophies. And double-check if your credentials are correct. If the application still misbehaves, report a bug: https://bugs.launchpad.net/ubuntu-accomplishments-system/+filebug === How do I clear out my trophies so I can re-verify them? === |
| Line 115: | Line 127: |
| == How do I clear out my user information so I can re-enter it? == | === How do I clear out my user information so I can re-enter it? === |
| Line 118: | Line 130: |
== How can I force a re-verification of my trophies? == Click File -> Check Accomplishments. |
|
|
|
|
|
|
|
Installation
To play with accomplishments two steps have to be taken:
You need to install Ubuntu Accomplishments Daemon and Viewer
You need to install a set (or few sets) of accomplishments - e.g. Ubuntu Community Accomplishments
This guide presents how to install the client-side application. If you are interested in setting up a validation server, read how to set up the server component.
What You Need
To run Ubuntu Accomplishments you need to be running Ubuntu 12.04 Precise Pangolin. You will also need to have an Ubuntu One account running on your computer.
You also need some additional packages to build the application from source. Run the following command to install them:
sudo apt-get update && sudo apt-get install quickly quickly-ubuntu-template python-gpgme
Installing the Ubuntu Accomplisments System
Getting the code
Run the following to check out the latest code for both components:
bzr branch lp:ubuntu-accomplishments-daemon bzr branch lp:ubuntu-accomplishments-viewer
Installing the Daemon
At first, use the quickly's packaging command to create a .deb package from daemon's source.
cd ubuntu-accomplishments-daemon quickly package
Afterwards, install the resulting .deb package:
cd ../ sudo dpkg -i accomplishments-daemon_0.1_all.deb
Installing the Viewer
The Viewer provides a graphical interface for browsing accomplishments. The installation is very similar:
cd ubuntu-accomplishments-viewer quickly package
(Quickly may fail to create package or create it improperly if the daemon hasn't been installed before packaging the viewer.)
To install the Viewer's package run:
cd ../ sudo dpkg -i accomplishments-viewer_0.1_all.deb
The Ubuntu Accomplishments System has been installed on your system. However, this application makes no sense without any accomplishments set installed.
Installing Ubuntu Community Accomplisments
You are highly recommended to install Ubuntu Community Accomplishments collection (these are the different types of trophies). Grab these by running:
bzr branch lp:ubuntu-community-accomplishments
Now create a directory to install your accomplishments to in your home directory:
mkdir ~/accomplishments
When you have grabbed this branch you can install those accomplishments to your accomplishments directory in your home directory with the included script. For example:
cd ubuntu-community-accomplishments ./install.sh ~/accomplishments
Running The App
To start the application simply use:
accomplishments-viewer
Follow the on-screen instructions and soon you will see a note in the status bar saying the app is checking for accomplishments: you should see new accomplishments appear in the My Trophies view shortly afterwards.
Note: The daemon starts automatically. In case you need to stop it, use kilall -9 twistd.
Questions can go to jono@ubuntu.com
Thanks!
Uninstalling
Uninstallation is as simple as removing it's two packages: accomplishments-daemon and accomplishments-viewer
FAQ
How can I force a re-verification of my trophies?
Click File -> Check Accomplishments.
The application does not give me trophy for something I have accomplished!
Keep in mind that when Ubuntu One happens to lag a bit, the validation server may take some longer time to send you validated trophies. Also try re-verification your trophies. And double-check if your credentials are correct. If the application still misbehaves, report a bug: https://bugs.launchpad.net/ubuntu-accomplishments-system/+filebug
How do I clear out my trophies so I can re-verify them?
Your trophies directory lives in ~/.local/share/accomplishments/trophies. In that directory is a sub-directory for each collection of trophies. Just rm -rf * everything or even remove the sub-directories.
How do I clear out my user information so I can re-enter it?
Your trophies directory lives in ~/.local/share/accomplishments/trophies. In that directory is a sub-directory called .extrainformation - just delete it.
Accomplishments/Installing (last edited 2012-12-24 12:08:19 by 177)