Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
61 commits
Select commit Hold shift + click to select a range
1a3ff5e
Introduction to TinyML
dominica-of Sep 5, 2024
c8017d2
Added blog resource
dominica-of Sep 5, 2024
0ea8a80
Modified next learning path
dominica-of Sep 5, 2024
0e98db6
Minor fixes
dominica-of Sep 5, 2024
4196885
Final review
dominica-of Sep 5, 2024
ee5a2b6
Environment Setup for TinyML Development on Arm
dominica-of Sep 5, 2024
5c6ca22
Merging 2 learning paths
dominica-of Sep 17, 2024
05f4b25
Updated PyTorch version
dominica-of Sep 18, 2024
369e0c1
Final edits
dominica-of Oct 5, 2024
ff9951a
Merge branch 'ArmDeveloperEcosystem:main' into main
dominica-of Oct 5, 2024
c457778
Update env-setup-5.md
dominica-of Oct 7, 2024
5c8da85
Update env-setup-5.md
dominica-of Oct 7, 2024
5f1d596
Swift install guide
jasonrandrews Oct 8, 2024
190498e
Update swift.md
pareenaverma Oct 8, 2024
218d6a2
Merge pull request #1295 from jasonrandrews/tool-installs
pareenaverma Oct 8, 2024
a3c779f
Update Python for Windows on Arm install guide for version 3.13
jasonrandrews Oct 8, 2024
5633bed
Merge pull request #1298 from jasonrandrews/review
jasonrandrews Oct 8, 2024
2393ba2
content reviews
jasonrandrews Oct 9, 2024
b0e0973
Merge pull request #1299 from jasonrandrews/review
jasonrandrews Oct 9, 2024
0ab1df5
Update build-2.md
madeline-underwood Oct 9, 2024
7080d48
milvus RAG
zc277584121 Oct 10, 2024
c6609a0
Update _index.md
madeline-underwood Oct 10, 2024
d27ce9a
First-pass editorial.
madeline-underwood Oct 10, 2024
30085d4
docs: add Przemyslaw Wirkus to contributors.csv
PrzemekWirkus Oct 10, 2024
95aba3f
Final checks
madeline-underwood Oct 10, 2024
a69b106
Update java.md
madeline-underwood Oct 10, 2024
f00444e
Final checks
madeline-underwood Oct 10, 2024
15cf581
Editorial checks.
madeline-underwood Oct 10, 2024
85f353a
Merge pull request #1301 from madeline-underwood/patch-19
pareenaverma Oct 10, 2024
06e690b
Merge pull request #1305 from madeline-underwood/patch-20
pareenaverma Oct 10, 2024
3ec9dd2
Merge pull request #1309 from PrzemekWirkus/devel_add_przemyslaw_wirk…
jasonrandrews Oct 10, 2024
9aef8bb
Update multipass install guide
jasonrandrews Oct 11, 2024
ae42325
review glibc with LSE Learning Path
jasonrandrews Oct 11, 2024
fe2a9b0
Merge pull request #1313 from jasonrandrews/spelling
jasonrandrews Oct 11, 2024
9e08c4e
Update Hyper-V install guide and Learning Path
jasonrandrews Oct 11, 2024
35cdf91
Merge pull request #1314 from jasonrandrews/review2
jasonrandrews Oct 11, 2024
2f72c12
review Visual Studio install guide
jasonrandrews Oct 11, 2024
dc91dff
Merge pull request #1315 from jasonrandrews/review2
jasonrandrews Oct 11, 2024
262c08a
Divided Environment Setup into 3 main parts
dominica-of Oct 11, 2024
c6d9389
Update py-woa.md
madeline-underwood Oct 11, 2024
b1da748
Updated structure
dominica-of Oct 11, 2024
61487db
Merge branch 'ArmDeveloperEcosystem:main' into main
dominica-of Oct 11, 2024
495990a
Merge pull request #1311 from madeline-underwood/swift
pareenaverma Oct 11, 2024
babb20f
Merge pull request #1310 from madeline-underwood/java
pareenaverma Oct 11, 2024
be75d9c
Merge pull request #1308 from madeline-underwood/python_update
pareenaverma Oct 11, 2024
bae5968
Merge pull request #1303 from zc277584121/main
pareenaverma Oct 11, 2024
f1b7de7
Merge pull request #1312 from jasonrandrews/review
jasonrandrews Oct 11, 2024
37676d3
Reviewed and updated the Zilliz/Milvus RAG LP
pareenaverma Oct 11, 2024
66a3f3d
Merge pull request #1318 from pareenaverma/content_review
pareenaverma Oct 11, 2024
be8050c
Update contributors.csv
pareenaverma Oct 11, 2024
72dd830
Merge pull request #1293 from dominica-of/main
jasonrandrews Oct 11, 2024
e8f5e49
review of TinyML Learing Path
jasonrandrews Oct 11, 2024
1d2e547
Merge pull request #1319 from jasonrandrews/review2
jasonrandrews Oct 11, 2024
0887ae3
fix typo in Sysbox install guide
jasonrandrews Oct 14, 2024
89fffe9
Merge pull request #1322 from jasonrandrews/review
jasonrandrews Oct 14, 2024
035464c
Move Intro to TinyML Learning Path to draft.
jasonrandrews Oct 14, 2024
ffd376a
Merge pull request #1323 from jasonrandrews/review
jasonrandrews Oct 14, 2024
1457b6f
spelling fixes
jasonrandrews Oct 14, 2024
67757ef
update filtering
jasonrandrews Oct 14, 2024
6cc7663
Merge pull request #1324 from jasonrandrews/spelling
jasonrandrews Oct 14, 2024
750d663
Update _index.md
pareenaverma Oct 14, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 31 additions & 1 deletion .wordlist.txt
Original file line number Diff line number Diff line change
Expand Up @@ -3215,4 +3215,34 @@ pyplot
scheduler's
torchvision
uOps
unsqueeze
unsqueeze

