"Fossies" - the Fresh Open Source Software Archive

Member "orientdb-3.2.19/upgrade.txt" (11 May 2023, 5752 Bytes) of package /linux/misc/orientdb-3.2.19.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1            .                                          
    2           .`        `                                 
    3           ,      `:.                                  
    4          `,`    ,:`                                   
    5          .,.   :,,                                    
    6          .,,  ,,,                                     
    7     .    .,.:::::  ````                                 :::::::::     :::::::::
    8     ,`   .::,,,,::.,,,,,,`;;                      .:    ::::::::::    :::    :::
    9     `,.  ::,,,,,,,:.,,.`  `                       .:    :::      :::  :::     :::
   10      ,,:,:,,,,,,,,::.   `        `         ``     .:    :::      :::  :::     :::
   11       ,,:.,,,,,,,,,: `::, ,,   ::,::`   : :,::`  ::::   :::      :::  :::    :::
   12        ,:,,,,,,,,,,::,:   ,,  :.    :   ::    :   .:    :::      :::  :::::::
   13         :,,,,,,,,,,:,::   ,,  :      :  :     :   .:    :::      :::  :::::::::
   14   `     :,,,,,,,,,,:,::,  ,, .::::::::  :     :   .:    :::      :::  :::     :::
   15   `,...,,:,,,,,,,,,: .:,. ,, ,,         :     :   .:    :::      :::  :::     :::
   16     .,,,,::,,,,,,,:  `: , ,,  :     `   :     :   .:    :::      :::  :::     :::
   17       ...,::,,,,::.. `:  .,,  :,    :   :     :   .:    :::::::::::   :::     :::
   18            ,::::,,,. `:   ,,   :::::    :     :   .:    :::::::::     ::::::::::
   19            ,,:` `,,.                                  
   20           ,,,    .,`                                  
   21          ,,.     `,                                          GRAPH DATABASE   
   22        ``        `.                                   
   23                  ``                                   
   24                  `                                    
   25 ***********************************************************************************************************************
   26                               ORIENT DATABASE  http://www.orientechnologies.com
   27 ***********************************************************************************************************************
   28 
   29  UPGRADE GUIDE
   30 ----------------
   31 
   32  Semantic Versioning System
   33 -----------------------------
   34 
   35 OrientDB uses the Semantic Versioning System (http://semver.org) where given a version number MAJOR.MINOR.PATCH,
   36 increment the:
   37 
   38 - MAJOR version when you make incompatible API changes,
   39 - MINOR version when you add functionality in a backwards-compatible manner
   40 - PATCH version when you make backwards-compatible bug fixes.
   41 
   42 So between PATCH versions the compatibility is assured (example 1.4.0 -> 1.4.1). Between MINOR and MAJOR versions you
   43 could export and re-import the database. See below in the column "Database":
   44 
   45 
   46   Compatibility Matrix
   47  ---------------------------
   48 
   49 +--------+-------+--------------------------------------------+-----------+----------+----------+
   50 |        |       |                   API                      |           | BINARY   | HTTP     |
   51 |  FROM  |  TO   |--------------------------------------------+ DATABASE  | NETWORK  | NETWORK  |
   52 |        |       | Blueprints | Document | Object | Nat.Graph |           | PROTOCOL | PROTOCOL |
   53 +--------+-------+------------+----------+--------+-----------+-----------+----------+----------+
   54 | 1.4.x  | 1.5.x | Changed    |   OK     |   OK   |    OK     | Automatic | 16, 17   | 10       |
   55 |        |       | v. 2.4.x   |          |        |           |           |          |          |
   56 +--------+-------+------------+----------+--------+-----------+-----------+----------+----------+
   57 | 1.3.x  | 1.4.x | Changed    |   OK     |   OK   |    OK     | Automatic | 14, 15   | n.a.     |
   58 |        |       | v. 2.3.x   |          |        |           |           |          |          |
   59 +--------+-------+------------+----------+--------+-----------+-----------+----------+----------+
   60 | 1.2.x  | 1.3.x | Changed    |   OK     |   OK   |    OK     | Export &  | 12, 13   | n.a.     |
   61 |        |       | v. 2.2.x   |          |        |           | Re-import |          |          |
   62 +--------+-------+------------+----------+--------+-----------+-----------+----------+----------+
   63 
   64 References:
   65 
   66 - Binary Network Protocol: https://github.com/orientechnologies/orientdb/wiki/Network-Binary-Protocol
   67 - HTTP Network Protocol: https://github.com/orientechnologies/orientdb/wiki/OrientDB-REST
   68  
   69 
   70  Migrate from LOCAL storage engine to PLOCAL
   71 ---------------------------------------------
   72 
   73 1) Open a new shell (Linux/Mac) or a Command Prompt (Windows)
   74 
   75 2) export the database using the console. Example by exporting the database under /temp/db:
   76 
   77    > bin/console.sh (or bin/console.bat under Windows)
   78    orientdb> connect database local:/temp/db admin admin
   79    orientdb> export database /temp/db.json.gzip
   80    orientdb> disconnect
   81 
   82 3) now always in the console create a new database using the "plocal" engine:
   83 
   84    a) on a local filesystem:
   85 
   86       orientdb> create database plocal:/temp/newdb admin admin plocal graph
   87 
   88    b) on a remote server (use the server's credentials to access):
   89 
   90       orientdb> create database remote:localhost/newdb root password plocal graph
   91 
   92 4) now always in the console import the old database in the new one:
   93 
   94    orientdb> import database /temp/db.json.gzip -preserveClusterIDs=true
   95    orientdb> quit
   96 
   97 
   98   API history
   99  ----------------------
  100  - 1.4.x Blueprints becomes the new standard API for the Graph Database. All the GraphDB APIs are deprecated
  101 
  102 
  103 
  104  Information 
  105 --------------
  106 
  107 For more information visit the official website: http://www.orientdb.org.
  108 
  109 Remember OrientDB is an Open Source project released with the Apache v2 license,
  110 so it's always FREE for any purpose. If you're interested to Enterprise tools,
  111 professional support, training or consultancy contact: info@orientechnologies.com.
  112 
  113 Enjoy with Graphs,
  114 Orient Technologies
  115 The company behind OrientDB
  116 (www.orientechnologies.com)