Changes between Version 8 and Version 9 of MapGuideRfc23


Ignore:
Timestamp:
Sep 28, 2007 11:40:43 AM (10 years ago)
Author:
stevedang
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • MapGuideRfc23

    v8 v9  
    1111||Last Modified||Steve Dang [[Timestamp]]||
    1212||Author||Steve Dang||
    13 ||RFC Status||adopted||
    14 ||Implementation Status||under development||
     13||RFC Status||implemented||
     14||Implementation Status||completed||
    1515||Proposed Milestone||2.0||
    1616||Assigned PSC guide(s)||(when determined)||
     
    4242Modifications need to be made to the !MapGuide server and its installer:
    4343
    44 1. The server will detect a version mismatch at startup, and throw an exception along with instructions on how to upgrade.
     44A. The server will detect a version mismatch at startup, and throw an exception along with instructions on how to upgrade.
    4545
    4646 Like other exceptions thrown at startup time, this Version Mismatch exception will stop the server from running:
     
    5151 The error message will include a brief description about the problem and a reference to the detailed upgrade documentation.
    5252
    53 2. During setup, the installer will back up the existing repositories if necessary, then run the upgrade utilities (which will do nothing if the repositories have already been upgraded). In rare/complex situation, the installer may encounter some upgrade problem (e.g. different combinations of versions of repositories, including no longer supported ones, etc.). When this happens, the installer will continue the installation without the upgrade, and at the end, it will display a brief description about the problem and a reference to the detailed upgrade documentation. Note that, the installer will need to install the upgrade utilities so that they can be run independently at a later time. This is useful when:
     53B. During setup, the installer will back up the existing repositories if necessary, then run the upgrade utilities (which will do nothing if the repositories have already been upgraded). In rare/complex situation, the installer may encounter some upgrade problem (e.g. different combinations of versions of repositories, including no longer supported ones, etc.). When this happens, the installer will continue the installation without the upgrade, and at the end, it will display a brief description about the problem and a reference to the detailed upgrade documentation. Note that, the installer will need to install the upgrade utilities so that they can be run independently at a later time. This is useful when:
    5454
    5555 * The version mismatch detected by the server or the upgrade problem encountered by the installer does occur.
    5656 * The user would like to restore previously backed up repositories, then upgrade them without rerunning the installer.
     57
     58Here are the manual steps on how to upgrade the repositories:
     59
     601. Shut down the existing !MapGuide Server (e.g. "1.2.x") if it is running.
     61
     622. Change to the !RepositoryAdmin directory (e.g. "C:\Program Files\!MapGuideOpenSource\Server\!RepositoryAdmin\" or "/usr/local/mapguide/server/RepositoryAdmin/").
     63
     643. Run !BackUpOnlineRepositories.bat (or !BackUpOnlineRepositories.sh).
     65
     664. Run !RestoreRepositories.bat (or !RestoreRepositories.sh).
     67
     685. Un-install the existing !MapGuide Server. Note that the existing repositories will not get removed.
     69
     706. Install the new !MapGuide Server (e.g. "2.0.0"). Note that the Server will fail to start if it tries to open old repositories.
     71
     727. Shut down the newly installed Server if it started successfully (because it created new repositories on a different location).
     73
     748. If the new !MapGuide Server is installed on a different location than the old one, delete the Repositories directory then copy/move the old one to the new location (e.g. "C:\Program Files\!MapGuideOpenSource\Server\Repositories\" or "/usr/local/mapguide/server/Repositories/").
     75
     769. Change to the !RepositoryAdmin directory (e.g. "C:\Program Files\!MapGuideOpenSource\Server\!RepositoryAdmin\" or "/usr/local/mapguide/server/RepositoryAdmin/").
     77
     7810. Run !UpgradeRepositories.bat (or !UpgradeRepositories.sh).
     79
     8011. Run !SetupRepositoryIndices.bat (or !SetupRepositoryIndices.sh).
     81
     8212. Restart the Server. It should successfully open the upgraded repositories.
     83
     84Note that the upgrade could take longer time if you have large repositories.
    5785
    5886== Implications ==