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.

Sign up for GitHub

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

[doc][yba] Installing python and YBA nodes #25563

Open
wants to merge 7 commits into
base: master
Choose a base branch
from
+202 −130
Open

[doc][yba] Installing python and YBA nodes #25563

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
9f749fa
Installing python and YBA nodes
ddhodge Jan 9, 2025
a23aca7
python reqs
ddhodge Jan 10, 2025
d1d8cc6
tidy references to provider configs
ddhodge Jan 10, 2025
bdece80
Apply suggestions from code review
ddhodge Jan 10, 2025
a820a2d
review comments
ddhodge Jan 10, 2025
f44b08d
updates
ddhodge Jan 10, 2025
b8199d1
review comments
ddhodge Jan 11, 2025
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
2 changes: 1 addition & 1 deletion docs/content/preview/yugabyte-platform/prepare/server-nodes-software/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ YugabyteDB Anywhere requires the following additional software to be pre-install

#### Python

Python 3.8-3.9 must be installed on the nodes.
Python 3.6-3.12 must be installed on the nodes.

Install the python selinux package corresponding to your version of python. You can use pip to do this. Ensure the version of pip matches the version of Python.

Expand Down
2 changes: 1 addition & 1 deletion ...view/yugabyte-platform/prepare/server-nodes-software/software-on-prem-manual.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -78,7 +78,7 @@ The following instructions use user-level systemd to provide the necessary acces

## Verify the python version installed on the node

Verify that Python 3.8-3.9 is installed on the node. v3.8 is recommended.
Verify that Python 3.6-3.12 is installed on the node. v3.6 is recommended.
Copy link
Contributor

Choose a reason for hiding this comment

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

I would leave 3.8 as recommended, and honestly just keep this as 3.8+ I think that's going to be more correct going forward. If somebody complains we can tell them 3.6 still should work but I don't think we want to officially document supporting it bc then people will try to install it.


In case there is more than one Python 3 version installed, ensure that `python3` refers to the right one. For example:

Expand Down
12 changes: 6 additions & 6 deletions docs/content/preview/yugabyte-platform/prepare/server-yba.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -62,23 +62,23 @@ You need your license file to install YugabyteDB Anywhere. Contact {{% support-p

### Python

Python v3.8 to v3.11 must be pre-installed.
Python v3.10 to v3.12 must be pre-installed.

Both python and python3 must symbolically link to Python 3. One way to achieve this is to use alternatives. For example:

```sh
sudo yum install @python38 -y
sudo yum install @python310 -y
Copy link
Contributor

Choose a reason for hiding this comment

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

idt 3.10 is available in yum, use 3.11

sudo alternatives --config python
# choose Python 3.8 from list
# choose Python 3.10 from list

sudo alternatives --config python3
# choose Python 3.8 from list
# choose Python 3.10 from list

python -V
# output: Python 3.8.16
# output: Python 3.10.2

python3 -V
# output: Python 3.8.16
# output: Python 3.10.2
```

#### Permissions
Expand Down
6 changes: 6 additions & 0 deletions docs/content/preview/yugabyte-platform/upgrade/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,12 @@ If you are running YBA on a [deprecated OS](../../reference/configuration/operat

{{< /note >}}

{{< note title="Upgrading YBA on systems that have older versions of Python" >}}

YBA v2024.1 and later requires Python v3.10-3.12. If you are running YBA on a system with Python earlier than 3.10, you will need to update Python on your system before you can upgrade YBA to v2024.1 or later.
Copy link
Contributor

Choose a reason for hiding this comment

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

2025.1

Copy link
Contributor

Choose a reason for hiding this comment

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

Or actually 2.25+, bc that will be the preview before 2025.1 released. we don't even have that on docs yet though so maybe this isn't needed?


{{< /note >}}

{{<index/block>}}

{{<index/item
Expand Down
6 changes: 6 additions & 0 deletions docs/content/preview/yugabyte-platform/upgrade/upgrade-yp-installer.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,12 @@ If you are running YBA on a [deprecated OS](../../../reference/configuration/ope

{{< /note >}}

{{< note title="Upgrading YBA on systems that have older versions of Python" >}}

YBA v2024.1 and later requires Python v3.10-3.12. If you are running YBA on a system with Python earlier than 3.10, you will need to update Python on your system before you can upgrade YBA to v2024.1 or later.

{{< /note >}}

## Upgrade using YBA Installer

To upgrade using YBA Installer, first download the version of YBA Installer corresponding to the version of YBA you want to upgrade to.
Expand Down
2 changes: 1 addition & 1 deletion docs/content/stable/yugabyte-platform/prepare/server-nodes-software/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ YugabyteDB Anywhere requires the following additional software to be pre-install

#### Python

Python 3.8-3.9 must be installed on the nodes.
Python 3.5-3.9 must be installed on the nodes.

Install the python selinux package corresponding to your version of python. You can use pip to do this. Ensure the version of pip matches the version of Python.

Expand Down
2 changes: 1 addition & 1 deletion ...able/yugabyte-platform/prepare/server-nodes-software/software-on-prem-manual.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -78,7 +78,7 @@ The following instructions use user-level systemd to provide the necessary acces

## Verify the python version installed on the node

Verify that Python 3.8-3.9 is installed on the node. v3.8 is recommended.
Verify that Python 3.5-3.9 is installed on the node. v3.6 is recommended.

In case there is more than one Python 3 version installed, ensure that `python3` refers to the right one. For example:

Expand Down
2 changes: 1 addition & 1 deletion docs/content/v2.20/yugabyte-platform/prepare/server-nodes-software/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ YugabyteDB Anywhere requires the following additional software to be pre-install

#### Python

Python 3.6-3.8 must be installed on the nodes.
Python 3.5-3.8 must be installed on the nodes.

Install the python selinux package corresponding to your version of python. You can use pip to do this. Ensure the version of pip matches the version of Python.

Expand Down
2 changes: 1 addition & 1 deletion ...2.20/yugabyte-platform/prepare/server-nodes-software/software-on-prem-manual.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ The following instructions use user-level systemd to provide the necessary acces

## Verify the python version installed on the node

Verify that Python 3.6-3.8 is installed on the node. v3.6 is recommended.
Verify that Python 3.5-3.8 is installed on the node. v3.6 is recommended.

In case there is more than one Python 3 version installed, ensure that `python3` refers to the right one. For example:

Expand Down
2 changes: 1 addition & 1 deletion docs/content/v2024.1/yugabyte-platform/prepare/server-nodes-software/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ YugabyteDB Anywhere requires the following additional software to be pre-install

#### Python

Python 3.6-3.9 must be installed on the nodes.
Python 3.5-3.8 must be installed on the nodes.

Install the python selinux package corresponding to your version of python. You can use pip to do this. Ensure the version of pip matches the version of Python.

Expand Down
2 changes: 1 addition & 1 deletion ...24.1/yugabyte-platform/prepare/server-nodes-software/software-on-prem-manual.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ The following instructions use user-level systemd to provide the necessary acces

## Verify the python version installed on the node

Verify that Python 3.6-3.8 is installed on the node. v3.6 is recommended.
Verify that Python 3.5-3.8 is installed on the node. v3.6 is recommended.

In case there is more than one Python 3 version installed, ensure that `python3` refers to the right one. For example:

Expand Down