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

added VF set up guide to docs #240

Merged

Conversation

killianmuldoon
Copy link
Collaborator

Added updated version of VF creation guide from SR-IOV CNI docs to the device plugin docs folder as per k8snetworkplumbingwg/sriov-cni#74

Input welcome to update the info on VF creation here.

Once this is merged it can be linked from the new SR-IOV CNI docs contained in k8snetworkplumbingwg/sriov-cni#127

@adrianchiris
Copy link
Contributor

LGTM

@killianmuldoon killianmuldoon force-pushed the dev/vf-setup-doc branch 3 times, most recently from 87ac55f to 066304b Compare June 8, 2020 16:13
* Intel® Ethernet Controller X520
* Intel® Ethernet Controller X540
* Intel® Ethernet Controller x550
* Intel® Ethernet Controller X552
Copy link
Collaborator

Choose a reason for hiding this comment

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

I have seen one issue when provisioning VFs with intel x552 ixgbe card, that it requires two steps:

  1. modprobe -r ixgbe; modprobe ixgbe max_vfs=3
  2. echo 3 > /sys/class/net/${PF_NAME}/device/sriov_numvfs

Without step 1), step 2) fails with write error: Cannot allocate memory. Is this expected behavior?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

The driver doc says

NOTE: This parameter is only used on kernel 3.7.x and below. On kernel 3.8.x
and above, use sysfs to enable VFs. Also, for Red Hat distributions, this
parameter is only used on version 6.6 and older. For version 6.7 and newer, use
sysfs.

Are you on an older system like that? I think we should be able to figure out the cutoff version for this behaviour.

Copy link
Collaborator

Choose a reason for hiding this comment

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

@killianmuldoon we were using centos 7/8, it has newer kernel versions than 6.7.
@yrobla ^^

Copy link

Choose a reason for hiding this comment

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

The cannot allocate memory problem was actually a missing setting on my bios. However, i am experimenting errors on my x552 card. As soon as i do something like "echo 3 > /sys/class/net/eno3/device/sriov_numvfs" , the system reboots and seems unable to persistently keep this value.

Copy link
Collaborator

Choose a reason for hiding this comment

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

note: this doesn't necessary block the merging of this PR, it is just to check if we have ever hit the same issue.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

@zshi-redhat I've not had a change to figure out the issue here or where the cutoff might be for the cards/OS. I've put in a troubleshooting block with your instructions and specifically called out the error message and the 552 NIC - hopefully that should help people who run into this issue.

@abdallahyas
Copy link

/retest

docs/vf-setup.md Outdated
Next set the VFs as above

```
echo 8 >> /sys/class/net/${PF_NAME}/device/sriov_numvfs
Copy link
Collaborator

Choose a reason for hiding this comment

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

I think this is a type here? This should be > instead of >>

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Thanks for catching that - fixed

@killianmuldoon killianmuldoon force-pushed the dev/vf-setup-doc branch 2 times, most recently from d87715f to 1d200cd Compare June 15, 2020 09:29
docs/vf-setup.md Outdated
* [Mellanox](#mellanox)

## Intel
The below works on intel SR-IOV enabled cards including those from the Gigabit Ethernet, X710 and X722 families of Network Interface Cards. Note not all Gigabit Ethernet NICs are enabled with SR-IOV.
Copy link
Member

Choose a reason for hiding this comment

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

The below works on intel SR-IOV enabled ..

Could you reword this

intel

Intel*


To create 8 virtual functions run:
```
echo 8 > /sys/class/net/${PF_NAME}/device/sriov_numvfs
Copy link
Member

Choose a reason for hiding this comment

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

Should we reset the number of VFs here before asking for 8 in case it was configured previously and will throw an error if its not reset first before asking for a new set of VFs?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Added a section under "common problems" to pick up this error if someone wants to reset the number of VFs

@killianmuldoon killianmuldoon force-pushed the dev/vf-setup-doc branch 3 times, most recently from 4659f05 to 44f82b9 Compare June 15, 2020 12:56
@killianmuldoon killianmuldoon changed the title WIP added VF set up guide to docs added VF set up guide to docs Jun 15, 2020
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.

7 participants