Skip to content

Commit

Permalink
V27.1 Release Documentation (#708)
Browse files Browse the repository at this point in the history
* Create release-v27-1.md

* Update release-v27-1.md

Fixing V27.0 major updates link

* Update release-v27-1.md

Updating v27.0 major-updates link

* Update release-v27-0.md

Fixing minor typo in page description

* Create release-details-v27-1.md

* Update release-details-v27-1.md

* Update release-details-v27-0.md

Update protocol & db version for V27

* Update release-details-v27-1.md

Removing V27.0 milestone link

* Update node-releases.md

Updating current release to V27.1

* Update current-build-links-main.md

Updating build links to V27.1

* Update current-build-links-test.md

Updating test build links to V27.1

* Update mkdocs.yml

Update for V27.1

* Update main.html

Update release notification banner to V27.1
  • Loading branch information
qwahzi authored Sep 9, 2024
1 parent e893f52 commit c8f169c
Show file tree
Hide file tree
Showing 9 changed files with 71 additions and 18 deletions.
6 changes: 5 additions & 1 deletion docs/releases/node-releases.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Updates to the Nano protocol are done through major node releases, occurring app
## Current Release
The following release is the latest and only release actively supported by the Nano Foundation. This release and the [Active Releases](#active-releases) below represent the only node versions that will participate on the main network. More details can be found on the [Current Release Notes page](/releases/current-release-notes).

--8<-- "release-details-v27-0.md"
--8<-- "release-details-v27-1.md"

**Builds and Commands**

Expand All @@ -31,6 +31,10 @@ The following release is currently under development. Details about potential fe
## Active Releases
The following releases can still actively participate on the network by peering with other nodes of the same versions. Any nodes running versions earlier than these will no longer peer with the latest and fall out of sync with the network.

--8<-- "release-details-v27-1.md"

---

--8<-- "release-details-v27-0.md"

---
Expand Down
2 changes: 1 addition & 1 deletion docs/releases/release-v27-0.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
title: Release notes - V27.0 nano node
description: Details of the V7.0 nano node release.
description: Details of the V27.0 nano node release.

# V27.0

Expand Down
45 changes: 45 additions & 0 deletions docs/releases/release-v27-1.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
title: Release notes - V27.1 nano node
description: Details of the V27.1 nano node release.

# V27.1

--8<-- "release-details-v27-1.md"

---

## Upgrade notices

All nodes are encouraged to upgrade to V27.1, including exchanges.

In general, exchanges, services and integrations are encouraged to join [the test network](../running-a-node/test-network.md) for performing integration testing. This network mimics the live network in work requirements but has a smaller number of nodes and a lower block count for easier setup.

### Database upgrade

If you are upgrading from previous versions (e.g. V26), V27 includes a one-way database upgrade that takes a few minutes to run.

If you are upgrading from V27.0, there is no additional database upgrade.

### gcc-12 users

If your system uses gcc-12 there is a known bug in the compiler optimiser that has problems compiling c++20 code.

If you get a compiler error related to -Wrestrict, it's recomended to either downgrade to gcc-11 or upgrade to gcc-13 to compile the node. See more [detail here](https://gcc.gnu.org/bugzilla/show_bug.cgi?id=105329). Debian 12 (bookworm) ships with gcc-12 by default, but has a package for gcc-11.

---

## Major updates

See the [V27.0 release notes](release-v27-0.md#major-updates) for the major updates list.

---

## Fixes

* [Bounding the growth of the election_winner_details set](https://github.com/nanocurrency/nano-node/pull/4720)
* [Cementing fixes](https://github.com/nanocurrency/nano-node/pull/4722)

---

## Builds and commands

--8<-- "current-build-links-main.md"
12 changes: 6 additions & 6 deletions docs/snippets/current-build-links-main.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
| OS | Download link/command | Verification |
|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------|
| Universal Linux | https://repo.nano.org/live/binaries/nano-node-V27.0-Linux.tar.bz2 | [SHA256 Checksum](https://repo.nano.org/live/binaries/nano-node-V27.0-Linux.tar.bz2.sha256) |
| Debian | https://repo.nano.org/live/binaries/nano-node-V27.0-Linux.deb | [SHA256 Checksum](https://repo.nano.org/live/binaries/nano-node-V27.0-Linux.deb.sha256) |
| macOS | https://repo.nano.org/live/binaries/nano-node-V27.0-Darwin.dmg | [SHA256 Checksum](https://repo.nano.org/live/binaries/nano-node-V27.0-Darwin.dmg.sha256) |
| Windows (exe) | https://repo.nano.org/live/binaries/nano-node-V27.0-win64.exe | [SHA256 Checksum](https://repo.nano.org/live/binaries/nano-node-V27.0-win64.exe.sha256) |
| Windows (zip) | https://repo.nano.org/live/binaries/nano-node-V27.0-win64.zip | [SHA256 Checksum](https://repo.nano.org/live/binaries/nano-node-V27.0-win64.zip.sha256) |
| Docker | `docker pull nanocurrency/nano:V27.0`<br />See [Pulling the Docker Image](/running-a-node/node-setup/#pulling-the-docker-image) for more details. | |
| Universal Linux | https://repo.nano.org/live/binaries/nano-node-V27.1-Linux.tar.bz2 | [SHA256 Checksum](https://repo.nano.org/live/binaries/nano-node-V27.1-Linux.tar.bz2.sha256) |
| Debian | https://repo.nano.org/live/binaries/nano-node-V27.1-Linux.deb | [SHA256 Checksum](https://repo.nano.org/live/binaries/nano-node-V27.1-Linux.deb.sha256) |
| macOS | https://repo.nano.org/live/binaries/nano-node-V27.1-Darwin.dmg | [SHA256 Checksum](https://repo.nano.org/live/binaries/nano-node-V27.1-Darwin.dmg.sha256) |
| Windows (exe) | https://repo.nano.org/live/binaries/nano-node-V27.1-win64.exe | [SHA256 Checksum](https://repo.nano.org/live/binaries/nano-node-V27.1-win64.exe.sha256) |
| Windows (zip) | https://repo.nano.org/live/binaries/nano-node-V27.1-win64.zip | [SHA256 Checksum](https://repo.nano.org/live/binaries/nano-node-V27.1-win64.zip.sha256) |
| Docker | `docker pull nanocurrency/nano:V27.1`<br />See [Pulling the Docker Image](/running-a-node/node-setup/#pulling-the-docker-image) for more details. | |
| RHEL/RockyLinux rpm | Not available anymore. Please check [Build Options](#build-options) for build instructions. | |
12 changes: 6 additions & 6 deletions docs/snippets/current-build-links-test.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
| OS | Download link/command |
|---------------------|------------------------------------------------------------------|
| Universal Linux | https://repo.nano.org/test/binaries/nano-node-V27.0-Linux.tar.bz2 |
| Debian | https://repo.nano.org/test/binaries/nano-node-V27.0-Linux.deb |
| macOS | https://repo.nano.org/test/binaries/nano-node-V27.0-Darwin.dmg |
| Windows (exe) | https://repo.nano.org/test/binaries/nano-node-V27.0-win64.exe |
| Windows (zip) | https://repo.nano.org/test/binaries/nano-node-V27.0-win64.zip |
| Docker | `docker pull nanocurrency/nano-test:V27.0` |
| Universal Linux | https://repo.nano.org/test/binaries/nano-node-V27.1-Linux.tar.bz2 |
| Debian | https://repo.nano.org/test/binaries/nano-node-V27.1-Linux.deb |
| macOS | https://repo.nano.org/test/binaries/nano-node-V27.1-Darwin.dmg |
| Windows (exe) | https://repo.nano.org/test/binaries/nano-node-V27.1-win64.exe |
| Windows (zip) | https://repo.nano.org/test/binaries/nano-node-V27.1-win64.zip |
| Docker | `docker pull nanocurrency/nano-test:V27.1` |
| RHEL/RockyLinux rpm | Not available anymore. Please check [Build Options](#build-options) for build instructions. |
2 changes: 1 addition & 1 deletion docs/snippets/release-details-v27-0.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
| Node | Protocol | Database | Release Date | Release Notes | GitHub Links |
| | | | | | |
| 27.0 | TBD | TBD | TBD | [V27.0](../releases/release-v27-0.md) | [Release](https://github.com/nanocurrency/nano-node/releases/tag/V27.0) - [Milestone](https://github.com/nanocurrency/nano-node/milestone/33) - [Changelog](https://github.com/nanocurrency/nano-node/compare/V26.1...V27.0) |
| 27.0 | 21 | 24 | TBD | [V27.0](../releases/release-v27-0.md) | [Release](https://github.com/nanocurrency/nano-node/releases/tag/V27.0) - [Milestone](https://github.com/nanocurrency/nano-node/milestone/33) - [Changelog](https://github.com/nanocurrency/nano-node/compare/V26.1...V27.0) |
3 changes: 3 additions & 0 deletions docs/snippets/release-details-v27-1.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
| Node | Protocol | Database | Release Date | Release Notes | GitHub Links |
| | | | | | |
| 27.1 | 21 | 24 | TBD | [V27.1](../releases/release-v27-1.md) | [Release](https://github.com/nanocurrency/nano-node/releases/tag/V27.1) - Milestone - [Changelog](https://github.com/nanocurrency/nano-node/compare/V27.0...V27.1) |
5 changes: 3 additions & 2 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -92,7 +92,8 @@ nav:
- Releases:
- Node Releases: releases/node-releases.md
- Release Notes:
- V27.0 (Latest): releases/release-v27-0.md
- V27.1 (Latest): releases/release-v27-1.md
- V27.0: releases/release-v27-0.md
- V26.1: releases/release-v26-1.md
- V26.0: releases/release-v26-0.md
- V25.1: releases/release-v25-1.md
Expand Down Expand Up @@ -207,5 +208,5 @@ plugins:
'what-is-nano/exploring-more.md': 'what-is-nano/overview.md'
'releases/roadmap.md': 'https://github.com/orgs/nanocurrency/projects/27'
'releases/upcoming-features.md': 'https://github.com/orgs/nanocurrency/projects/27'
'releases/current-release-notes.md': 'releases/release-v27-0.md'
'releases/current-release-notes.md': 'releases/release-v27-1.md'
'node-implementation/contributing.md': 'core-development/overview.md'
2 changes: 1 addition & 1 deletion theme-overrides/main.html
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@
{% block announce %}
<a href="/releases/current-release-notes/" height="100">
<span class="iconify" data-icon="octicon-tag-16" data-inline="false"></span>
<span style="padding-left: 0.3em;"><strong>Nano node V27.0 now available!</strong>&nbsp;We highly recommend upgrading to
<span style="padding-left: 0.3em;"><strong>Nano node V27.1 now available!</strong>&nbsp;We highly recommend upgrading to
this version for improved network operation: efficiency and security.</span>
</div>
</a>
Expand Down

0 comments on commit c8f169c

Please sign in to comment.