[ewg] [PATCH] add upgrade section to OFED Installation Guide

[Erez Zilber]

>> >>  
>> >
>> > What would the install do if this is failing or machine hang?
>> >
>> > Tziporet
>> >
>>
>> The user will have to stop OFED at some point. If we don't stop OFED
>> while uninstalling, he will stop it later (and then the machine may hang).
>>
>> The motivation for this patch is: if the user installs OFED over an
>> older version (while the old version is running), he will eventually
>> have a new version of OFED installed with an old loaded version. This
>> may lead to strange scenarios. For example: if the user tries to load
>> iSER, modprobe will fail because iSER (from the new OFED version) cannot
>> use the loaded OFED modules (from the old version). Of course, this can
>> happen with any OFED module.
>>
>> Actually, this fix is related to bug #536. Maybe we should move this
>> discussion to bugzilla.
> 
> NAK.
> This would break e.g. systems which rely on ipoib for connectivity.

You're right.

> 
> iSER failing with clear version conflict message seems like a minor problem.
> How about just documenting this?  How about producing a message telling
> the user
> to reboot?

iSER is just an example. It can happen with any OFED component. I suggest to add the following warning to the documentation:

If the user runs an old OFED version, and upgrades to a
new version, the old version is still loaded even after
upgrading. We should warn the user about that.

Signed-off-by: Erez Zilber <erezz at voltaire.com>
---
 OFED_Installation_Guide.txt |   17 +++++++++++++----
 1 files changed, 13 insertions(+), 4 deletions(-)

diff --git a/OFED_Installation_Guide.txt b/OFED_Installation_Guide.txt
index ccc01d5..12a94da 100644
--- a/OFED_Installation_Guide.txt
+++ b/OFED_Installation_Guide.txt
@@ -16,8 +16,9 @@ Table of contents
  6.  Building OFED RPMs
  7.  IPoIB Configuration
  8.  Uninstalling OFED
- 9.  Configuration
- 10. Related Documentation
+ 9.  Upgrading OFED
+ 10. Configuration
+ 11. Related Documentation
 
 
 ==============================================================================
@@ -340,9 +341,17 @@ There are two ways to uninstall OFED:
 2) Using the script uninstall.sh. The script resides under OFED-X.X.X/
    and under the installation <prefix> directory.
 
+==============================================================================
+9. Upgrading OFED
+==============================================================================
+
+If an old OFED version is installed, it may be upgraded by installing a
+new OFED version as described in section 5. Note that if the old OFED
+version was loaded before upgrading, you need to restart OFED or reboot
+your machine in order to start the new OFED stack.
 
 ==============================================================================
-9. Configuration
+10. Configuration
 ==============================================================================
 
 Most of the OFED components can be configured or reconfigured after
@@ -362,7 +371,7 @@ Note: After the installer completes, information about the OFED
       /etc/infiniband/info.
 
 ==============================================================================
-10. Related Documentation
+11. Related Documentation
 ==============================================================================
 
 OFED documentation is located in the ofed-docs RPM.  After
-- 
1.5.2