update release notes for v1.1.0 and bump in setup.py

RELEASE_NOTES.md

@@ -1,6 +1,102 @@
 
 # Next Release
 
+# v1.1.0
+
+## Warnings
+
+This patch introduces a few backwards-incompatible changes to database
+management.
+
+### Database Migration
+
+If you see an error message like:
+
+```
+_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 
+usr/local/lib/python2.7/site-packages/ixmp/core.py:81: in __init__
+ self._jobj = java.ixmp.Platform("Python", dbprops)
+_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 
+
+self = <jpype._jclass.at.ac.iiasa.ixmp.Platform object at 0x7ff1a8e98410>
+args = ('Python', '/tmp/kH07wz/test.properties')
+
+ def _javaInit(self, *args):
+ object.__init__(self)
+ 
+ if len(args) == 1 and isinstance(args[0], tuple) \
+ and args[0][0] is _SPECIAL_CONSTRUCTOR_KEY:
+ self.__javaobject__ = args[0][1]
+ else:
+ self.__javaobject__ = self.__class__.__javaclass__.newClassInstance(
+> *args)
+E org.flywaydb.core.api.FlywayExceptionPyRaisable: org.flywaydb.core.api.FlywayException: Validate failed: Migration checksum mismatch for migration 1
+E -> Applied to database : 1588531206
+E -> Resolved locally : 822227094
+```
+
+Then you need to update your local database. There are two methods to do so:
+
+1. Delete it (you will lose all data and need to regenerate it). The default
+ location is `~/.local/ixmp/localdb/`.
+2. Manually apply the underlying migrations. This is not particularly easy, but
+ allows you to save all your data. If you want help, feel free to get in
+ contact on the
+ [listserv](https://groups.google.com/forum/#!forum/message_ix).
+
+
+### New Property File Layout
+
+If you see an error message like:
+
+```
+usr/local/lib/python2.7/site-packages/jpype/_jclass.py:111: at.ac.iiasa.ixmp.exceptions.IxExceptionPyRaisable
+---------------------------- Captured stdout setup -----------------------------
+2018-11-13 08:15:17,410 ERROR at.ac.iiasa.ixmp.database.DbConfig:357 - missing property 'config.server.config' in /tmp/hhvE1o/test.properties
+2018-11-13 08:15:17,412 ERROR at.ac.iiasa.ixmp.database.DbConfig:357 - missing property 'config.server.password' in /tmp/hhvE1o/test.properties
+2018-11-13 08:15:17,412 ERROR at.ac.iiasa.ixmp.database.DbConfig:357 - missing property 'config.server.username' in /tmp/hhvE1o/test.properties
+2018-11-13 08:15:17,413 ERROR at.ac.iiasa.ixmp.database.DbConfig:357 - missing property 'config.server.url' in /tmp/hhvE1o/test.properties
+------------------------------ Captured log setup ------------------------------
+core.py 80 INFO launching ixmp.Platform using config file at '/tmp/hhvE1o/test.properties'
+_________________ ERROR at setup of test_add_spatial_multiple __________________
+
+ @pytest.fixture(scope="session")
+ def test_mp():
+ test_props = create_local_testdb()
+ 
+ # start jvm
+ ixmp.start_jvm()
+ 
+ # launch Platform and connect to testdb (reconnect if closed)
+> mp = ixmp.Platform(test_props)
+```
+
+Then you need to update your property configuration file. The old file looks like
+
+```
+config.name = message_ix_test_db@local
+jdbc.driver.1 = org.hsqldb.jdbcDriver
+jdbc.url.1 = jdbc:hsqldb:file:/path/to/database
+jdbc.user.1 = ixmp
+jdbc.pwd.1 = ixmp
+jdbc.driver.2 = org.hsqldb.jdbcDriver
+jdbc.url.2 = jdbc:hsqldb:file:/path/to/database
+jdbc.user.2 = ixmp
+jdbc.pwd.2 = ixmp
+```
+
+The new file should look like
+
+```
+config.name = message_ix_test_db@local
+jdbc.driver = org.hsqldb.jdbcDriver
+jdbc.url = jdbc:hsqldb:file:/path/to/database
+jdbc.user = ixmp
+jdbc.pwd = ixmp
+```
+
+## Updates
+
 - [#113](https://github.com/iiasa/message_ix/pull/113): Upgrading to MESSAGEix 1.1: improved representation of renewables, share constraints, etc.
 - [#109](https://github.com/iiasa/message_ix/pull/109): MACRO module added for initializing models to be solved with MACRO. Added scenario-based CI on circleci.
 - [#99](https://github.com/iiasa/message_ix/pull/99): Fixing an error in the compuation of the auxiliary GAMS reporting variable `PRICE_EMISSION`

setup.py

@@ -9,7 +9,7 @@
 
 
 INFO = {
- 'version': '1.0.0',
+ 'version': '1.1.0',
 }