Bernese - Installation On Unix

Bernese GNSS Software:
Installation on Unix-like systems
.
nd
P. Stebler
la
Bernese GNSS Software, Version 5.2; Introductory Course
er
Astronomical Institute, University of Bern, Bern, Switzerland
itz
Sidlerstrasse 5, CH-3012 Bern
P. Stebler: Installation on Unix-like systems
Sw
Introductory Course
n,
Bernese GNSS Software
er
Version 5.2
B
of
ty
i
rs
AIUB
ve
Slide 1 of 24 Astronomical Institute, University of Bern

ni
. U
te
itu
Outline
st
In
al
System requirements
ic
m
File system
no
Setup process
ro
st
Online updates
, A
Compilation
20
20
Example campaign
@
First steps
Final remarks
Slide 2 of 24 Astronomical Institute, University of Bern AIUB

System requirements (1/2)
.
nd
• Installation on a Unix-like platform
la
• E.g. Linux, Mac OS, Solaris Cygwin
er
• Instructions are given in the file README/INSTALL.TXT
itz
Sw
n,
er
B
of
ity
rs
AIUB
ve

ni
. U
te
itu
System requirements (2/2)

st
In
• Tools and libraries you need, e.g.

al
ic
• Perl 5, recent version including the standard modules

m
• Qt 4 library (in $QTDIR), including qmake (not Qt 5!)

no
• hint: somtimes missing compiler flag

PLATFORM=“linux-g++-64”
ro
• Fortran 90 compiler
st
• E.g. command gfortran from GNU Compiler Collection

A
• tar (tape archiver)

,
20
• gzip (file compression/decompression tool)

• C++ compiler
20
• E.g. command g++ from GNU Compiler Collection

@
• make
• Hatanaka tools
• Search the Web for CRX2RNX
• Put the executables e.g. into your ~/bin directory

Tested platforms
Linux
.
Ubuntu 32 and 64 bit G95, GNU, Intel and Sun
nd
Debian 32 and 64 bit G95, GNU, Intel and Sun
la
Fedora 32 and 64 bit G95, GNU, Intel and Sun
er
OpenSUSE 32 and 64 bit G95, GNU, Intel and Sun
gentoo 64 bit G95, GNU, Intel and Portland
itz
Sw
Mac
OS X 10.8.2 64 bit GNU and Portland
n,
er
B
of
ty
i
rs
AIUB
ve

ni
. U
te
itu
Directories
st
In
al
ic
• The following directories have to be determined:

m
no
Content Example Size (est.)

Installation files ~/INST52 250 Mb
ro
Main software tree /urs/local/BERN52 600 Mb (1)

st
User files ${HOME}/GPSUSER52 20 Mb

Temporary files ${HOME}/GPSTEMP (2)

Campaign area (2)
,
/bigdisk1/CAMPAIGN52
20
Datapool area (2)

/bigdisk2/DATAPOOL
20
Savedisk area /bigdisk3/SAVEDISK (2)

@
(1) After compilation with Qt 4 and GNU Fortran

(2) Subject to change

Files
• A list of the distributed files is given in content.txt

Installation script setup.sh
.
nd
Main software tree BERN52.tgz
Example campaign CAMPAIGN52.tgz
la
Datapool area DATAPOOL.tgz
er
Savedisk area SAVEDIST.tgz
itz
Icons for X-Window System ICONS.tgz
Sw
• Copy all files to the designated directory (e.g. ~/INST52) and
run the installation script setup.sh which will copy, compile and
n,
configure the software.
er
B
of
ty
i
rs
AIUB
ve

ni
.U
te
itu
Setup process
st
In
al
ic
m
no
•
ro
Described in detail in the file INSTALL.TXT

st
• Two scripts provided that do all the work for you

• setup.sh
,
• configure.pm
20
20
@

@
P. Stebler: Installation on Unix-like systems P. Stebler: Installation on Unix-like systems
20
20 Bernese GNSS Software, Version 5.2; Introductory Course
, A
•
st
Slide 9 of 24
Slide 10 of 24
ro
no
if you like
m
ic
al
In
st
itu
te
. U
ni
ve
rs
ity
of
B
Setup process, setup.sh (2/4)
er
Astronomical Institute, University of Bern

