blob: da84013365ccae00db618c652ab2c61c40b0a78c [file] [log] [blame]
Shawn O. Pearcec20e2832010-02-17 09:16:26 -08001Release notes for Gerrit 2.0.13, 2.0.13.1
2=========================================
3
4Gerrit 2.0.13.1 is now available in the usual location:
5
6link:http://code.google.com/p/gerrit/downloads/list[http://code.google.com/p/gerrit/downloads/list]
7
8*WARNING: This version contains a major configuration change.*
9
10The schema upgrade needs to run in multiple parts. Apply the first half:
11----
12 java -jar gerrit.war --cat sql/upgrade011_012_part1.sql | psql reviewdb
13----
14
15Now convert the system_config table to `$site_path/gerrit.config`.
16----
17 java -jar gerrit.war ConvertSystemConfig
18----
19or, do this conversion by hand. See below for the mapping.
20
21After verifying `$site_path/gerrit.config` is correct for your installation, drop the old columns from the system_config table. *This causes configuration data loss.*
22----
23 java -jar gerrit.war --cat sql/upgrade011_012_part2.sql | psql reviewdb
24----
25
26Configuration Mapping
27---------------------
28|| *system_config* || *$site_path/gerrit.config* ||
29|| max_session_age || auth.maxSessionAge ||
30|| canonical_url || gerrit.canonicalWebUrl ||
31|| gitweb_url || gitweb.url ||
32|| git_base_path || gerrit.basePath ||
33|| gerrit_git_name || user.name ||
34|| gerrit_git_email || user.email ||
35|| login_type || auth.type ||
36|| login_http_header || auth.httpHeader ||
37|| email_format || auth.emailFormat ||
38|| allow_google_account_upgrade || auth.allowGoogleAccountUpgrade ||
39|| use_contributor_agreements || auth.contributorAgreements ||
40|| sshd_port || sshd.listenAddress ||
41|| use_repo_download || repo.showDownloadCommand ||
42|| git_daemon_url || gerrit.canonicalGitUrl ||
43|| contact_store_url || contactstore.url ||
44|| contact_store_appsec || contactstore.appsec ||
45
46See also [http://gerrit.googlecode.com/svn/documentation/2.0/config-gerrit.html Gerrit2 Configuration].
47
48New Features
49------------
50* GERRIT-180 Rewrite outgoing email to be more user friendly
51+
52A whole slew of feature improvements on outgoing email formatting was closed by this one (massive) rewrite of the outgoing email implementation.
53
54* GERRIT-187 Make n/p jump to last/first line if no more hunks are ...
55+
56When in a patch view (side by side or unified) new key bindings n/p jump to the previous or next hunk, which is very useful if you have context set to Whole File.
57
58* GERRIT-59 Add Next/Previous/Up links to the PatchScreen
59+
60Patch views now contain links to the next and previous file in the patch set, as well as back up to the change. This has been a very long standing UI glitch that is finally resolved.
61
62* Add "gerrit show-queue" to display the work queue
63* GERRIT-110 Add admin command "gerrit replicate" to force resync a...
64* Document all server side command line tools
65+
66There are new admin commands available over SSH, and all commands are now documented online. See [http://gerrit.googlecode.com/svn/documentation/2.0/cmd-index.html Command Line Tools]. The new `gerrit replicate` is very useful when a slave goes offline for a bit, and returns later.
67
68* Add remote.`<`name`>`.replicationdelay to control delay
69* GERRIT-110 Automatically replicate all projects at startup
70* GERRIT-110 Allow replication to match only some hosts
71* GERRIT-200 Schedule replication by remote, not by project
72+
73Replication has been made more robust by allowing the administrator to control the delay, as to isolate replication scheduling into different pools. This is very useful when replicating to multiple sites, e.g. to a warm-spare in the same data center, and to a far away slave in another country. Gerrit also now forces a full replication on startup, to ensure all slaves are consistent.
74
75* Move sshd_port to gerrit.config as sshd.listenaddress
76+
77The internal SSHD can now be bound to any IP address/port combinations, which can be useful if the system has multiple virtual IP addresses on a single network interface.
78
79* Switch from Java Mail to Apache Commons NET basic SMTP...
80* Block rcpt to addresses not on a whitelist
81+
82The new `sendemail` section of `$site_path/gerrit.config` now controls the configuration of the outgoing SMTP server, rather than relying upon a JNDI resource. See [http://gerrit.googlecode.com/svn/documentation/2.0/config-gerrit.html configuration] section sendemail for more details.
83
84Bug Fixes
85---------
86* Fix file browser in patch that is taller than the wind...
87* GERRIT-184 Make 'f' toggle the file browser popup closed
88* GERRIT-188 Fix key bindings in patch when changing the old or new...
89* GERRIT-211 Remove spurious whitespace from blank lines in diff vi...
90* GERRIT-196 Fix CSS styling on the history table
91* GERRIT-193 Automatically switch from empty side-by-side to unifie...
92+
93Misc. bug fixes on the patch view screens that I identified after the 2.0.12 release.
94
95* GERRIT-182 Don't NPE when the remote peer address isn't yet known
96* GERRIT-192 Fix NPE in MergeOp when submit to new branch fails due...
97* GERRIT-207 Fix StackOverflowError during cherry-pick submit
98+
99Misc. internal bugs, primarily caused by stupid programming mistakes.
100
101* Invalid sshkeys cache entries when the sshUserName cha...
102+
103If a user tried to connect with the wrong user name, then tried to change their SSH User Name through the web UI (by selecting a different preferred email address), the negative cache entry created during their first connection attempt was stuck in the cache and future connections were still rejected. Gerrit now flushes both the old and the new user name cache entries when the user name changes.
104
105* GERRIT-210 Allow MINA SSHD to log about host key creation
106* Make SSH host key loading more consistent over time
107+
108It has been pointed out several times that its unclear why Gerrit keeps changing its host key with each startup; this is due to a failure to write the generated host key to disk. We now log about it, and make it less likely that other sorts of configuration modifications would cause an unexpected host key change.
109
110* Always run SSH replication in BatchMode
111* Special case NoRemoteRepository during replication
112* Simplify error logged for invalid URLs in replication....
113* Special case UnknownHostKey during replication
114* Allow replication.config to drive the thread pool larg...
115* Fix treatment of symbolic refs in PushOp
116+
117A bunch of bug fixes related to error handling during replication. Errors are now logged in a more clear fashion, which should help administrators to debug replication problems.
118
119* Restore Ctrl-Backspace in comment editor
120* Use server name for ssh_info instead of local address
121* Use server name for advertised SSH host keys
122* Don't reverse resolve CNAMEs when advertising our SSHD
123+
124Bug fixes identified after release of 2.0.13, rolled into 2.0.13.1.
125
126Other Changes
127-------------
128* Start 2.0.13 development
129* Use gwtexpui 1.1.1-SNAPSHOT
130* Document the Patch.PatchType and Patch.ChangeType enum
131* Document the Change.Status enum
132* Remove useless boolean return value from ChangeMail he...
133* Remove pointless null assignment from PatchScreen
134* Move ChangeMail into its own server side package
135* Fix patch set replacement emails to correctly retain r...
136* Document ReviewDb.nextChangeMessageId
137* Document some of the core database entity graph
138* Rewrite the replication documentation
139* Add an anchor for Other Servlet Containers
140* Fix minor formatting style nit in PushQueue
141* Extract the PushOp logic from PushQueue
142* Refactor PushQueue.scheduleUpdate to be smaller methods
143* Refactor WorkQueue to support task inspection
144* Reload the submit queue on startup with a 15 second de...
145* Move the per-command ReviewDb handle up to AbstractCom...
146* Don't attempt to replicate the magic "-- All Projects ...
147* Document that remote.<name>.uploadpack is also support...
148* Correct the defaults for remote uploadpack, receivepack
149* Use a HashSet for the active tasks, rather than a List
150* Use gwtorm 1.1.1-SNAPSHOT
151* Remove references in documentation to My>Settings
152* Mention 'git receive-pack' --cc/--reviewer args
153* Fix NPE in "gerrit replicate --all"
154* Put a link back to the index in every page footer
155* Document the other standard caches
156* Delete now unnecessary ImportProjectSubmitTypes
157* Don't start background queues during command line tools
158* Create GerritConfig after parsing gerrit.config file
159* Create a utility to export system_config to gerrit.con...
160* Move contact store configuration to gerrit.config
161* Move gerrit_git_email,gerrit_git_name to gerrit.config
162* Move authentication fields from system_config to gerri...
163* Move gitwebUrl to gerrit.config
164* Move use_repo_download to gerrit.config
165* Move canonical_url, git_daemon_url to gerrit.config
166* Move git_base_path to gerrit.config
167* Document where the nextval_project_id function is for ...
168* Use gwtorm, gwtexpui 1.1.1 final versions
169* Add sendemail.enable to disable email output
170* Use mvn -offline mode when running ./to_hosted.sh
171* Disable AES192CBC and AES256CBC if unlimited cryptogra...
172* gerrit 2.0.13