open-horizon.github.io icon indicating copy to clipboard operation
open-horizon.github.io copied to clipboard

Documentation📄: RISC-V documentation updates

Open johnwalicki opened this issue 3 years ago • 24 comments

What is the current documentation state?

When Open Horizon is supported on the RISC-V platform, we should add RISC-V to the documentation.

Where is this stated?

No response

Why do you want to improve the statement?

No response

Proposed Statement

No response

Additional context.

No response

johnwalicki avatar Mar 22 '22 00:03 johnwalicki

@johnwalicki A little more description on the issue would be really helpful

YashKamboj avatar May 04 '22 18:05 YashKamboj

@YashKamboj part of the problem is that we don't have a definitive list of all of the pages that should be modified to include listing support for a new environment (operating system and/or architecture). As part of this issue, it would be helpful to review every page in the documentation to see if they mention OS or arch and compile a list.

That's likely a reason why this is not labeled "good first issue". :)

joewxboy avatar May 04 '22 18:05 joewxboy

  1. Need to modify _data/keyword.yml to add term for RISC-V, key likely "riscv64".
  2. Need to search for all pages that are candidates for term inclusion. Try searching for "linux_ppc64le" as a starting point. Only found it in two files besides the keywords:
  docs/installing/adding_devices.md
  docs/installing/advanced_man_install.md

joewxboy avatar Jul 27 '22 19:07 joewxboy

Hi @joewxboy I think we can help on it. Sorry that we've been too busy on our daily job in the past months and haven't got time on risc-v related work. But I think we can resume it from Oct., and build the doc and any needed code changes for risc-v support in OH.

davidyao19 avatar Sep 21 '22 04:09 davidyao19

Hi @davidyao19 - Thanks! We are very interested in getting Open Horizon running on RISC-V hardware.

johnwalicki avatar Sep 29 '22 00:09 johnwalicki

I recently saw that Pine64 is working on a RISC-V board. I might buy one of these when they become available: https://liliputing.com/pine64-is-working-on-a-risc-v-single-board-computer/

johnwalicki avatar Sep 29 '22 00:09 johnwalicki

We might see affordable risc-v boards early in 2023 https://www.phoronix.com/news/Ubuntu-StarFive-VisionFive-2

johnwalicki avatar Nov 22 '22 23:11 johnwalicki

There's a $88 USD board - starting to ship : https://ameridroid.com/products/visionfive-2?variant=40845950910498

johnwalicki avatar Feb 03 '23 14:02 johnwalicki

I follow the development of the Pine Star64 SBC - https://www.pine64.org/category/star64/

johnwalicki avatar Feb 03 '23 14:02 johnwalicki

Latest news about the Pine Star64 SBC - https://www.pine64.org/2023/03/01/february-update-things-are-taking-shape/

  • We expect to have the Star64 available in March or beginning of April
  • We had a working demo of Debian with XFCE at FOSDEM (thanks to ayufan)
  • There is much interest in RISC-V platform and Star64 in particular
  • The software on RISC-V is in early stages
  • Star64’s significance: we believe that affordable RISC-V hardware will drive Linux development on the platform

johnwalicki avatar Mar 01 '23 17:03 johnwalicki

https://www.phoronix.com/news/ASUS-Tinker-V

johnwalicki avatar Mar 23 '23 03:03 johnwalicki

https://pine64.com/product/star64-model-a-4gb-single-board-computer/

johnwalicki avatar Apr 05 '23 03:04 johnwalicki

@joewxboy I just bought a Star64 board. I will be interested to test the Open Horizon agent on it. https://pine64.com/product/star64-model-a-4gb-single-board-computer/

johnwalicki avatar Apr 06 '23 14:04 johnwalicki

@johnwalicki That sold out quickly! I was able to order one of these: https://www.amazon.com/dp/B0BQYDTM9M?ref=myi_title_dp which should arrive in a month or so.

joewxboy avatar Apr 08 '23 01:04 joewxboy

