5.3.2. - Installing the spec Program Files
To install the spec files, particularly for a first time installation, you may need to install as root. Use the
su command
to gain super-user privileges.
If you are updating from previous distributions, you can
copy the most recent
install_data
file containing your default installation parameters
to the new distribution directory.
Then, from the current spec distribution directory, type
./Install to run the installation program.
If updating an existing installation and using the same installation
parameters as before, type
./Install -d
(for default)
to skip the interactive portion described next.
The Install program will first indicate the current installation parameters. You may either accept those or enter new parameters. When entering new parameters, the default response to each question is given in parenthesis. Most questions present a number of choices. You can either type the number of the choice or you can type out the literal selection. If one of the options is the word "other ," such as for the name of a directory, you can directly type your selection when prompted. For most questions, the first choice listed is probably the best response. For example,
Choices for binaries directory are:
1) /usr/local/bin
2) /usr/local
3) /usr/local/spec/bin
4) /u/bin
5) /LocalLibrary/Spec/bin
6) other
Choose binaries directory (/usr/local/bin)?
Entering a single minus sign (
-) will move back to the
question for the previous parameter, allowing you to enter a
different value.
The installation questions ask for the following parameters:
- geometry
- Selects from the supported diffractometer configurations.
- installed name
- Selects a name for the installed program. For configurations with special geometry code, the first four letters of the name must match the first four letters of the geometry configuration. Thus, fourcL and fourcR might be the names for the left- and right-hand sides of a rotating anode lab with two four-circle diffractometers.
- additional geometries
- Asks if you want to enter more combinations of the previous two items.
- file ownership
- Selects the name of the owner of the spec files.
- binaries directory
- Selects where the programs that users run directly from the shell will go. (It's better to put spec files in some place other than the standard /bin or /usr/bin, in order to be able to distinguish files that are standard UNIX from those that have been added locally.) This directory should be in each spec user's search path.
- auxiliary directory
- Selects where spec puts its auxiliary files. This directory is preferably on a local disk, as it contains files that are frequently updated, particularly the motor settings file.
- TACO library directory
- Gives the location of the TACO device server libraries if installing on a TACO device server platform. Gives the location of the TACO device server libraries, if using. There should be a subdirectory named "lib" in this directory. If using TANGO, enter "no" here and configure TANGO on next screen.
- TANGO library directory
- Gives the location of the TANGO device server libraries.
- EPICS library directory
- Gives the location of the EPICS channel access libraries if installing on an EPICS platform. The location can be the directory that has a subdirectory named base, the path name to the base directory that has a subdirectory named lib, or the complete path to the directory containing the EPICS libraries for this platform.
- HDF5 library directory
- Gives the location of the HDF5 libraries. Enter a value to enable spec's HDF (Hierarchical Data Format) data commands. Including HDF5 support with the default static libraries nearly doubles the size of the spec executable image.
- config file permissions
- Selects who can change the hardware configuration file. On a low-security site, select the first choice, which lets all spec users make changes as needed. See security notes 5.5.5.3 for additional considerations.
- command-line editing options
- Selects an alternative library that will be linked with spec to provide a more powerful history recall syntax than the minimal built-in spec history mechanism. The alternative library also includes command line editing features. spec includes a prebuilt version of the Berkeley libedit library.
- Extra compiler flags
- Allows you to add extra compiler flags for both compiling the site-dependent source files and linking.
- Extra object files
- Allows you to specify extra site-dependent object files to include when linking the spec executable.
- Extra library flags
- Allows you to specify extra site-dependent libraries to be searched during the link phase when producing the spec executable.
After answering the questions, the installation should then continue automatically, producing output similar to the following:
This program will install version 6.05.03 of the spec package. Type "Install -" to see invocation options. Checking if u_hook.c needs compiling ... Compiling u_hook.c ... Compiling u_hdw.c ... Checking if geo_fourc.c needs compiling ... Checking if spec needs to be linked ... Linking spec ... Installing config auxiliary files ... Installing fourc ... cp fourc /usr/local/bin/fourc Checking "fourc" config and settings file permissions ... Installing macros ... Installing /usr/local/lib/spec.d/standard.mac ... Installing /usr/local/lib/spec.d/four.mac ... Installing the high res graphics filters ... Installing help files ... Clearing out old help files ... Making the "help" help file ... Copying help files ... Changing ownership of help files to gerry ... Installing the chelp program ... Installing the show_state program ... Installing data_pipe auxiliary files ... Building data_pipe utility "dp_cplot" ... Installing auxiliary "include" files ... cp spec_shm.h /usr/local/lib/spec.d/include cp spec_server.h /usr/local/lib/spec.d/include Installing the "showscans" package ... cp show.awk /usr/local/lib/spec.d cp scans /usr/local/bin Installing the "contents" program ... cp contents /usr/local/bin Installing the "tidy_spec" program ... cp tidy_spec /usr/local/bin Installing the "wiz_passwd" program ... cp wiz_passwd /usr/local/bin Installing splot utility ... Clearing out old splot files ... mkdir /usr/local/lib/spec.d/splot Copying splot files ... Changing ownership of splot files to gerry ... Creating spec.conf file ... Done with spec Install!
If you change certain parameters that require relinking spec and don't see the
Linking spec ...
message when rerunning
the
Install
program, simply remove the
spec
file and run
Install
again.