QUIPU-6.8


                       Colin Robbins

                     X-Tel Services Ltd


                          _A_B_S_T_R_A_C_T

          ISODE and QUIPU version  6.8  (isode-interim)
     have  now been released. This is a note to explain
     the X-Tel position regarding support QUIPU-6.8  in
     terms  of  the  JNT  Directory  Pilot  and  how to
     upgrade from your  current  version  of  QUIPU  to
     QUIPU-6.8.



_1.  _S_u_p_p_o_r_t

ISODE-6.8 which contains QUIPU-6.8 has just  been  announced
on  the QUIPU mail list (called isode-interim). It is avail-
able to the JNT  pilot  sites.   There  are  a  lot  of  new
features,  including: attribute inheritance; spot shadowing;
DSA relaying; indexed  searching;  alias  management  tools;
user  friendly naming; the "dsc" DUA; X-Windows DUAs; Direc-
tory replacement for isoservices  and  isoentites;  DSA  log
processing scripts; and "pepsy" all rolled in.

You should currently be running QUIPU-6.1.  If you  are  and
are  happy  with the way it is running, then you do not _n_e_e_d
to upgrade to 6.8, although you lose out on the benefits and
extras.  X-Tel will continue to support 6.1.

If you decide to upgrade to QUIPU-6.8, X-Tel will offer  you
full support.

There is a caveat if you decide to stay with QUIPU-6.1.   If
you  report  a complex problem with your system that can not
be easily  remedied,  X-Tel  will  require  you  upgrade  to
QUIPU-6.8.   If  this does not solve the problem, obviously,
we will investigate  further.   It  is  doubtful  that  this
situation  will  ever occur, as the "standard" problems with
QUIPU-6.1 are well known, with known fixes.

We will no longer support the QUIPU-6.0 version.  If you are
still  running  with  QUIPU-6.0  (yes,  there are still some
sites), you must either go to QUIPU-6.1  or  QUIPU-6.8,  the
choice  is  yours (we will help with the upgrade of course),
although we suggest 6.8.



                       8 March 1991





                           - 2 -


Some sites have taken intermediate  beta  test  versions  of
QUIPU, these are not supported.

QUIPU-6.8 is a beta release for  QUIPU-7.0,  which  will  be
available  in  a  few  months time.  When available, all JNT
Pilot sites will be required to upgrade to QUIPU-7.0.

_1._1.  _S_u_p_p_o_r_t _S_u_m_m_a_r_y

8_____________________________________________________________________________________
 ISODE Version     Support            Comments
8_____________________________________________________________________________________
      6.0          None               Upgrade to 6.1 or 6.8 NOW
      6.1          Yes                Complex problems may require an upgrade to 6.8
      6.8          Yes                The suggested version.
      7.0          When Available     Will be required
8_____________________________________________________________________________________
7|7|7|7|7|7|




               |7|7|7|7|7|




                                  |7|7|7|7|7|




                                                                                    |7|7|7|7|7|






Versions of the ISODE not listed above  are  NOT  supported,
you should upgrade to 6.8.



































9


                       8 March 1991





                           - 3 -


_2.  _U_p_g_r_a_d_i_n_g _I_S_O_D_E-_6._1 _t_o _I_S_O_D_E-_6._8

There is a script from X-Tel to upgrade your  ISODE  version
from  6.1 (or 6.0) to 6.8.  This is available from X-Tel via
ftam in a file called _u_p_g_r_a_d_e-_6._8._s_h_a_r in the  _q_u_i_p_u  direc-
tory   (there   is   also   a  compressed  version  upgrade-
6.8.shar.Z).  Recover this shell archive file and  place  it
in the top level of the isode home directory, and unwrap it:

         _c_d ~_i_s_o_d_e
         _f_t_a_m -_h -_u _a_n_o_n _0_0_0_0_2_1_0_0_1_0_2_9_9_9 _g_e_t _q_u_i_p_u/_u_p_g_r_a_d_e-_6._8._s_h_a_r _u_p_g_r_a_d_e-_6._8._s_h_a_r
         _s_h < _u_p_g_r_a_d_e-_6._8._s_h_a_r


This will create a directory called "upgrade-6.8".  Go  into
this directory:

         _c_d _u_p_g_r_a_d_e-_6._8

