# The "v1.4" Pallene upgrade guide (v1.3.\* to v1.4.1)

{% hint style="warning" %}
The Cronos v1.4 - "Pallene" upgrade is proposed to be scheduled at the block height of 17,155,000. Referencing estimated time can be found [here](https://explorer.cronos.org/block/countdown/17155000).

**DO NOT UPGRADE to the binary v1.4.1 before that suggested upgrade schedule.**

You might check the current block height with the [Cronos Explorer](https://explorer.cronos.org/)
{% endhint %}

## Step 0 - Don't panic

At the point of the proposed upgrade, the user will see the error message on the `cronosd` similar to the below:

```bash
ERR UPGRADE "v1.4" NEEDED at height: 17155000: {\"binaries\":{...."}}
```

**Don't panic** - The Chain will be paused to allow the majority of validators to upgrade. Validators and full node hosts will have to upgrade your Cronos nodes to the latest release binary.

### Backups

Before the upgrade, node hosts are encouraged to take a complete data backup. backup depends heavily on infrastructure, but generally, we can do this by backing up the `.cronos` directory.

## Step 1 - Get the `v1.4.1` binary

To simplify the following step, we will be using **Linux-x86** for illustration. Binary for Mac Windows with different DB and architecture are also available [here](https://github.com/crypto-org-chain/cronos/releases/tag/v1.4.1).

* Terminate the `cronosd`; afterwards, download the `1.4.1` released binaries from github:

  ```bash
  $ curl -LOJ https://github.com/crypto-org-chain/cronos/releases/download/v1.4.1/cronos_1.4.1_Darwin_x86_64.tar.gz
  $ tar -zxvf cronos_1.4.1_Darwin_x86_64.tar.gz
  ```

{% hint style="info" %}
Remarks: If you have stated `cronosd` with *systemd* service, kindly stop it by

```bash
$ sudo systemctl stop cronosd
```

And replace the binary in the location where the `ExecStart` states in Systemd Unit file.
{% endhint %}

### Step 1.1 - Verify the version

You can verify the installation by checking the version of `cronosd`, the latest version is `1.4.1`.

```bash
# check the version of cronosd
$ ./cronosd version
1.4.1
```

{% hint style="info" %}
Note for version DB users - There are config changes as covered in the [release note](https://github.com/crypto-org-chain/cronos/releases/tag/v1.4.1).

* For nodes using version DB: There is a new `versiondb` section, and it is suggested to update the `app.toml` appropriate to the upgrade of v1.4:

```
[versiondb]
# Enable defines if the versiondb should be enabled.
enable = true
```

{% endhint %}

## Step 2. - Run everything

We are ready to start the node join the network again with the new binary:

* Start `cronosd`, e.g.:

```bash
  $ ./cronosd start
```

{% hint style="info" %}
Remark: Once the `cronosd` is started we will see the message

```bash
applying upgrade "v1.4" at height: 17155000"
```

and there will be an iteration over the previous blockchain data. This process will take a while, which is depending on the size of the database and the hardware specs.
{% endhint %}

Afterwards, sit back and wait for the syncing process. You can query the node syncing status by

```bash
$ ./cronosd status 2>&1 | jq '.SyncInfo.catching_up'
```

If the above command returns `false`, it means that your node **is synced**; otherwise, it returns `true` and implies your node is still catching up.

At this step, you've successfully performed the v1.4 upgrade!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cronos.com/for-node-hosts/running-nodes/cronos-mainnet/upgrade-guide/the-v1.4-pallene-upgrade-guide-v1.3.-to-v1.4.1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.