ACR
Abena
Adoptium
Amanfo
Arlo
Fitbit
Milvus
Amanfo
OCTLA
OpenAg
Sysbox
TCK
TOSA
Temurin
Zhang
Zilliz
arrhythmias
ggerganov
milvus
msbuild
nestybox
pte
replug
sam
sysbox
tinyml
tvOS
watchOS
zilliz
5 changes: 3 additions & 2 deletions assets/contributors.csv
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
author,company,github,linkedin,twitter,website
Jason Andrews,Arm,jasonrandrews,jason-andrews-7b05a8,,
Pareena Verma,Arm,pareenaverma,,,
Pareena Verma,Arm,pareenaverma,pareena-verma-7853607,,
Ronan Synnott,Arm,,ronansynnott,,
Florent Lebeau,Arm,,,,
Brenda Strech,Remote.It,bstrech,bstrech,@remote_it,www.remote.it
Expand Down Expand Up @@ -39,4 +39,5 @@ Gayathri Narayana Yegna Narayanan,Arm,,,,
Alexandros Lamprineas,Arm,,,,
Annie Tallund,Arm,annietllnd,annietallund,,
Cyril Rohr,RunsOn,crohr,cyrilrohr,,
Rin Dobrescu,Arm,,,,
Rin Dobrescu,Arm,,,,
Przemyslaw Wirkus,Arm,PrzemekWirkus,przemyslaw-wirkus-78b73352,,
Binary file removed content/install-guides/_images/idle.png
Binary file not shown.
Binary file added content/install-guides/_images/multipass-gui.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed content/install-guides/_images/multipass-tray.png
Binary file not shown.
Binary file modified content/install-guides/_images/py1-woa.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified content/install-guides/_images/py2-woa.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified content/install-guides/_images/py3-woa.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
51 changes: 49 additions & 2 deletions content/install-guides/aws-copilot.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,13 +73,60 @@ To install Copilot on macOS:
curl -Lo copilot https://github.com/aws/copilot-cli/releases/latest/download/copilot-darwin && chmod +x copilot && sudo mv copilot /usr/local/bin/copilot && copilot --help
```

The help message is printed:

```output
👩‍✈️ Launch and manage containerized applications on AWS.

Commands
Getting Started 🌱
init Create a new ECS or App Runner application.
docs Open the copilot docs.

