INSTALLATION GUIDE                                           02 Aug 95
                                                        Keith Andrews

Harmony is Copyright (c) by IICM, see the full copyright notice for
conditions of use.



                        Harmony Release 1.0
                        ===================


This file describes how to install the Harmony client for Hyper-G.

See the README file for general information about Harmony and the
RELEASE notes for a list of enhancements and known limitations in this
release.

The Harmony FAQ list (harmony.faq) contains information on
availability, a list of FTP mirror sites, and pointers to further
information on Hyper-G.

There is a preliminiary version of the Harmony User Guide available.
It is installed in $HARMONY_HOME/misc.

Installation Procedure
----------------------

First of all, retrieve the appropriate file for your machine
architecture by anonymous ftp from "ftp.iicm.tu-graz.ac.at" in
directory "pub/Hyper-G/Harmony" (or from one of the mirror sites
listed in the FAQ):

   IRIX 5.3 (SGI)              harmony-1.0-IRIX-5.3.tar.gz
   SunOS 4.1.3 (Sun)           harmony-1.0-SunOS-4.1.3.tar.gz
   Solaris 2.3 (Sun)           harmony-1.0-SunOS-5.3.tar.gz
   HP-UX A.09.01 (HP 7xx)      harmony-1.0-HP-UX-A.09.01.tar.gz
   ULTRIX 4.4 (DEC)            harmony-1.0-ULTRIX-4.4.tar.gz
   OSF1 V3.2 (DEC Alpha)       harmony-1.0-OSF1-3.2.tar.gz
   Linux 1.2.5 (PCs)           harmony-1.0-Linux-1.2.5.tar.gz

If there are more binaries for one plattform to support different
kinds of 3D output devices, the library used is indicated in the name:
       - gl   is used to indicate a binary using Irix GL
       - ogl  is used to indicate a binary using Open GL
       - mesa is used to indicate a binary using the Mesa 3D library.

Binaries using the Mesa library can be used without any addional
libraries installed on the system. OpenGL or Irix GL binaries can only
be used if the required shared libraies are provided by the target
system (we cannot provide them because of copyright restrictions).

The only plattform with build in 3D support in the default binary is
the SGI version using Irix GL.

Put it in the directory where you want to install Harmony. This
directory should either be in your home directory if you plan a
private installation, or in something like "/usr/local/Harmony" for a
public installation. Depending on the platform, Harmony consumes up
to about 30MB of disk space; during the installation process you will
need about twice this space.

 Uncompress (with 'gzip -d') and untar the file. This will create the
directory 'bin' for the Harmony binaries, and the directories 'icons'
and 'misc' for Harmony's data files.

 When you have done this, please continue with the section "Setup"
below. Of course, you may remove the tar files now.



Setup
-----

Check the following before starting Harmony -- you MUST perform steps
1 to 3 for Harmony to function properly!!


1. Is the environment variable HARMONY_HOME set to the Harmony
  installation directory?

  For example, if you have installed Harmony in the directory
  /usr/users/test/harmony and you are using the csh, type:

    setenv HARMONY_HOME /usr/users/test/harmony


2. Is $HARMONY_HOME/bin included in your path?

  Under Unix, you must tell the command shell where to look for
  exectable programs. For example, if you are using the csh, type:

    set path=($HARMONY_HOME/bin $path)


3. Are Harmony's X11 application defaults active?

  X11 applications under Unix often make use of so-called application
  defaults or resources. Harmony uses the X resources in the file
  $HARMONY_HOME/misc/Harmony

  For Harmony to function properly, you must make sure that it finds
  its X resources by doing at least *one* of the following:

  a) Copy $HARMONY_HOME/misc/Harmony to the system app-defaults
     directory as /usr/lib/X11/app-defaults/Harmony
     This sets Harmony's resources for all users on the system and
     can usually only be performed by the system administrator.

  b) Set the environment variable XAPPLRESDIR to $HARMONY_HOME/misc/
     e.g.  setenv XAPPLRESDIR $HARMONY_HOME/misc/

  c) Copy $HARMONY_HOME/misc/Harmony into your home directory
     under the name ~/Harmony

  d) Include $HARMONY_HOME/misc/Harmony in your local
     ~/.Xdefaults file, which is typically automatically loaded into
     the X server when you log in.

  e) Explicitly load $HARMONY_HOME/misc/Harmony into the X server.
     For example: xrdb -merge $HARMONY_HOME/misc/Harmony

  Personal settings are best made in ones own ~/.Xdefaults or
  ~/Harmony file.