In addition to the Star64 board (which hasn't arrived yet), I purchased a MangoPi 1GHz 1GB Allwinner D1 RISC-V board. It arrived and I've got it running Ubuntu Jammy

Linux nezha 5.19.0-rc1-d1 #trunk Fri Jul 22 12:44:22 MSK 2022 riscv64 riscv64 riscv64 GNU/Linux

I tried to install docker but there are no prebuilt docker binaries for the RISC-V architecture. Instead, I was able to apt install podman

$ sudo podman version
Version:      3.4.4
API Version:  3.4.4
Go Version:   go1.17.3
Built:        Wed Dec 31 19:00:00 1969
OS/Arch:      linux/riscv64

johnwalicki avatar May 18 '23 02:05 johnwalicki

Podman on RISC-V is running.

$ sudo podman run hello-world

Hello from Docker!
This message shows that your installation appears to be working correctly.

The next step is to compile the anax and hzn binaries for riscv64

johnwalicki avatar May 18 '23 02:05 johnwalicki

My Pine STAR64 arrived last week. I have it running

Linux star64 5.15.107 #1 SMP Mon May 15 17:57:25 UTC 2023 riscv64 riscv64 riscv64 GNU/Linux

but it will take some effort to get docker / podman installed on this Yocto based image.

johnwalicki avatar May 23 '23 01:05 johnwalicki

I've got a Lichee Pi4 RISC-V board that I'm trying to install the horizon agent on. I've been hacking at the agent-install.sh script. Have it working all the way to downloading the agent binaries.

2024-07-28 21:08:15 Downloading file https://cp-console.ieam42-edge-8e....us-south.containers.appdomain.cloud/edge-css/api/v1/objects/IBM/agent_files/horizon-agent-linux-deb-riscv64.tar.gz/data ...
2024-07-28 21:08:15 ERROR: HTTP code 403 from: downloading https://cp-console.ieam42-edge-8e....us-south.containers.appdomain.cloud/edge-css/api/v1/objects/IBM/agent_files/horizon-agent-linux-deb-riscv64.tar.gz/data, stdout: Unauthorized. The object may not exist or be public.

Looks like I will have to compile the agent binaries myself? I don't see the riscv64 binaries available in any of the anax release packages https://github.com/open-horizon/anax/releases/

Before I go down that journey, has anyone compiled the agent binaries for risc-v? @joewxboy @dlarson04

johnwalicki avatar Jul 28 '24 21:07 johnwalicki

@johnwalicki riscv64 is not an architecture that is currently being built

dlarson04 avatar Jul 28 '24 22:07 dlarson04

@bencourliss We had discussed adding RISC-V to the packages being built. Any idea where that stands currently? Are there any impediments or roadblocks?

joewxboy avatar Jul 29 '24 12:07 joewxboy

@joewxboy Are we talking just the Debian and RPM packages? For the GitHub Action, we use https://github.com/uraimo/run-on-arch-action to build the non-amd64 architectures. It appears that riscv64 is a supported architecture so theoretically we can support building it. Would require changes to the Github Action workflow and the release process needs to be changed to publish those packages once built. I don't believe there is a UBI9 Docker base image available for riscv64 however.

bencourliss avatar Jul 29 '24 12:07 bencourliss

@joewxboy Are we talking just the Debian and RPM packages? ... I don't believe there is a UBI9 Docker base image available for riscv64 however.

@johnwalicki any feedback for Ben?

joewxboy avatar Jul 29 '24 13:07 joewxboy

@joewxboy @bencourliss - Do you really need UBI9 containers to build the hzn and anax binaries? Those would only be needed for the anax-in-container makefiles. You could skip the anax-in-container step initially.

johnwalicki avatar Jul 29 '24 16:07 johnwalicki

Tracking riscv64 architecture support in this issue https://github.com/open-horizon/anax/issues/4125

johnwalicki avatar Jul 30 '24 22:07 johnwalicki