Develop ✨
app Commands for applications.
Applications are a collection of services and environments.
env Commands for environments.
Environments are deployment stages shared between services.
svc Commands for services.
Services are long-running ECS or App Runner services.
job Commands for jobs.
Jobs are tasks that are triggered by events.
task Commands for tasks.
One-off Amazon ECS tasks that terminate once their work is done.
run Run the workload locally.

Release 🚀
pipeline Commands for pipelines.
Continuous delivery pipelines to release services.
deploy Deploy one or more Copilot jobs or services.

Extend 🧸
storage Commands for working with storage and databases.
secret Commands for secrets.
Secrets are sensitive information that you need in your application.

Settings ⚙️
version Print the version number.
completion Output shell completion code.

Flags
-h, --help help for copilot
-v, --version version for copilot

Examples
Displays the help menu for the "init" command.
`$ copilot init --help`
```

Verify Copilot CLI is installed by running:

```console
copilot --version
```
The version should be printed:

The installed version is displayed:

```output
copilot version: v1.33.0
copilot version: v1.34.0
```
2 changes: 1 addition & 1 deletion content/install-guides/hyper-v.md
Original file line number Diff line number Diff line change
Expand Up @@ -78,7 +78,7 @@ A dialog should appear:

## How do I enable Hyper-V from the command line?

1. Open a Command Prompt or Windows PowerShell
1. Open a Command Prompt or Windows PowerShell (as Administrator)

2. Run the `DISM` command below to enable Hyper-V:

Expand Down
44 changes: 22 additions & 22 deletions content/install-guides/java.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,39 +22,39 @@ layout: installtoolsall

Java is a high-level, object-oriented programming language first released by Sun Microsystems in 1995.

It is designed to have as few implementation dependencies as possible, making it a versatile and widely-used language.
Its aim is to have as few implementation dependencies as possible, making it a versatile and widely-used language.

## Is Java available for Arm Linux?

Yes, there are numerous ways to install Java on Arm Linux distributions.

Below are some of the common methods to install Java. This includes both the Java runtime environment (JRE), which is used to run Java applications and the Java development kit (JDK) which is used to create Java applications.
Below are some of the common methods that you can use to install Java. This includes both the Java runtime environment (JRE), which is used to run Java applications, and the Java Development Kit (JDK), which is used to create Java applications.

Pick the one that works best for you.

{{% notice Note %}}
The Java Technology Compatibility Kit (TCK) is a test suite that verifies whether a Java implementation conforms to the Java SE Platform Specification. It's a crucial tool for ensuring that Java applications can run consistently across different platforms and implementations.
The Java Technology Compatibility Kit (TCK) is a test suite that you can use to verify whether a Java implementation conforms to the Java SE Platform Specification. It is a crucial tool for ensuring that Java applications can run consistently across different platforms and implementations.

Check the [OCTLA Signatories List](https://openjdk.org/groups/conformance/JckAccess/jck-access.html) to see who has been granted access to the TCK.
{{% /notice %}}

## Can I install Java using the Linux package manager?

For distributions using `apt` - including Debian and Ubuntu:
For distributions using `apt`, including Debian and Ubuntu, you can install Java using this code:

```console
sudo apt update
sudo apt install default-jre -y
sudo apt install default-jdk -y
```

For distributions using `dnf` - including Fedora and Red Hat:
For distributions using `dnf`, including Fedora and Red Hat, you can install Java using this code:

```console
sudo dnf install java-latest-openjdk
```

For distributions using `pacman` - including Arch and Manjaro:
For distributions using `pacman`, including Arch and Manjaro, you can install Java using this code:

```console
sudo pacman -S jdk-openjdk
Expand All @@ -63,7 +63,7 @@ sudo pacman -S jre-openjdk

## Can I install Java using Snap?

For Linux distributions with `snap` you can install Java using:
For Linux distributions using `snap`, you can install Java using this code:

```console
sudo snap install openjdk
Expand All @@ -81,7 +81,7 @@ echo "deb [signed-by=/usr/share/keyrings/corretto-keyring.gpg] https://apt.corre
sudo apt-get update; sudo apt-get install -y java-21-amazon-corretto-jdk
```

