Migration description of DL V1 Text Search ( SM6000 ) to DL V2 on AIX
------------------------------------------------------------------------------------------------


The DL V2 GA shipment still contains a Text Search component but the code base is
completely restructured. In general existing applications will still work, but the
format of some index files has changed. Thus the existing SM6000 indexes are not
compatible with the new structure.

Following you find a description about what to do to migrate the old index version
to the new.

Start a shell with a userID belonging to the smadmin group. This will insure
that the file permissions and ownership stay the same.

1. Save the SM6000 files stored under /usr/lpp/SM6000/index
   - take care that there are no search or indexing activities

2. Save all files of your existing indexes  ( index and work path )
    ( e.g. /usr/lpp/SM6000/index/DLSAMPLE      index path
           /usr/lpp/SM6000/work/DLSAMPLE       work path    )

3. Deinstall SM6000 and the DL V1 client toolkit
   note: the index directories created after installation will not be touched

4. Install
   a)  DL V2 client tool kit
   b)  Text Search client and server
       Note: don't create any indexes. The information about them will be
             lost after the migration.
             If you already should have an index and you have to keep it:
             a) Save all of the files in its index path    
             b) Migrate the old indexes as described in the following
                steps ( 5 - x )

             c) After the migration is complete,
                create a new index with the identical settings of the
                one you just saved.
                This will add the index to the migrated installation
                but will point to an empty index
             d) Restore the saved index files.
                Now use the Admin Notebook and you will find the index
                and the documents of it ( TS server has to be started ! )       


5. Install the migration files as follows:

   a) get the package
      SM6000_Migration_to_DLV2_AIX.tar
      from the same boulder ftp site where you got the DL
      product from  ( ftp://ftp.software.ibm.com/ps/products/digital_library )

   b) untar it in a /temp directory and copy
      1. to the system's libpath
         - imccxloc
         - libimc.a
         - libimcapi.a

      2. to the system's path
         - imcmigix
         - imcmigmt
         - imcsmbck

   c)  Check the execute permission of the files

Note:  Before the conversion all indexing requests must be processed. The
       indexing queue will be deleted in conversion step 6.2
       The file for indexing messages ( excdocer.dat ) will also be deleted.
       If you need the old information why some documents were not indexed in
       the past, you can extract it later from the previous save of step 1.

6. Conversion steps

       1.  If your sm6000 server is running:
                      stop it =>  sm6000 stop server_name instance_name
       2.  execute : imcmigmt
                     imcmigmt -p master_index_path ( e.g. /usr/lpp/SM6000/index)
                              -i new DL V2 Text Search server instance name
                                 ( e.g. dlinst )
           This will convert/rename SM6000 tables and rename all index files
           of all indexes of the old instance in place.

           The new file name prefix will be "iml"
           => Note: the converted master table imlmastr.dat will be copied to
                    your newly installed Text Search server instance path
                          /home/user_id/ts/instance_name
                     e.g. /home/tsadmin/ts/dlinst
                    Thus the converted table points from the new installation
                    of Text Search server to the old not yet converted index
                    files.

       3.  This step will convert the index files to the new format
           a) start the Text Search server   ( imlss -start instance_name )
           b) execute:    imcmigix <search_service_name>
            e.g.   imcmigix TM
                   The search service name is the one you supply when you
                   configure the Text Search client ( with TM, hostname, port)

           Note: Depending on the size of your index
                 the conversion may take a while. (bigger index -> longer time )

    Successful completion can be checked in the following ways:

    1. execute the AIX command:        ps -ef | grep imcsmbck
       If this imcsmbck process is not active any more, the work is done

    2. Use your Java system admin GUI for Text Search and have a look at
       o the notebook page: Index Function Status
       o check the "merge" radio button
       o the "running since" field will show you when you started the merge
       o when "running since" does not show a timestamp any more, merge is done.

       o check if the function is locked due to an error
         if so, unlock and report the error code to us.( address below )

After successful completion of the merge the conversion is completed and you
can use the index data with the newly installed product.

If there should be any problems or questions, please contact:

Stefan Orban
IBM Internet Solutions Development, dept. 7104
German Software Development Lab (GSDL) - Boeblingen
phone: +49-7031-16-6550, fax: +49-7031-6440 ,   e-mail: sorban @ vnet.ibm.com
Lotus Notes: Stefan Orban/Germany/IBM @ IBMDE