1
Linux Specific Issues / Newbie guide to installation on Ubuntu.
« on: March 05, 2008, 01:54:44 pm »
Ubuntu Installation Guide
* This is a simple guide for people running Ubuntu who want a quick nice way of getting this game running on your systems.
The first step is to open a terminal window.
Applications ---> Accessories ---> Terminal
You should now have a terminal window open.
Lets start by downloading the installer. Copy and paste the following command into the terminal window. (right clicking in the terminal window will give you a menu with the option to paste. The normal Ctrl + V doesn't work. (Its Ctrl + Shift + V if you want to use the shortcut).
There are two binaries available for linux. One is for those who have a 32 bit processor or whom have a 64 bit processor but are only running a 32 bit distro. The other is for people with 64 bit capable processors who are running a 64 bit distro. The difference is significant enough that if you download the wrong one then it won't work so be sure to grab the right installer!
You can check to see what your distro is by entering the following command into the terminal if you are unsure:
If you are running a 32 bit distro the output will be something like:
Command:
Output:
2.6.22-14-386
Note the part I highlighted in red. This is the important part of the line and indicates you are on a 32 bit distro.
If you are running a 64 bit distro the output will be something like:
Command:
Output:
2.6.22-14-x86_64
Again, note the portion in red. This is an indication that you are running a 64 bit distro.
Download the proper 32 or 64 bit version from the ps website
Once it downloads, enter this next command. It makes the installer executable:
For 32 bit (most users):
For 64 bit:
When you hit enter there will be no output. If you type:
Then it should show up in green text (this means its set to executable).
Now we want to launch the installer. Most people want it to create menu icons so it must be run as root.
For 32 bit users:
For 64 bit users:
One you hit enter it should wait for a bit and then you will see the PlaneShift splash screen. After a time you should get a dialog box like this:
As you can probably tell I speak English, so I just hit the OK button.
This brings you to a nice new screen, the welcome screen:
I just hit Forward here.
Now we are greeted with a EULA. Just make sure to select I accept:
And hit Forward.
Now we get to the installation directory section. I prefer installing in /opt, which happens to be the default.
Since we don't need to change anything, I just hit Forward.
The next page is just a list of information about the release and some requirements.
Just hit Forward.
The screen we are now presented with asks about a system wide install. This basically means that it puts some scripts in your path so that if you are at a command prompt anywhere you can just enter
Change the option from no to yes so that it looks like this:
And go ahead and hit the Forward button!
The next screen asks about your windowmanager. If you are on Kubuntu then it is probably KDE, if you are on Ubuntu it is probably Gnome. The initial screen looks like this:
If you are on KDE then leave this option as is. If you are not then change to Gnome as in the following screen:
Now hit Forward to move to the next step of the installation.
Now we have the option of installing Menu Items. I prefer this as it makes things a bit nicer. The initial screen looks like this:
But change the option to yes so that it looks like the next screen here:
Then hit Forward. The next screen asks whether you want desktop icons.
Change it to yes if you want it, however I already have menu icons so I don't need desktop icons so I just leave this screen set to "No".
The next screen asks about manually setting permissions on the installed files however I find that the default values are pretty sane and work just fine.
I just leave this option set to "No" and hit Forward.
The next screen informs us that we are ready to install!
Just hit forward and the copying of files will commence!
Look the files are copying!! Yay!!
When it finishes you should finally be greeted with this screen:
Thats a good sign Just hit "Finish" to close the installer. You should now be ready to launch PlaneShift. It will be located in:
Applications -----> Games -----> PlaneShift Client
Also installed to the menus are:
PlaneShift Setup - Configure Options (including fullscreen)
PlaneShift Updater - Keep your version up to date
PlaneShift Uninstaller - Remove PlaneShift
Troubleshooting:
If you run into an error when launching the client it could be due to permissions. Some Ubuntu installs do not have a game group by default. If you see an error like the following one you can fix it pretty easily:
The fix is simple. Open a Terminal window again:
Applications ---> Accessories ---> Terminal
Now chown the directory:
* Note: be sure to change your_username_here to your own username, for instance mine says "brant:users" since my login name is brant.
This should eliminate the error.
There have been reports of the menu items not working correctly and not launching the applications correctly. If you cannot launch via the menu then open a terminal as described above and enter one of the following commands depending on what you want to launch:
One possibility to fixing this issue instead of using the command line to launch the program is to change the permissions on the .desktop file itself. The following command should do the trick on all 4 launchers at once.
I hope this helps a few people out! Questions, comments, etc are welcome.
* This is a simple guide for people running Ubuntu who want a quick nice way of getting this game running on your systems.
The first step is to open a terminal window.
Applications ---> Accessories ---> Terminal
You should now have a terminal window open.
Lets start by downloading the installer. Copy and paste the following command into the terminal window. (right clicking in the terminal window will give you a menu with the option to paste. The normal Ctrl + V doesn't work. (Its Ctrl + Shift + V if you want to use the shortcut).
There are two binaries available for linux. One is for those who have a 32 bit processor or whom have a 64 bit processor but are only running a 32 bit distro. The other is for people with 64 bit capable processors who are running a 64 bit distro. The difference is significant enough that if you download the wrong one then it won't work so be sure to grab the right installer!
You can check to see what your distro is by entering the following command into the terminal if you are unsure:
Code: [Select]
uname -a
If you are running a 32 bit distro the output will be something like:
Command:
Code: [Select]
brant@Ragnarok:~$ uname -a
Output:
2.6.22-14-386
Note the part I highlighted in red. This is the important part of the line and indicates you are on a 32 bit distro.
If you are running a 64 bit distro the output will be something like:
Command:
Code: [Select]
brant@Ragnarok:~$ uname -a
Output:
2.6.22-14-x86_64
Again, note the portion in red. This is an indication that you are running a 64 bit distro.
Download the proper 32 or 64 bit version from the ps website
Once it downloads, enter this next command. It makes the installer executable:
For 32 bit (most users):
Code: [Select]
chmod a+x PlaneShift-v0.4.02-x86.run
For 64 bit:
Code: [Select]
chmod a+x PlaneShift-v0.4.02-x64.run
When you hit enter there will be no output. If you type:
Code: [Select]
ls PlaneShift-*
Then it should show up in green text (this means its set to executable).
Now we want to launch the installer. Most people want it to create menu icons so it must be run as root.
For 32 bit users:
Code: [Select]
sudo ./PlaneShift-v0.4.02-x86.run
For 64 bit users:
Code: [Select]
sudo ./PlaneShift-v0.4.02-x64.run
One you hit enter it should wait for a bit and then you will see the PlaneShift splash screen. After a time you should get a dialog box like this:
As you can probably tell I speak English, so I just hit the OK button.
This brings you to a nice new screen, the welcome screen:
I just hit Forward here.
Now we are greeted with a EULA. Just make sure to select I accept:
And hit Forward.
Now we get to the installation directory section. I prefer installing in /opt, which happens to be the default.
Since we don't need to change anything, I just hit Forward.
The next page is just a list of information about the release and some requirements.
Just hit Forward.
The screen we are now presented with asks about a system wide install. This basically means that it puts some scripts in your path so that if you are at a command prompt anywhere you can just enter
Code: [Select]
planeshift
and it will start. I find this handy from time to time. The initial screen looks like this:Change the option from no to yes so that it looks like this:
And go ahead and hit the Forward button!
The next screen asks about your windowmanager. If you are on Kubuntu then it is probably KDE, if you are on Ubuntu it is probably Gnome. The initial screen looks like this:
If you are on KDE then leave this option as is. If you are not then change to Gnome as in the following screen:
Now hit Forward to move to the next step of the installation.
Now we have the option of installing Menu Items. I prefer this as it makes things a bit nicer. The initial screen looks like this:
But change the option to yes so that it looks like the next screen here:
Then hit Forward. The next screen asks whether you want desktop icons.
Change it to yes if you want it, however I already have menu icons so I don't need desktop icons so I just leave this screen set to "No".
The next screen asks about manually setting permissions on the installed files however I find that the default values are pretty sane and work just fine.
I just leave this option set to "No" and hit Forward.
The next screen informs us that we are ready to install!
Just hit forward and the copying of files will commence!
Look the files are copying!! Yay!!
When it finishes you should finally be greeted with this screen:
Thats a good sign Just hit "Finish" to close the installer. You should now be ready to launch PlaneShift. It will be located in:
Applications -----> Games -----> PlaneShift Client
Also installed to the menus are:
PlaneShift Setup - Configure Options (including fullscreen)
PlaneShift Updater - Keep your version up to date
PlaneShift Uninstaller - Remove PlaneShift
Troubleshooting:
If you run into an error when launching the client it could be due to permissions. Some Ubuntu installs do not have a game group by default. If you see an error like the following one you can fix it pretty easily:
The fix is simple. Open a Terminal window again:
Applications ---> Accessories ---> Terminal
Now chown the directory:
* Note: be sure to change your_username_here to your own username, for instance mine says "brant:users" since my login name is brant.
Code: [Select]
sudo chown -R your_username_here:users /opt/PlaneShift/
This should eliminate the error.
There have been reports of the menu items not working correctly and not launching the applications correctly. If you cannot launch via the menu then open a terminal as described above and enter one of the following commands depending on what you want to launch:
Code: [Select]
/opt/PlaneShift/psclient
Launches PlaneShift itself.Code: [Select]
/opt/PlaneShift/pssetup
Launches PlaneShift's setup application.Code: [Select]
/opt/PlaneShift/psupdater
Launches PlaneShift's updater.Code: [Select]
/opt/PlaneShift/uninstall
Begins the uninstall process. May need to be run with sudo.One possibility to fixing this issue instead of using the command line to launch the program is to change the permissions on the .desktop file itself. The following command should do the trick on all 4 launchers at once.
Code: [Select]
sudo chmod a+rx /usr/share/applications/planeshift*.desktop
I hope this helps a few people out! Questions, comments, etc are welcome.