Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

updated fiab documentation #285

Merged
merged 1 commit into from
Dec 2, 2022

Conversation

RaviKhandavilli
Copy link
Contributor

Added complete steps to install fiab for each distribution separately

Copy link
Contributor

@myungjin myungjin left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

left several comments.

docs/03-fiab.md Outdated
minikube delete
```
This development environment is mainly tested under MacOS.
The fiab is also tested under Archlinux. Hence, it may work on other Linux distributions such as Ubuntu.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The fiab is also tested under Archlinux. Hence, it may work on other Linux distributions such as Ubuntu.
The fiab env is also tested under linux distributions such as Ubuntu, Amazon Linux 2, Archlinux, etc.

docs/03-fiab.md Outdated

## Running a test ML job
In order to run a sample mnist job, refer to instructions at [mnist example](04-examples.md#mnist).
## Fiab installation steps:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## Fiab installation steps:
## Fiab installation guideline
Follow one of the links below that matches operating system under consideration:

@@ -1,12 +1,13 @@
# Fiab installation in linux
The fiab env was tested under Archlinux in a x86 machine. But steps can be followed for similar OS.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The fiab env was tested under Archlinux in a x86 machine. But steps can be followed for similar OS.
This guideline is mainly for Ubuntu in a x86 machine and steps can be followed for other linux distributions with their respective package mangers.

```
When `docker` driver is in use, run ```minikube config set driver docker``` to make docker driver default. These changes will take effect upon a minikube delete and then a minikube start.

We recommend a disk space of 100GB to allow sufficient disk space to store the flame container images and other images in the minikube VM.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The lines 100-113 are not needed because of https://github.com/cisco-open/flame/pull/285/files#diff-ac8447bfb60ee1cdba24bb93c02d1b55f3f34d02f4c6dce9718b31d8864a769cR60.

Please remove them and change "## Starting minikube" to "## Configuring addons".


We recommend a disk space of 100GB to allow sufficient disk space to store the flame container images and other images in the minikube VM.

Next, `ingress` and `ingress` addons need to be installed with the following command:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Next, `ingress` and `ingress` addons need to be installed with the following command:
Next, `ingress` and `ingress-dns` addons need to be installed with the following command:


We recommend a disk space of 100GB to allow sufficient disk space to store the flame container images and other images in the minikube VM.

Next, `ingress` and `ingress` addons need to be installed with the following command:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Next, `ingress` and `ingress` addons need to be installed with the following command:
Next, `ingress` and `ingress-dns` addons need to be installed with the following command:


We recommend a disk space of 100GB to allow sufficient disk space to store the flame container images and other images in the minikube VM.

Next, `ingress` and `ingress` addons need to be installed with the following command:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Next, `ingress` and `ingress` addons need to be installed with the following command:
Next, `ingress` and `ingress-dns` addons need to be installed with the following command:

Copy link
Contributor

@myungjin myungjin left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

left a few other comments.

docs/03-fiab.md Outdated
Unless a fresh minikube instance is needed, simply stopping the minikube (i.e., `minikube stop`) instance would be useful
to save time for development and testing.
* [Linux](03.A-fiab-linux.md)
* [Amazon Linux with GPU](03.B-fiab-ec2.md)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this link is broken because the file is deleted.


### Linux Prerequisites
# Fiab installation in linux
This guideline is mainly for Ubuntu in a x86 machine and steps can be followed for other linux distributions with their respective package mangers.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This guideline is mainly for Ubuntu in a x86 machine and steps can be followed for other linux distributions with their respective package mangers.
This guideline is mainly for Ubuntu in a x86 machine and steps can be followed for other linux distributions with their respective package managers.

This guideline primarily focus on installting fiab in amazon linux with mounted NVIDIA GPUs.

## Prerequisites
AWS EC2 instance with Amazon Linux 2 image and GPU
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is not a complete sentence. Please revise.

Added complete steps to install fiab for each distribution separately
Copy link
Contributor

@myungjin myungjin left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

@myungjin myungjin merged commit 1144e38 into cisco-open:main Dec 2, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants