> For the complete documentation index, see [llms.txt](https://docs.zenon.org/hypercore/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zenon.org/hypercore/technical/roles/pillar/update-guide.md).
# Update Guide
### Table of Contents
1. [Prerequisites](#prerequisites)
2. [Stop the `znnd` Service](#stop-the-znnd-service)
3. [Download the Latest `znn-controller`](#download-the-latest-znn-controller)
4. [Replace the Existing `znn-controller` File](#replace-the-existing-znn-controller-file)
5. [Deploy the Updated Controller](#deploy-the-updated-controller)
6. [Verify the Update](#verify-the-update)
***
### 1) Prerequisites
Before proceeding with the update, ensure you have the following:
* **Access Credentials**: SSH access to your server with sudo privileges.
* **Basic Knowledge**: Familiarity with command-line interfaces and server management.
* **Backup**: It's recommended to back up your current configuration and controller files before performing the update.
***
### 2) Stop the `znnd` Service
1. **Access Your Server via SSH**:
Open your terminal and connect to your server using SSH:
ssh username@your_server_ip
\
\
Replace `username` with your server's username (commonly `root`) and `your_server_ip` with your server's IP address.\
2. **Stop the `znnd` Service**:
Run the `znn-controller` executable and select the option to `Stop Service` the `znnd` service.
```bash
./znn-controller
```
* **Interactive Prompt**:
```mathematica
1) Deploy
2) Status
3) Start service
4) Stop service
5) Resync
6) Help
7) Quit
Select an option from the ones listed above
```
* **Action**:
* Enter `4` and press `Enter` to stop the running the `znnd` service.
\
**Note**: Ensure the service has completely stopped before proceeding to the next step. You can enter `2` and press `Enter` to verify the Status of the `znnd` service.
***
### 3) Download the Latest `znn-controller`
1. **Identify the Latest Release URL**:
Visit the [Zenon Network GitHub Repository](https://github.com/zenon-network/znn_controller_dart/releases) to find the latest version of the `znn-controller`. Copy the download URL for the x86/64 Linux release.\
2. **Download the Latest Controller**:
Replace `YOUR_LATEST_URL` with the actual URL of the latest `znn-controller` release.
```bash
wget -O znn_controller-linux-x86_64.zip YOUR_LATEST_URL
```
\
**Example**:
```bash
wget -O znn_controller-linux-x86_64.zip https://github.com/zenon-network/znn_controller_dart/releases/download/v0.0.5-beta/znn_controller-linux-x86_64.zip
```
***
### 4) Replace the Existing `znn-controller` File
* **Extract the Downloaded ZIP File**:
```bash
unzip -o znn_controller-linux-x86_64.zip
```
* **`-o` Flag**: Overwrites existing files without prompting.\
* **Remove the ZIP File**:
```bash
rm znn_controller-linux-x86_64.zip
```
***
### 5) Deploy the Updated Controller
* **Run the Updated `znn-controller`**:
```bash
./znn-controller
```
* **Deployment Options**:
Upon execution, you will be presented with deployment options:
```mathematica
1) Deploy
2) Status
3) Start service
4) Stop service
5) Resync
6) Help
7) Quit
Select an option from the ones listed above
```
* **Select Deploy Option**:
* **Action**: Enter `1` and press `Enter` to deploy the updated controller.
* **Continue Using Existing Configuration**:
* **Prompt**:
```mathematica
Continue using the existing configuration? (Y/N):
```
* **Action**: Enter `Y` and press `Enter` to confirm.
***
### 6) Verify the Update
* **Check the Status of the Controller**:
Run the `znn-controller` and select the status option to verify that the update was successful.
```bash
./znn-controller
```
* **Interactive Prompt**:
```mathematica
1) Deploy
2) Status
3) Start service
4) Stop service
5) Resync
6) Help
7) Quit
Select an option from the ones listed above
```
* **Action**: Enter `2` and press `Enter` to view the current status.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://docs.zenon.org/hypercore/technical/roles/pillar/update-guide.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.