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

Docs: Updated quickstart with OBS Package install for RPM and SLES #835

Merged
merged 1 commit into from
Aug 14, 2024

Conversation

aazam-gh
Copy link
Contributor

@aazam-gh aazam-gh commented Aug 7, 2024

Updated quickstart.rst

PR forwarded from #832

Copy link
Contributor

@Bischoff Bischoff left a comment

Choose a reason for hiding this comment

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

see nitpick


2. Disable gpgkeycheck flag

Add the flag `gpgkeycheck=0`to the /etc/yum.repos.d/download.opensuse.org_repositories_Virtualization_feilong_AlmaLinux_9_.repo file.
Copy link
Contributor

Choose a reason for hiding this comment

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

formatting problem here (the hyperlink)

please ignore if doc generation does not have the problem (ie if it's only a problem with github's rendering)


Update the config file `/etc/selinux/config` and set `SELINUX=disabled`.
Make sure you reboot to ensure the changes are reflected and SELinux is disabled.
We are considering writing SELinux policies for Feilong that would enable to not disable SELinux as a whole.
Copy link
Contributor

Choose a reason for hiding this comment

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

empty line before that one?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

The line after the sub heading? It is the same format as the rest

Copy link
Contributor

Choose a reason for hiding this comment

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

I was suggesting to add a blank line before "We are considering writing"

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done


.. code-block:: text

# zypper ar https://download.opensuse.org/repositories/Virtualization:/feilong/15.5/ feilong
Copy link
Contributor

@Bischoff Bischoff Aug 7, 2024

Choose a reason for hiding this comment

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

I think it's called "SLE_15_SP5" now instead of "15.5"

correct link: https://download.opensuse.org/repositories/Virtualization:/feilong/SLE_15_SP5/

Copy link
Contributor Author

Choose a reason for hiding this comment

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

done

3. Disable SELinux

Make sure SELinux is set to disabled mode.
We are considering writing SELinux policies for Feilong that would enable to not disable SELinux as a whole.
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 you can remove this whole paragraph. By default, SLES uses apparmor, not SELinux.

(unless you have seen SELinux on SLES on linux 1 VM?)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Yes SLES indeed uses apparmor on L1CC as well. Removing the entire paragraph

Copy link
Contributor

@mfriesenegger mfriesenegger left a comment

Choose a reason for hiding this comment

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

I will create an issue for a future effort to fix the manual installation section.

it might be changed and for now please install through code directly.

2. **Through Source Code directly**

Copy link
Contributor

Choose a reason for hiding this comment

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

Instead of removing paragraph 1, say we now have packages, maybe?

Copy link
Contributor

Choose a reason for hiding this comment

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

or this is done above? i'm getting a bit lost

Copy link
Contributor

Choose a reason for hiding this comment

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

Instead of removing paragraph 1, say we now have packages, maybe?

I am OK with removing these lines versus repeating a statement that packages exist. The Installation using OBS Packages section is before the Manual Installation so a reader hopefully will have seen that packages exist.

Copy link
Contributor

Choose a reason for hiding this comment

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

Fine :)

Then please ignore Aazam.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Okay

Debian for Ubuntu
-----------------

(to be continued)
Copy link
Contributor

Choose a reason for hiding this comment

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

this could be updated now?

Copy link
Contributor

Choose a reason for hiding this comment

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

or separate PR

Copy link
Contributor

Choose a reason for hiding this comment

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

then please ignore Aazam.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Seperate PR.

@aazam-gh
Copy link
Contributor Author

Changes have been done. Ready for Merge :)


4. Skip to the SSH key authentication between consumer and BYOL section to continue.

Debian for 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
Debian for Ubuntu
DEB for Ubuntu

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 "DEB" could be all lowercase but I am suggesting all uppercase like has been done with RPM for RH and SLES.

@aazam-gh aazam-gh force-pushed the quickstartdocs branch 2 times, most recently from 878fbad to 4aa9a6f Compare August 13, 2024 12:01
@mfriesenegger
Copy link
Contributor

@bjhuangr This is ready to be merged.

@bjhuangr bjhuangr merged commit ceecafc into openmainframeproject:master Aug 14, 2024
2 checks passed
@aazam-gh aazam-gh deleted the quickstartdocs branch August 14, 2024 09:38
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.

4 participants