(In this directory you will find the source of this note!)


_2._1.  _G_e_t_t_i_n_g _I_S_O_D_E-_6._8

The first step is to get the new ISODE  tar  file  onto  the
directory machine!  The FTAM and NIFTP access information is
given in the announcement.  You should place the file in the
top  level  of  the  isode  home  directory in a file called
_i_s_o_d_e-_6._8._t_a_r._Z.

Alternatively, you can ftam the file from X-Tel by  entering
the

         ./_m_a_k_e _f_t_a_m-_6._8

command in the upgrade-6.8 directory.

_2._2.  _D_i_s_k _S_p_a_c_e

The amount of disk needed to build this version of the ISODE
depends  on  the  operating  system  you  are  using.  Under
SunOS4.1 or greater, about 45 Mbyte is needed.  With an ear-
lier  version  of  SunOS,  approximately  55 Mbyte is needed
(shared libraries make a big difference!).

The script will "clean" the old ISODE source and check there
is  sufficient  space  (there  should be!).  If there is not
sufficient space, you could consider removing the  ISODE-6.0
tree completely.

If you have kept the "isode-6.0.tar.Z"  or  "isode-uk.tar.Z"
files,  and  the  "quipu-upgrade.tar.Z" file, you can remove
these as they are obsoleted by this version of the ISODE.




                       8 March 1991





                           - 4 -


_2._3.  _C_o_m_p_i_l_i_n_g

If your system is a default ISODE installation (it  will  be
unless  you  have  altered parameters in the CONFIG.make and
config.h files) you can now type:

         ./_m_a_k_e

in the upgrade-6.8 directory.

This will unwrap the new ISODE, ensure there  is  sufficient
disk space and compile the new ISODE.  This may take an hour
or so!

If you changed any  of  the  configuration  options  in  the
CONFIG.make  file or the config.h file of the previous ISODE
release, you  should  make  similar  changes  to  the  files
_u_k_d_i_r._m_a_k_e  and  _u_k_d_i_r._h in the upgrade-6.8 directory before
running make.  If you are running SunOS-4.1, you should  NOT
put the shared library options in the ukdir.make file.  This
installation will make the necessary shared library  changes
for you.

If your quiputailor file is NOT _q_u_i_p_u_t_a_i_l_o_r in  the  ISODE's
etc directory (usually /usr/etc or /usr/local/etc), you will
need to edit the

         _Q_U_I_P_U_T_A_I_L_O_R=   $(_E_T_C_D_I_R)_q_u_i_p_u_t_a_i_l_o_r

line in the upgrade-6.8/Makefile to show the  absolute  path
name of the quiputailor file your DSA uses.

_2._4.  _I_n_s_t_a_l_l_i_n_g

The next step is to install QUIPU.  If you have PP installed
you  will  need to configure a few things (see the Section 3
BEFORE installing). To install (you will need to  be  root),
type:

         _s_u
         ./_m_a_k_e _i_n_s_t_a_l_l

in the upgrade-6.8 directory.

Please  note,  normally  the  ISODE   installation   process
overwrites  your  dsaptailor  and quiputailor files with new
ones.  You then have to go and restore the old  ones.   This
Makefile knows about this problem, and restores the old ones
after the installation!  In case of problems, all the origi-
nal  ISODE tailor and configuration files are copied into an
"archive" directory.  If you need to restore  any  of  these
files,  you  are  advised  to  contact X-Tel first, as it is
likely you have something configured incorrectly.




                       8 March 1991





                           - 5 -


This process will install the ISODE, QUIPU and FTAM.  If you
want other parts of the ISODE (vt, pod, dsc etc)|-  you  will
have  to  do this yourself.  The process is described in the
isode-6.8/READ-ME file.

_2._5.  _C_o_n_f_i_g_u_r_i_n_g

The next step is to reboot the machine, perhaps using  some-
thing like

         _s_h_u_t_d_o_w_n -_r +_5 "_t_o _i_n_s_t_a_l_l _I_S_O_D_E-_6._8"


When the machine comes back up, you should  check  that  the
ros.quipu process has started using the "ps" command.