Astronomical Institute, University of Bern
n,
Sw
AIUB
AIUB
itz
er
la
nd
.
.
nd
la
er
itz
Sw
n,
er
B
of
i ty
rs
AIUB
ve

ni
. U
te
itu

st
In
al
• Extraction of the main software tree . . .

ic
m
no
ro
st
, A
20
20
@
• For above: type ’which perl’ into another terminal.

Setup process, configure.pm (1/2)
• The script ${X}/EXE/configure.pm lists all important
.
nd
installation and compilation options.
la
• It is automatically startet if the previous command ’sh setup’
er
succeeded.
itz
• Remember: After the installation you can call the script with
Sw
’perl ${X}/EXE/configure.pm’.
n,
er
B
of
ity
rs
AIUB
ve

ni
. U
te
itu
Setup process, configure.pm (2/2)

st
In
al
ic
m
no
ro
st
, A
20
20
@

Setup process, set variables (1/4)
.
nd
la
er
itz
Sw
n,
er
• If your compiler does not appear in the list, select OTHER and add
B
the appropriate settings to ${X}/EXE/Makefile.template
of
before the compilation (step 5 of configure.pm).
ty
• Contact bernese@aiub.unibe.ch in case of any problems.
i
rs
AIUB
ve

ni
. U
te
itu

st
In
al
ic
m
no
ro
st
, A
20
• You may want to change the path to the temporary user

20
environment ${T} for the sratch files (e.g. to

@
/scratch/local/$USER), as well as the paths for ${P}, ${D}

