There are two main methods, a binary install or a source install. If you choose the binary install it may be the easiest Xastir install you'll ever do!
NOTE: Versions 1.9.8 and earlier have known bugs plus use the Tigermap server which is now defunct. We were in the middle of adding OpenStreetMaps during the 1.9.9 versions. These days you should be using Xastir-2.0.0 or later.
Contents
Step 1: Add the Ham Repository to Yast2
- Add one of the following URL's to your "Software Repositories" in Yast2 (SUSE-11.x examples shown). The URL chosen must match the version of OpenSuSE that you have installed. To find out your version of OpenSuSE, look in the file "/etc/SuSE-release". For a current list of active ham radio SUSE repositories, look here: https://download.opensuse.org/repositories/hamradio/
[http://download.opensuse.org/repositories/hamradio/openSUSE_11.0/] SuSE-11.0 Ham Repository [http://download.opensuse.org/repositories/hamradio/openSUSE_11.1/] SuSE-11.1 Ham Repository [http://download.opensuse.org/repositories/hamradio/openSUSE_11.2/] SuSE-11.2 Ham Repository [http://download.opensuse.org/repositories/hamradio/openSUSE_11.3/] SuSE-11.3 Ham Repository
Proceed to Step 2 below.
Step 2: Xastir Binary or Source Install
- Choose a Method below and follow the directions.
Note that the binary version lags behind the source version, sometimes by quite a bit.
Also: the binary package maintainer chooses which options/which libraries he/she compiles into the Xastir binary. You may want different choices. If so, perform the source install to have full control over the end product.
Method 1: Binary Install on x86 Systems (32 or 64-bit)
This procedure will install several libraries from the SuSE ham repository plus the Xastir binary. Note: The binary on the OpenSuSE Ham repository is a bit old (1.9.8). A note has been sent to the maintainers to ask them to update it.
- Using the Yast "Software Management" app, install the "xastir" package. It should auto-install libraries that Xastir requires.
For the 64-bit install: If it asks you to change the architecture, let it. This will downgrade a few packages from 64-bit to 32-bit because the Xastir binary may have been built with a few 32-bit libraries.
Method 2: Source Install
Here you may choose to install a stable or development release, or from Xastir Git sources.
- Using the Yast "Software Management" app, install these packages or similar. You may select and install them all at once. This list may seem daunting at first, but this step goes quickly and gives you a complete compile/development environment. After that, upgrades are a snap! (see Step 5):
autoconf automake ax25-doc ax25-apps ax25-tools binutils bzip2 cpp curl cvs diffutils festival festival-devel freetype freetype2-devel gcc git gpsman gpsmanshp GraphicsMagick gzip libax25 libax25-devel libcurl4 libcurl-devel libfreetype6 libgeotiff libgeotiff-devel libGraphicsMagick3 libjasper libjasper-devel libjpeg libjpeg-devel liblcms1 liblcms-devel libproj-devel libproj0 libtiff3 libtiff-devel libtool make m4 openmotif openmotif-libs patch pcre pcre-devel proj4 soundmodem sudo tar tck tk wget xorg-x11-fonts xorg-x11-fonts-core xorg-x11-fonts-devel xorg-x11-server
- Optional: I like to install "colorgcc" which colors the compiler output based on warnings/errors. OpenSuSE-11.0 dropped support for it but I found a one-click install on this [ColorGCC web page].
- Compile/Install Xastir Sources from "Stable" or "Development" release:
- Download the release from [Xastir Download Page]
- tar xzvf <filename>
- Change to the new directory just created:
- cd <directory-name>
- mkdir -p build
- cd build
- ../configure CPPFLAGS="-I/usr/include/libgeotiff"
- make
- sudo make install
- sudo chmod 4755 /usr/local/bin/xastir
- If using SuSE-11.0, go to Step 3, else go to Step 4
- -Or- choose Git sources to enable keeping up-to-date with the latest developments:
- git clone http://github.com/Xastir/Xastir
- cd Xastir
- ./bootstrap.sh
- Note: Errors at this step may mean you need to install "automake" and "autoconf" via Yast2.
- mkdir -p build
- cd build
- ../configure CPPFLAGS="-I/usr/include/libgeotiff"
- make
- sudo make install
- sudo chmod 4755 /usr/local/bin/xastir
- If using SuSE-11.0, go to Step 3, else go to Step 4
Step 3: Upgrade Motif (SuSE-11.0 only)
Upgrade OpenMotif via RPM (Required for SuSE-11.0, not for later versions)
This step is required because OpenMotif-2.3.0 introduced a bug where slider widgets didn't show labels. Earlier/later versions of OpenMotif don't exhibit the bug. OpenSuSE-11.0 ships with the 2.3.0 version.
- 32-bit SuSE:
- Download these two RPM's for OpenMotif-2.3.1. They were built for SuSE-10.3 but work fine on 11.0. If later there are SuSE-11.0 RPM's at [the site], by all means install those instead and let us know about it on the mailing list so we can update this page. These will normally be downloaded to your "Desktop" directory.
- [OpenMotif]
- [OpenMotif-Devel]
- After you've downloaded them, type the following bold text into a "terminal" or "xterm" window:
- cd Desktop
- su
- rpm -U openmotif-2.3.1-1.suse103.i586.rpm openmotif-devel-2.3.1-1.suse103.i586.rpm
- Note: If other installed packages require OpenMotif then the above RPM command may fail. If so, type the following command to force the upgrade:
- rpm -U --force openmotif-2.3.1-1.suse103.i586.rpm openmotif-devel-2.3.1-1.suse103.i586.rpm
- exit
- Go to Step 3
- 64-bit SuSE:
- Download these two RPM's for OpenMotif-2.3.1. They were built for SuSE-10.3 but work fine on 11.0. If later there are SuSE-11.0 RPM's at [the site], by all means install those instead and let us know about it on the mailing list so we can update this page. These will normally be downloaded to your "Desktop" directory.
- [OpenMotif]
- [OpenMotif-Devel]
- After you've downloaded them, type the following bold text into a "terminal" or "xterm" window:
- cd Desktop
- su
- rpm -U openmotif-2.3.1-1.suse103.x86_64.rpm openmotif-devel-2.3.1-1.suse103.x86_64.rpm
- Note: If other installed packages require OpenMotif then the above RPM command may fail. If so, type the following command to force the upgrade:
- rpm -U --force openmotif-2.3.1-1.suse103.x86_64.rpm openmotif-devel-2.3.1-1.suse103.x86_64.rpm
- exit
- Go to Step 3
Step 4: Create a Desktop Icon (Optional)
Create an Icon on Your Desktop
- Open a terminal window. "xterm" is usually a good choice for a terminal.
- cd Desktop
- ln -s /usr/bin/xastir Xastir
You're Done!
Step 5: Keeping up-to-date (Git)
If you installed from Xastir Git sources you can run the update-xastir script at any time to snag the latest sources, run the configure/compile tools, and install the newly created binary, like this:
- cd Xastir (or whatever directory you put the Xastir sources in)
- ./update-xastir
Read the [Git page] for more detailed info about Git commands.