4. The Harmony PostScript Viewer uses 'gzip' and/or 'uncompress' to
  uncompress the PostScript document and 'gs' (GhostScript) to
  generate its page images. Make sure you have these tools in your
  path if you plan to view PostScript documents (e.g. for
  J.UCS). Ghostscript is available from ftp.cs.wisc.edu in directory
  /pub/ghost/aladdin and many other FTP sites.


5. Check the release notes in the 'misc' directory for peculiarities
  of the current version (known bugs and limitations, etc.).


6. Once Harmony is running, you will probably have to configure the
  fonts Harmony uses (see the Harmony X resource file) to match your
  screen resolution and the fonts available on your particular X11
  installation -- the X font model doesn't allow us to specify a
  single set of fonts which look good and are available universally.




Running Harmony
---------------

 To run Harmony, enter for example:

   harmony

   harmony -host name

where name is the name of the desired Hyper-G server.

A list of Harmony's command line options is displayed by:

   harmony -h



You might like to point Harmony at some of the following Hyper-G
servers:


o info.iicm.tu-graz.ac.at   [or hyperg.iicm.tu-graz.ac.at]

 The IICM Information Server. Here you can find a description of the
 IICM, a Harmony Tutorial, online documentation on Hyper-G, J.UCS
 (Journal of Universal Computer Science), information about Graz and
 Austria, a collection of MPEG films, and much more besides.


o info.tu-graz.ac.at   [or hyperg.tu-graz.ac.at]

 Graz University of Technology's Information System run by the
 university computer centre. Contains a wealth of information about
 Graz University of Technology, pointers to other information servers
 in Austria and worldwide, fully indexed and searchable versions of
 the ACM SIGGRAPH Online Bibliography and the HCI Bibliography, ...


o hmu1.cs.auckland.ac.nz

 The University of Auckland Hyper-G Server, run by the Department of
 Computer Science's HyperMedia Unit (HMU). Information about the HMU,
 the Department of Computer Science, the University of Auckland, New
 Zealand, etc. Take a look at the aerial views of Waitemata Harbour!


o gds.esrin.esa.it

 Earth Observation Guide and Directory Services (GDS) at the European
 Space Agency. Satellite images, mission reports, and related
 information.


By default, Harmony connects to the server "info.iicm.tu-graz.ac.at".




Firewalls
---------

Hyper-G clients connect to Hyper-G servers on port 418 by default.
Control information is sent via port 418, but documents are
transferred via *dynamically* assigned port numbers from server to
client. This is why Harmony does not work behind a firewall.




Interoperability with WWW and Gopher
------------------------------------

Harmony is a Hyper-G client, and not (directly) a WWW or Gopher
client. Commands like:

 harmony -host www.somewhere.edu

will not work (unless www.somewhere.edu happens to be a Hyper-G
server).


Interoperability with these network tools is provided for all Hyper-G
clients by the Hyper-G server -- Harmony always accesses a Hyper-G
server and accesses WWW and Gopher sites via the Hyper-G server it is
conneted to!! To use Harmony to browse the wider Web, it is advisable
to use a Hyper-G server electronically near to your site (or install
your own local Hyper-G server). You can then access Web sites with
a command like:

 harmony -host hyperg.local -goto http://www.somewhere.edu/





Feedback
--------

Please direct any feedback (comments, suggestions, bug reports, etc.)
concerning Harmony by electronic mail to:

 [email protected]

We are very interested in your feedback, even though we may not be
able to respond personally to every piece of mail...


If you are sending a bug report, please supply the following
information to help us locate the problem:

 Harmony version:                        [e.g. harmony -h]

   Component     |      Version          Date
   --------------------------------------------
   harmony       |
   hartextd      |
   harimaged     |
   harfilmd      |
   haraudiod     |
   harscened     |
   harpsd        |
   haradmin      |


 Operating system version:               [e.g. uname -a]

 Description of bug:

 Location of document causing problem:   [if applicable]

 Output to terminal:

 Stack trace of core dump:               [limit coredumpsize unlimited]

You are viewing proxied material from gopher.floodgap.com. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.