The final very IMPORTANT step is to upgrade the  QUIPU  ver-
sion number.  With this version of QUIPU - _y_o_u_r _D_S_A _w_i_l_l _n_o_t
_w_o_r_k _c_o_r_r_e_c_t_l_y _u_n_t_i_l _y_o_u _d_o _t_h_i_s.  The make option:

         ./_m_a_k_e _c_o_n_f_i_g_u_r_e

will do this for you (you will  be  prompted  for  your  DSA
managers password).


Having installed the standard ISODE and QUIPU,  your  atten-
tion  is drawn to the READ-ME and QUIPU-READ-ME files in the
isode-6.8 directory which describe  the  new  features.   In
particular  notice the sections describing how to replace to
static isoentities and isoservices files  with  a  directory
lookup  should be noted. It is recommended that sites regis-
ter their OSI services in the directory. The  READ-ME  files
describe a tool to register and maintain these entries.  For
an example set of registered services,  you  might  consider
looking at

         c=GB @ o=X-Tel Services Ltd @ cn=lancaster

in the DIT.

_3.  _P_P _a_n_d _I_S_O_D_E-_6._8

The PP-5.0 release relies on ISODE-6.0.  DO NOT try  to  re-
compile  with  this  version of the ISODE.  The old binaries
will work with this new  version  with  one  exception,  the
definition of IXI.

If your isotailor file has a line of the following form

         _t_s__i_n_t_e_r_i_m: _L_O_C_A_L-_E_T_H_E_R _I_X_I
_________________________
|- OR your own programs which WILL need re-compiling.




                       8 March 1991





                           - 6 -


you have a minor problem.  The "make  install"  option  will
remove the IXI definition from this line of the  tailor file
as ISODE-6.8 does not need it, but PP does.

To prevent this option from being removed  you  should  find
the lines:

         _T_A_I_L_O_R_R_E_M_O_V_E=_I_X_I
         #_T_A_I_L_O_R_R_E_M_O_V_E=

In the upgrade-6.8/Makefile, swap the hash mark so that  the
line looks like

         #_T_A_I_L_O_R_R_E_M_O_V_E=_I_X_I
         _T_A_I_L_O_R_R_E_M_O_V_E=

Then you can install as described.

When you run any of the ISODE or QUIPU  programs  they  will
print the warning:

        _d_u_p_l_i_c_a_t_e _p_r_e_f_i_x_e_s _f_o_r _c_o_m_m_u_n_i_t_i_e_s "_I_X_I" _a_n_d "_I_X_I"

You can IGNORE this - it is annoying but harmless.

_4.  _P_a_t_c_h_i_n_g

If it becomes necessary to patch this version of the  ISODE,
there are a few tools to help you.  First of all, you should
copy the patch into the _u_p_g_r_a_d_e-_6._8/_p_a_t_c_h_e_s  directory,  for
example, create a new file called

         _u_p_g_r_a_d_e-_6._8/_p_a_t_c_h_e_s/_p_a_t_c_h._1

Each new patch should be given a different  name,  typically
this will be the name given to the patch when released.

Then in the _u_p_g_r_a_d_e-_6._8 directory, issue the command

         ./_m_a_k_e _p_a_t_c_h

This will prompt you for the name of the patchfile  relative
to  the  patches  directory  (if following the example above
enter the name _p_a_t_c_h._1).  This will apply the patch and  re-
compile  the  default ISODE and QUIPU.  If you have compiled
other interfaces, these may need recompiling.

To install the patched ISODE and QUIPU,  you  will  need  to
become _r_o_o_t, then type

         ./_m_a_k_e _p_a_t_c_h-_i_n_s_t_a_l_l






                       8 March 1991





                           - 7 -


_5.  _O_I_D _T_a_b_l_e_s

From time to time it is worth checking that you have  an  up
to date set of oidtables. The option

         ./_m_a_k_e _g_e_t-_t_a_b_l_e_s

will FTAM the latest tables from X-Tel. As root

         ./_m_a_k_e _i_n_s_t_a_l_l-_t_a_b_l_e_s

will install them.

_6.  _P_r_o_b_l_e_m_s

Any problems should be reported to  _j_n_t-_q_u_i_p_u@_u_k._c_o._x_t_e_l  or
you can telephone the "hotline" on 0602 412648.








































                       8 March 1991