Skip to content

doc: bring AIX steps up to date with reality#4340

Draft
sxa wants to merge 1 commit into
nodejs:mainfrom
sxa:aix73doc
Draft

doc: bring AIX steps up to date with reality#4340
sxa wants to merge 1 commit into
nodejs:mainfrom
sxa:aix73doc

Conversation

@sxa
Copy link
Copy Markdown
Member

@sxa sxa commented May 15, 2026

I've collapsed a few sections into twisties to make this a bit more digestible for people who want an overview of what's needed for setting up AIX systems from our providers.
Some additions, some removals of obsolete things/references to things that are no longer manual (e.g. cmake)

Preview at https://github.com/sxa/nodebuild/blob/aix73doc/ansible/MANUAL_STEPS.md#aix

Still in draft for now as I'm still experimenting:

  • the index in the doc will likely need to be updated due to the changes
  • the explicit "AIX 7.2" heading is probably obsolete as most sections are applicable to 7.2/7.3 and we no longer have 7.1 or earlier.
  • The required physical disk sizes probably need to be updated as 20+50GB may not be adequate for newer versions with the additional requirements for node 26. 20+70GiB is probably a minimum.
  • Need to clarify if the ansible_python_interpreter can be configured properly as I haven't made it work other than from the ansible-playbook command line yet.
  • Need to verify on another clean system whether anything other than python3-pip is required to be installed manually (likely also dnf-python)
  • Check whether we really need all of the packages from the IBM UTILITIES package set.

Signed-off-by: Stewart X Addison <sxa@ibm.com>
@sxa sxa assigned sxa, abmusse and richardlau and unassigned abmusse and richardlau May 15, 2026
@sxa sxa requested review from abmusse and richardlau May 15, 2026 11:28
Copy link
Copy Markdown
Member

@richardlau richardlau left a comment

Choose a reason for hiding this comment

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

Since sections have been removed/renamed please also update the links at the top of the file.

Comment thread ansible/MANUAL_STEPS.md
https://github.com/nodejs/node/issues/46792. In the meantime the `en1`
interface containing the link local address is removed.
Some libuv/Node.js tests currently
(`parallel/test-dgram-udp6-link-local-address` is an example](https://github.com/nodejs/node/issues/46792)
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
(`parallel/test-dgram-udp6-link-local-address` is an example](https://github.com/nodejs/node/issues/46792)
([`parallel/test-dgram-udp6-link-local-address` is an example](https://github.com/nodejs/node/issues/46792))

Comment thread ansible/MANUAL_STEPS.md
Comment on lines +340 to +342
Until the underlying reason is resolved In the meantime the
interface containing the link local address should be removed by running the
following command as root on the appropriate interface.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I assume this was mid-edit and you meant one of

Suggested change
Until the underlying reason is resolved In the meantime the
interface containing the link local address should be removed by running the
following command as root on the appropriate interface.
Until the underlying reason is resolved the
interface containing the link local address should be removed by running the
following command as root on the appropriate interface.

or

Suggested change
Until the underlying reason is resolved In the meantime the
interface containing the link local address should be removed by running the
following command as root on the appropriate interface.
In the meantime the
interface containing the link local address should be removed by running the
following command as root on the appropriate interface.

Comment thread ansible/MANUAL_STEPS.md
What you do need to install manually is **ccache**
You may need to set up the AIX toolbox if it is not configured by default by
your provider, and potentially update python and pip to allow ansible to
communicate with it properly (`dnf install python3-pip` will often be enough)
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

python3-pip should be being installed via the playbook.
There may be packages such as python3-dnf (needed for the ansible.builtin.dnf/ansible.builtin.package tasks) which should be done as part of the bootstrap role if not already.

Comment thread ansible/MANUAL_STEPS.md
mkdir -p /opt/gcc-6.3 && cd /opt/gcc-6.3
curl -L https://ci.nodejs.org/downloads/aix/gcc-6.3-aix7.2.ppc.tar.gz | /opt/freeware/bin/tar -xzf -
```
The AIX Event Infrastructure is [required for the file watcher
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

We could link to AIX documentation for the Event Infrastructure (suggestion here consistent with the change in https://redirect.github.com/libuv/libuv/pull/5136):

Suggested change
The AIX Event Infrastructure is [required for the file watcher
The [AIX Event Infrastructure](https://www.ibm.com/docs/en/aix/7.3.0?topic=management-aix-event-infrastructure-aix-aix-clusters-ahafs) is [required for the file watcher

Comment thread ansible/MANUAL_STEPS.md
lslpp -l bos.ahafs`
```
which will tell you if it is not already installed. If it is not, then you will
need to get it installed form the AIX install media, which may involve contacting
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
need to get it installed form the AIX install media, which may involve contacting
need to get it installed from the AIX install media, which may involve contacting

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.

3 participants