DATABASE/SPANA: Installing and Uninstalling
Distribution and installing:
The software is distributed through the Internet at:
www.kth.se/che/medusa
sites.google.com/site/chemdiagr
sourceforge.net/projects/eq-diagr
- Windows: the setup program allows you to make either a standard
or a portable installation.
For a standard installation the setup program will make the program group
Equilibrium Diagrams (java)
with the necessary icons (shortcuts). Optionally it will also associate
plt and dat files with
Spana.
You can later change these file associations using the menu Preferences /
General options in Spana.
- Ubuntu (Linux): Copy the zip-file to your home directory (~).
Double click to open the zip-file.
Extract the files to your home directory. Make sure that
the Re-create folders
and Overwrite existing files actions are checked.
Follow the instructions in the file Readme_Ubuntu.txt.
- Mac OS:
- The MacOS zip-file contains Mac app bundles with icons for DataBase
and Spana. This is perhaps most intuitive for Mac users.
- Using the non-system specific zip-file: copy the zip-file to your desktop.
Double click to open and un-zip the file.
Follow the instructions in the file Readme_MacOS.txt. You can
then create aliases on the desktop, etc.
|
|
INI-files and Environment Variables
ini-files (Spana.ini and
DataBase.ini) keep track of the user’s preferences,
the default directory, the databases, etc. Ini-files are created in the
installation directory. However, if the programs are installed on a
Network disk or on a CD, then the ini-files in the installation
directory will be read-only, and the programs will try to save
the user’s preferences in directories specified
in environment variables, etc. The sequence is:
- The installation directory
- %APPDATA%
- %HOMEDRIVE%%HOMEPATH%
- %HOME%
- The user's home directory (system dependent)
A warning message is displayed if no ini-file is found
or if it can not be written anywhere.
DataBase: if an ini-file (DataBase.ini)
is found in the installation directory (that is, where
DataBase.jar is found) then this file is always used to read dabase
names and some other options. On a Network server this file would contain
settings common for all users. A personal ini-file
(in %APPDATA% or %HOME%, etc) then supplies
only personal settings: the default directory, the start position of the DataBase-window, etc,
for each user.
File associations
On Windows, files with extension plt and
dat may be automatically
associated with Spana when running the setup program.
However, these associations might be in conflict with other software.
To remove file associations use the advanced program level
in the menu Preferences / General
options in Spana.
Installing on a Network server
All the files and sub-directories created during the installation can
be moved by the system administrator to a network disk,
which should be read-only to normal users. Alternatively the software could be
installed directly to the final location by the administrator.
Shortcuts should be modified, if necessary, to point to the correct location
(i.e., to the network directory), and then
copied for each user, depending on the system.
Environment variables should be defined
so that ini-files may be saved.
Installing on a CD-ROM
Follow the instructions below for a USB memory.
Ini-files will be created when you run the software as indicated
above. Because the CD is a read-only memory,
ini-files will be created locally in the computer where the CD is inserted.
If you do not want this: before burning the CD run first Spana and DataBase from
the hard-disk, then edit the configuration files created
(Spana.cfg and DataBase.cfg):
change SaveIniFileToApplicationPath
from false to true and burn these files also to the CD. In this way
local ini-files will not be created.
Installing on a USB memory
The programs may be installed on any removable memory.
Windows: Choose the option Portable application in the setup program.
If the PortableApps.com
plattform is found on the removable drive, Spana/Database will be installed following the
portable apps
directory structure.
If the PortableApps.com
plattform is NOT found, the software will be copied into a single folder on the USB drive.
To run Spana open the USB directory with the file explorer
and double-click on the file SpanaPortable.exe.
Ubuntu (Linux) and Mac OS: just copy all files to the removable drive. If Java
is installed on the local Macintosh or Linux, then double-clicking on a jar-file
in the USB memory will start the program.
For all systems: ini-files will be created
on the USB memory when you run the software.
Uninstalling
- Windows:
- Several possibilities:
- Run the Uninstall program.
The shortcut is found in the Start-menu program group; normally
Equilibrium Diagrams (java).
- Alternative: open the installation directory with the file explorer and
double-click on the file Uninstall.exe.
- It should also be possible to use the add-remove programs function
in Windows’ control panel, but this might not work if you installed
the software at two or more locations on the same computer.
-
Any of these methods will remove the files installed, as well as shortcuts,
ini-files, file associations and any registry keys.
If you installed the software at two or more locations on the same computer,
then Uninstall.exe will only remove the files in
its own installation directory. But it will remove all shortcuts,
as well as file associations, registry keys, and any ini-files created
outside the installation directory as indicated above.
Note that Spana and DataBase short-cuts are searched in
all program groups in the Start-menu, even if they point to
other installation directories. After deleting the short-cuts
the program groups are deleted if empty.
After uninstalling in one location,
you will need to use the procedure described above under b
to uninstall the software from other locations in the same computer
- As a last option you could delete the installation directory
(perhaps C:\Program\Eq-Diagr)
with all its files and sub-directories, but this will not remove shortcuts,
file associations, registry keys nor ini-files outside the
installation directory.
- Removable drives (USB memory): just delete the installation
directory with all its files. Remember to back-up any data files and diagrams
you might have stored in that folder!
- Ubuntu (Linux) and Mac OS: Move to trash the installation folder,
but remember to back-up any data files and diagrams you might have stored in that folder!
Delete also any desktop shortcuts (aliases on MacOS).