and ${S}.
• The paths for ${U} and ${T} must be $USER-dependent!
• Set ${BPE SERVER HOST} to the generic expression
$(hostname), if the name of the host, where the BPE server will
run, might change.
.
• All users should source this file during their login procedure!
nd
• Later on, ${X}/ECE/LOADGPS.setvar usually doesn’t need any
la
er
manual modification. Exceptions are additional campaign
itz
directories.
Sw
• New entry in LOADGPS.setvar:
• export Q="/newdisk/CAMPAIGN52"
n,
• Add Q to MENU VAR.INP (ENVIRONMENT VARIABLES) in
er
${U}/PAN and ${U}/OPT/* of all users.
B
• Menu > Configure > Menu variables
of
• Menu > BPE > Edit single menu/program input file
ity
rs
AIUB
ve

ni
. U
te
itu

st
In
al
ic
m
no
ro
st
, A
20
20
@

Online updates
.
nd
la
er
itz
• The file README/UPDATE.TXT (see also
Sw
Menu > Help > Readme) contains detailed instructions on the
n,
update procedure of the Bernese GNSS Software.
er
• Don’t forget to compile the programs and to update the input
B
panels with UPDPAN
of
i ty
rs
AIUB
ve

ni
. U
te
itu
Compilation
st
In
• In addition to the full compilation of the Bernese GNSS Software

al
using the configure.pm tool (options 4 and 5), you can also
ic
compile the menu with CMENU individually or compile single

m
no
Fortran files, update the Bernese library or link all programs by

using the script CBERN <NAME>.
ro
st
Command Purpose
CBERN <NAME> Compile a single subroutine or compile

and link a single Fortran program
,
20
(e.g. CBERN PRCEPO or CBERN GPSEST)

20
CBERN LIB Compile all the modified subroutines

and update the library
@
CBERN ALL Compile all modified source files, update the library,
and re-link all programs
CBERN COMPLINK Compile all source files,
replace the library and link all programs
(i.e., step 5 of configure.pm)

Example campaign
.
nd
la
er
itz
Sw
n,
er
B
of
• If you get the error message that CRX2RNX is not installed, you
ty
forgot to install the Hatanaka tools.
i
rs
AIUB
ve

ni
. U
te
itu
First steps
st
In
al
ic
• Make sure that the environment variables are loaded. Therefore,

m
depending on your shell, use one of the following commands:

no
• . $C/GPS/EXE/LOADGPS.setvar
ro
• source $C/GPS/EXE/LOADGPS.setvar
st
• Adapt the path to LOADGPS.setvar if necessary.

• You may add this step to your login script.

,
20
• Type the letter G on the command line to start the menu of the
20
Bernese GNSS Software.

@
• Read the FIRST STEPS.TXT description file on how to get

started.

Reminder
.
nd
la
er
itz
Sw
n,
er
• The script ${X}/EXE/configure.pm lists all important
B
installation and compilation options.
of
• (See page 13.)
ity
rs
AIUB
ve

ni
. U
te
itu
Final remarks
st
In
• All users need write permission in the campaign area ${P} and
al
ic
the savedisk area ${S}.

m
• All users need write permission for the list of campaigns

no
${X}/PAN/MENU CMP.INP, however, only one user will be able to

ro
edit this file at the same time with

st
Menu > Campaign > Edit list of campaigns.

• After the installation of the software do not forget to generate

,
20
the binary JPL ephemeris file (see Menu > Help > Readme or
20
file JPL EPH.TXT on installation disk).

@
• Run at least one session of an Example BPE to test if the

installation was successful.
• Check for bug-fixes and new releases at
www.bernese.unibe.ch/support.

Bernese - Installation On Unix

Uploaded by

Document Information

Original Description:

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Bernese - Installation On Unix

Uploaded by

Copyright:

Available Formats

Bernese GNSS Software:

Installation on Unix-like systems

Slide 1 of 24 Astronomical Institute, University of Bern

Slide 2 of 24 Astronomical Institute, University of Bern AIUB

Slide 3 of 24 Astronomical Institute, University of Bern

System requirements (2/2)

• Tools and libraries you need, e.g.

• Perl 5, recent version including the standard modules

• Qt 4 library (in $QTDIR), including qmake (not Qt 5!)

• hint: somtimes missing compiler flag

• E.g. command gfortran from GNU Compiler Collection

• tar (tape archiver)

• gzip (file compression/decompression tool)

• E.g. command g++ from GNU Compiler Collection

Slide 4 of 24 Astronomical Institute, University of Bern AIUB

Slide 5 of 24 Astronomical Institute, University of Bern

• The following directories have to be determined:

Content Example Size (est.)

Main software tree /urs/local/BERN52 600 Mb (1)

User files ${HOME}/GPSUSER52 20 Mb

Temporary files ${HOME}/GPSTEMP (2)

Datapool area (2)

Savedisk area /bigdisk3/SAVEDISK (2)

(1) After compilation with Qt 4 and GNU Fortran

Slide 6 of 24 Astronomical Institute, University of Bern AIUB

• A list of the distributed files is given in content.txt

Datapool area DATAPOOL.tgz

Slide 7 of 24 Astronomical Institute, University of Bern

Described in detail in the file INSTALL.TXT

• Two scripts provided that do all the work for you

Slide 8 of 24 Astronomical Institute, University of Bern AIUB

Astronomical Institute, University of Bern

Slide 11 of 24 Astronomical Institute, University of Bern

Setup process, setup.sh (4/4)

• Extraction of the main software tree . . .

• For above: type ’which perl’ into another terminal.

Slide 12 of 24 Astronomical Institute, University of Bern AIUB

• The script ${X}/EXE/configure.pm lists all important

Slide 13 of 24 Astronomical Institute, University of Bern

Setup process, configure.pm (2/2)

Slide 14 of 24 Astronomical Institute, University of Bern AIUB

Slide 15 of 24 Astronomical Institute, University of Bern

Setup process, set variables (2/4)

• You may want to change the path to the temporary user

environment ${T} for the sratch files (e.g. to

/scratch/local/$USER), as well as the paths for ${P}, ${D}

Slide 17 of 24 Astronomical Institute, University of Bern

Setup process, set variables (4/4)

Slide 18 of 24 Astronomical Institute, University of Bern AIUB

Slide 19 of 24 Astronomical Institute, University of Bern

• In addition to the full compilation of the Bernese GNSS Software

compile the menu with CMENU individually or compile single

Fortran files, update the Bernese library or link all programs by

CBERN <NAME> Compile a single subroutine or compile

(e.g. CBERN PRCEPO or CBERN GPSEST)

CBERN LIB Compile all the modified subroutines

Slide 20 of 24 Astronomical Institute, University of Bern AIUB

Slide 21 of 24 Astronomical Institute, University of Bern

• Make sure that the environment variables are loaded. Therefore,

depending on your shell, use one of the following commands:

• Adapt the path to LOADGPS.setvar if necessary.

• You may add this step to your login script.