More installation options for Corretto are available in the [Amazon Corretto 21 Guide for Linux](https://docs.aws.amazon.com/corretto/latest/corretto-21-ug/linux-info.html)
You can find out more about the installation options for Corretto in the [Amazon Corretto 21 Guide for Linux](https://docs.aws.amazon.com/corretto/latest/corretto-21-ug/linux-info.html).

## How do I install the Microsoft Build of OpenJDK?

Expand Down Expand Up @@ -124,7 +124,7 @@ For more information about the available versions and supported platforms refer

## How do I install Eclipse Temurin from the Adoptium Working Group?

The Adoptium Working Group promotes and supports high-quality, TCK certified runtimes and associated technology for use across the Java ecosystem.
The Adoptium Working Group promotes and supports high-quality, TCK-certified runtimes and associated technology for use across the Java ecosystem.

Eclipse Temurin is the name of the OpenJDK distribution from Adoptium.

Expand Down Expand Up @@ -175,7 +175,7 @@ Yes, you can change the default version. For systems with `apt` use:
sudo update-alternatives --config java
```

You will be given the option to select a new version. The options are depend on the software currently installed on your computer.
You will be given the option to select a new version. The options are dependent on the software currently installed on your computer.

```output
There are 3 choices for the alternative java (providing /usr/bin/java).
Expand All @@ -190,11 +190,11 @@ There are 3 choices for the alternative java (providing /usr/bin/java).
Press <enter> to keep the current choice[*], or type selection number:
```

For this case, if you select option 1, Java 17 becomes the default.
In this example, if you select option 1, Java 17 becomes the default.

## How do I print the Java version?

Print the version of the Java runtime:
Print the version of the Java runtime, by running:

```console
java -version
Expand Down Expand Up @@ -222,27 +222,27 @@ javac 21.0.4

## Which version of Java should I use for Arm Linux systems?

For performance and security, it’s important to ensure that your version of Java is at least 11.0.12. Earlier versions lack significant performance improvements. Java performance has steadily increased over time and newer versions will provide better performance.
For performance and security, it’s important to ensure that your version of Java is at least 11.0.12. Earlier versions lack significant performance improvements. Java performance has steadily increased over time and newer versions provide improved performance.

## Which flags are available for tuning the JVM?

The Java virtual machine (JVM) includes a number of flags which are available to tune performance and aid in debugging. Some of the flags are general purpose and some are Arm architecture specific.
The Java Virtual Machine (JVM) includes a number of flags which are available to tune performance and aid in debugging. Some of the flags are general-purpose and some are Arm architecture-specific.

To print the final values of the flags after the JVM has been initialized run:
To print the final values of the flags after the JVM has been initialized, run:

```console
java -XX:+PrintFlagsFinal -version
```

## Are there other tools commonly used in Java projects?

There are a number of Java related tools you may want to install.
There are a number of Java-related tools you might like to install.

### Apache Maven

Apache Maven is a powerful build automation tool primarily used for Java projects.

It simplifies the build process by providing a uniform build system, dependency management, and project management capabilities.
It simplifies the build process by providing a uniform build system, with dependency and project management capabilities.

You can install it from the `apt` package manager:

Expand Down Expand Up @@ -299,11 +299,11 @@ The output is similar to:
Welcome to Gradle 8.10!

Here are the highlights of this release:
- Support for Java 23
- Faster configuration cache
- Better configuration cache reports
- Support for Java 23.
- Faster configuration cache.
- Improved configuration cache reports.

For more details see https://docs.gradle.org/8.10/release-notes.html
For further information, see https://docs.gradle.org/8.10/release-notes.html.


------------------------------------------------------------
Expand Down Expand Up @@ -387,4 +387,4 @@ INFO: Created user preferences directory.
Copyright (c) 1999-2024 The Apache Software Foundation
```

You are ready to use Java on your Arm Linux system.
You are ready to use Java on your Arm Linux system.
73 changes: 21 additions & 52 deletions content/install-guides/multipass.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,20 +49,20 @@ Multipass uses the terms virtual machine and instance synonymously.
Download Multipass for macOS.

```console
wget https://github.com/canonical/multipass/releases/download/v1.13.1/multipass-1.13.1+mac-Darwin.pkg
wget https://github.com/canonical/multipass/releases/download/v1.14.1-rc1/multipass-1.14.1-rc1+mac.14+gf2381bfe9.mac-Darwin.pkg
```

### Install

Install the download using the package command.

```console
sudo installer -pkg multipass-1.13.1+mac-Darwin.pkg -target /
sudo installer -pkg multipass-1.14.1-rc1+mac.14+gf2381bfe9.mac-Darwin.pkg -target /
```

The getting started instructions below use the command line interface. Multipass installs a tray icon for those who want to access basic features from the user interface.
The getting started instructions below use the command line interface. If you prefer to use the graphical interface start it from the macOS Launchpad, the initial screen is shown below. You can use the UI to create, start, and stop virtual machines.

![Connect #center](/install-guides/_images/multipass-tray.png)
![Connect #center](/install-guides/_images/multipass-gui.png)

Multipass is now installed. Proceed to [Get Started with Multipass](#getstarted).

Expand Down Expand Up @@ -168,10 +168,10 @@ The output from `find` will be similar to the below.

```output
Image Aliases Version Description
20.04 focal 20240626 Ubuntu 20.04 LTS
22.04 jammy 20240701 Ubuntu 22.04 LTS
23.10 mantic 20240701 Ubuntu 23.10
24.04 noble,lts 20240702 Ubuntu 24.04 LTS
20.04 focal 20240821 Ubuntu 20.04 LTS
22.04 jammy 20241002 Ubuntu 22.04 LTS
24.04 noble,lts 20241004 Ubuntu 24.04 LTS
daily:24.10 oracular,devel 20241009 Ubuntu 24.10

Blueprint Aliases Version Description
anbox-cloud-appliance latest Anbox Cloud Appliance
Expand Down Expand Up @@ -223,61 +223,30 @@ The `uname` output will look similar to:
Linux m1u 6.8.0-36-generic #36-Ubuntu SMP PREEMPT_DYNAMIC Mon Jun 10 13:20:23 UTC 2024 aarch64 aarch64 aarch64 GNU/Linux
```

### Run an application

It's helpful to demonstrate a few other common commands by downloading and installing an application. To demonstrate file copy, the download is done from macOS and the file is copied into the instance.

Download and install [OpenVSCode Server](/install-guides/openvscode-server/).

On the macOS host computer use `wget` for the download.

```console
wget https://github.com/gitpod-io/openvscode-server/releases/download/openvscode-server-v1.90.0/openvscode-server-v1.90.0-linux-arm64.tar.gz
```

To copy a file to the instance

```console
multipass transfer openvscode-server-v1.90.0-linux-arm64.tar.gz m1u:/home/ubuntu
```

Now switch to the instance and extract the download and run the application.

If you don't already have an open shell run.

```console
multipass shell m1u
```

Extract the download.

```console
tar xvfz openvscode-server-v1.90.0-linux-arm64.tar.gz
```

Run the application.

```console
./openvscode-server-v1.90.0-linux-arm64/bin/openvscode-server --host=0.0.0.0 --without-connection-token
```

Connect to OpenVSCode Server using a browser. From the macOS host computer use the `info` command to get the IP address of the instance.
### Print information

The `info` command prints information about the instance, including the IP address.

```console
multipass info m1u
```

Copy the IP address from the info output and paste it into a browser with port 3000.
The output is similar to:

Modify the IP address to use your information, for example:
```output
http://192.168.64.39:3000
Name: m1u
State: Running
Snapshots: 0
IPv4: 192.168.73.29
Release: Ubuntu 24.04.1 LTS
Image hash: e380b683b0c4 (Ubuntu 24.04 LTS)
CPU(s): 4
Load: 0.00 0.03 0.01
Disk usage: 2.0GiB out of 15.4GiB
Memory usage: 355.3MiB out of 3.8GiB
Mounts: --
```

You now have a running VS Code Server in your Multipass instance with Ubuntu 22.04 running on Arm.

### Mount a host directory

To access a large number of files on the host machine without copying or transferring them into the instance use the `mount` command. This command makes a host directory visible in the instance and all files can be accessed. Modifications made from inside the instance will directly change the files on the host.
Expand Down
Loading
Loading