[interchange-cvs] interchange - kwalsh modified UPGRADE
interchange-core@icdevgroup.org
interchange-core@icdevgroup.org
Wed Oct 30 19:16:01 2002
User: kwalsh
Date: 2002-10-31 00:15:01 GMT
Modified: . UPGRADE
Log:
* Added some text to the UPGRADE guide to cover the new duplicate
UserTag error messages that are common when upgrading to 4.9+.
Revision Changes Path
2.3 +45 -1 interchange/UPGRADE
rev 2.3, prev_rev 2.2
Index: UPGRADE
===================================================================
RCS file: /var/cvs/interchange/UPGRADE,v
retrieving revision 2.2
retrieving revision 2.3
diff -u -r2.2 -r2.3
--- UPGRADE 22 Oct 2002 00:54:25 -0000 2.2
+++ UPGRADE 31 Oct 2002 00:15:00 -0000 2.3
@@ -9,7 +9,13 @@
Full information on upgrades is available in the document icupgrade(8)
(in the distribution in pod/icupgrade.pod).
-To upgrade from 4.8, it is recommended that you:
+BACKUP EVERYTHING BEFORE YOU START!
+
+
+TO UPGRADE FROM 4.8.x
+---------------------
+
+It is recommended that you:
1. Make a tar backup of your Interchange software directory, i.e.
@@ -39,9 +45,13 @@
5. Restart Interchange.
+ 6. See the "problems with UserTags" section, below.
+
That should be it. Test the catalog to make sure it works.
+
IF YOU UPGRADED FROM 4.6.x
+--------------------------
If you have this line in interchange.cfg:
@@ -58,6 +68,8 @@
them explicitly like:
include usertag/my_tag
+
+ See the "problems with UserTags" section, below.
If you use CyberCash, you should replace these lines in catalog.cfg
@@ -84,4 +96,36 @@
unknowingly, it could cause anomalous or insecure behavior.
(There were no known exploits in the demo, but they could
easily be constructed.
+
+
+PROBLEMS WITH USERTAGS
+----------------------
+
+You may see the following error/warning messages when you (re)start
+Interchange:
+
+1. Duplicate usertag xxxx found.
+
+ This message is most likely to mean that you have a global "usertags"
+ directory included from your interchange.cfg file. Interchange 4.9 has a
+ new location (code/UserTag) for global UserTags. Your old globals may
+ "clash" with the new ones. Delete the old usertags that are named in the
+ error messages. As always, it is recommended that you back up everything
+ before you start.
+
+ This message will also be raised if Interchange notices two local UserTags
+ with the same name. If this is detected then rename or delete one of the
+ two UserTags.
+
+2. Local usertag xxxx overrides global definition.
+
+ This message is most likely to refer to your local history_scan UserTag.
+ If you have this tag definition in your catalog.cfg file then you may
+ safely delete it; Interchange 4.9 includes this as a global UserTag.
+
+ This message will also be raised if you have created a local UserTag
+ and have given it a name identical to one of the global tags (SystemTag,
+ UserTags, UI_Tag etc.) The message is only a warning as your local UserTag
+ will override the global one. If you didn't mean to override the global
+ tag of the same name then simply rename your tag and restart Interchange.