Skip to content

Commit c94f005

Browse files
mregmimregmi
committed
Documentation: Split the tests README and put it in their own folder
Signed-off-by: Manish Regmi <manish.regmi@intel.com>
1 parent 792c479 commit c94f005

File tree

4 files changed

+204
-198
lines changed

4 files changed

+204
-198
lines changed

‎tests/l2/README.md

Lines changed: 4 additions & 198 deletions
Original file line numberDiff line numberDiff line change
@@ -7,205 +7,11 @@ After provisioning Intel hardware features on RHOCP, the respective hardware res
77

88
• Provisioning Intel HW features on RHOCP. Follow steps [here](/README.md#provisioning-intel-hardware-features-on-rhocp)
99

10-
### Verify Intel® Software Guard Extensions (Intel® SGX) Provisioning
11-
This [SampleEnclave](https://github.com/intel/linux-sgx/tree/master/SampleCode/SampleEnclave) application workload from the Intel SGX SDK runs an Intel SGX enclave utilizing the EPC resource from the Intel SGX provisioning.
12-
* Build the container image.
13-
```
14-
$ oc apply -f https://raw.githubusercontent.com/intel/intel-technology-enabling-for-openshift/main/tests/l2/sgx/sgx_build.yaml
15-
```
16-
17-
* Deploy and run the workload.
18-
19-
```
20-
$ oc apply -f https://raw.githubusercontent.com/intel/intel-technology-enabling-for-openshift/main/tests/l2/sgx/sgx_job.yaml
21-
```
22-
23-
* Check the results.
24-
```
25-
$ oc get pods
26-
intel-sgx-job-4tnh5 0/1 Completed 0 2m10s
27-
intel-sgx-workload-1-build 0/1 Completed 0 30s
28-
```
29-
```
30-
$ oc logs intel-sgx-job-4tnh5
31-
Checksum(0x0x7fffac6f41e0, 100) = 0xfffd4143
32-
Info: executing thread synchronization, please wait...
33-
Info: SampleEnclave successfully returned.
34-
Enter a character before exit ...
35-
```
3610
### Verify Intel® Data Center GPU provisioning
37-
It is supported for Intel® Data Center GPU Flex and Max Series.
38-
#### clinfo
39-
This workload runs [clinfo](https://github.com/Oblomov/clinfo) utilizing the i915 resource from GPU provisioning and displays the related GPU information.
40-
41-
* Build the workload container image.
42-
43-
```
44-
$ oc apply -f https://raw.githubusercontent.com/intel/intel-technology-enabling-for-openshift/main/tests/l2/dgpu/clinfo_build.yaml
45-
```
46-
47-
* Deploy and execute the workload.
48-
49-
```
50-
$ oc apply -f https://raw.githubusercontent.com/intel/intel-technology-enabling-for-openshift/main/tests/l2/dgpu/clinfo_job.yaml
51-
```
52-
53-
* Check the results.
54-
```
55-
$ oc get pods
56-
intel-dgpu-clinfo-1-build 0/1 Completed 0 3m20s
57-
intel-dgpu-clinfo-56mh2 0/1 Completed 0 35s
58-
```
59-
```
60-
$ oc logs intel-dgpu-clinfo-56mh2
61-
Platform Name Intel(R) OpenCL HD Graphics
62-
Number of devices 1
63-
Device Name Intel(R) Data Center GPU Flex Series 140 [0x56c1]
64-
Device Vendor Intel(R) Corporation
65-
Device Vendor ID 0x8086
66-
Device Version OpenCL 3.0 NEO
67-
Device UUID 86800000-c156-0000-0000-000000000000
68-
Driver UUID 32322e34-332e-3234-3539-352e33350000
69-
Valid Device LUID No
70-
Device LUID 80c6-4e56fd7f0000
71-
Device Node Mask 0
72-
Device Numeric Version 0xc00000 (3.0.0)
73-
Driver Version 22.43.24595.35
74-
Device OpenCL C Version OpenCL C 1.2
75-
Device OpenCL C all versions OpenCL
76-
```
77-
#### hwinfo
78-
79-
This workload runs ```hwinfo``` utilizing the i915 resource from GPU provisioning and displays the related GPU information. Refer to [link](https://dgpu-docs.intel.com/driver/installation.html#verify-install)
80-
81-
82-
* Build the workload container image.
83-
84-
```
85-
$ oc apply -f https://raw.githubusercontent.com/intel/intel-technology-enabling-for-openshift/main/tests/l2/dgpu/hwinfo_build.yaml
86-
```
87-
88-
* Deploy and execute the workload.
89-
90-
```
91-
$ oc apply -f https://raw.githubusercontent.com/intel/intel-technology-enabling-for-openshift/main/tests/l2/dgpu/hwinfo_job.yaml
92-
```
11+
Please refer to Intel DGPU provisioning validation tests [here](dgpu/README.md)
9312

94-
* Check the results
95-
```
96-
$ oc get pods
97-
intel-dgpu-hwinfo-1-build 0/1 Completed 0 2m23s
98-
intel-dgpu-hwinfo-44k4d 0/1 Completed 0 106s
99-
```
100-
```
101-
$ oc logs intel-dgpu-hwinfo-44k4d
102-
282: PCI aa00.0: 0380 Display controller
103-
[Created at pci.386]
104-
Unique ID: YxOB.+ER_Ec9Ujm4
105-
Parent ID: xBFW.xbjkZcxCQYD
106-
SysFS ID: /devices/pci0000:a7/0000:a7:01.0/0000:a8:00.0/0000:a9:01.0/0000:aa:00.0
107-
SysFS BusID: 0000:aa:00.0
108-
Hardware Class: graphics card
109-
Model: "Intel Display controller"
110-
Vendor: pci 0x8086 "Intel Corporation"
111-
Device: pci 0x0bda
112-
SubVendor: pci 0x8086 "Intel Corporation"
113-
SubDevice: pci 0x0000
114-
Revision: 0x2f
115-
Driver: "i915"
116-
Driver Modules: "i915"
117-
Memory Range: 0x44fe3f000000-0x44fe3fffffff (ro,non-prefetchable)
118-
Memory Range: 0x447000000000-0x447fffffffff (ro,non-prefetchable)
119-
IRQ: 511 (140 events)
120-
Module Alias: "pci:v00008086d00000BDAsv00008086sd00000000bc03sc80i00"
121-
Config Status: cfg=new, avail=yes, need=no, active=unknown
122-
Attached to: #89 (PCI bridge)
123-
```
13+
### Verify Intel® Software Guard Extensions (Intel® SGX) Provisioning
14+
Please refer to Intel SGX provisioning validation tests [here](sgx/README.md)
12415

12516
### Verify Intel® QuickAssist Technology provisioning
126-
This workload runs [qatlib](https://github.com/intel/qatlib) sample tests using RedHat built and distributed Qatlib RPM packages from the codeready-builder-for-rhel-9-x86_64-rpms repo. Refer to the [qatlib readme](https://github.com/intel/qatlib/blob/main/INSTALL) for more details.
127-
128-
* Build the workload container image
129-
130-
Please replace the credentials in buildconfig yaml with your RedHat account login credentials.
131-
132-
```
133-
$ oc apply -f https://raw.githubusercontent.com/intel/intel-technology-enabling-for-openshift/main/tests/l2/qat/qatlib_build.yaml
134-
```
135-
136-
* Create SCC intel-qat-scc for Intel QAT based workload, if this SCC is not created
137-
138-
```
139-
$ oc apply -f https://raw.githubusercontent.com/intel/intel-technology-enabling-for-openshift/main/security/qatlib_scc.yaml
140-
```
141-
142-
* Create the intel-qat service account to use intel-qat-scc
143-
144-
```
145-
$ oc apply -f https://raw.githubusercontent.com/intel/intel-technology-enabling-for-openshift/main/security/qatlib_rbac.yaml
146-
```
147-
148-
* Deploy the qatlib workload job with intel-qat service account
149-
150-
```
151-
$ oc apply -f https://raw.githubusercontent.com/intel/intel-technology-enabling-for-openshift/main/tests/l2/qat/qatlib_job.yaml
152-
```
153-
154-
* Check the results.
155-
```
156-
$ oc get pods
157-
intel-qat-workload-c6g9v 0/1 Completed 0 4m13s
158-
```
159-
160-
161-
* For all sample tests `cpa_sample_code`
162-
163-
```
164-
$ oc logs intel-qat-workload-c6g9v
165-
qaeMemInit started
166-
icp_sal_userStartMultiProcess("SSL") started
167-
There are no crypto instances
168-
*** QA version information ***
169-
device ID = 0
170-
software = 23.2.0
171-
*** END QA version information ***
172-
Inst 0, Affin: 0, Dev: 0, Accel 0, EE 0, BDF ED:00:01
173-
Inst 1, Affin: 1, Dev: 0, Accel 0, EE 0, BDF ED:00:01
174-
Inst 2, Affin: 2, Dev: 0, Accel 0, EE 0, BDF ED:00:01
175-
Inst 3, Affin: 3, Dev: 0, Accel 0, EE 0, BDF ED:00:01
176-
---------------------------------------
177-
API Traditional
178-
Session State STATELESS
179-
Algorithm DEFLATE
180-
Huffman Type STATIC
181-
Mode ASYNCHRONOUS
182-
CNV Enabled YES
183-
Direction COMPRESS
184-
Packet Size 8192
185-
Compression Level 1
186-
Corpus CALGARY_CORPUS
187-
Corpus Filename calgary
188-
CNV Recovery Enabled YES
189-
Number of threads 4
190-
Total Responses 158400
191-
Total Retries 2242671
192-
Clock Cycles Start 126150916653843
193-
Clock Cycles End 126151409143747
194-
Total Cycles 492489904
195-
CPU Frequency(kHz) 1700160
196-
Throughput(Mbps) 35920
197-
Compression Ratio 0.4897
198-
---------------------------------------
199-
200-
Inst 0, Affin: 0, Dev: 0, Accel 0, EE 0, BDF ED:00:01
201-
Inst 1, Affin: 1, Dev: 0, Accel 0, EE 0, BDF ED:00:01
202-
Inst 2, Affin: 2, Dev: 0, Accel 0, EE 0, BDF ED:00:01
203-
Inst 3, Affin: 3, Dev: 0, Accel 0, EE 0, BDF ED:00:01
204-
---------------------------------------
205-
```
206-
207-
208-
## See Also
209-
For Intel SGX demos on vanilla Kubernetes, refer to [link](https://github.com/intel/intel-device-plugins-for-kubernetes/tree/main/demo/sgx-sdk-demo)
210-
211-
For GPU demos on vanilla Kubernetes, refer to [link](https://github.com/intel/intel-device-plugins-for-kubernetes/tree/main/demo/intel-opencl-icd)
17+
Please refer to Intel QAT provisioning validation tests [here](qat/README.md)

‎tests/l2/dgpu/README.md

Lines changed: 91 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
1+
### Verify Intel® Data Center GPU provisioning
2+
It is supported for Intel® Data Center GPU Flex and Max Series.
3+
#### clinfo
4+
This workload runs [clinfo](https://github.com/Oblomov/clinfo) utilizing the i915 resource from GPU provisioning and displays the related GPU information.
5+
6+
* Build the workload container image.
7+
8+
```
9+
$ oc apply -f https://raw.githubusercontent.com/intel/intel-technology-enabling-for-openshift/main/tests/l2/dgpu/clinfo_build.yaml
10+
```
11+
12+
* Deploy and execute the workload.
13+
14+
```
15+
$ oc apply -f https://raw.githubusercontent.com/intel/intel-technology-enabling-for-openshift/main/tests/l2/dgpu/clinfo_job.yaml
16+
```
17+
18+
* Check the results.
19+
```
20+
$ oc get pods
21+
intel-dgpu-clinfo-1-build 0/1 Completed 0 3m20s
22+
intel-dgpu-clinfo-56mh2 0/1 Completed 0 35s
23+
```
24+
```
25+
$ oc logs intel-dgpu-clinfo-56mh2
26+
Platform Name Intel(R) OpenCL HD Graphics
27+
Number of devices 1
28+
Device Name Intel(R) Data Center GPU Flex Series 140 [0x56c1]
29+
Device Vendor Intel(R) Corporation
30+
Device Vendor ID 0x8086
31+
Device Version OpenCL 3.0 NEO
32+
Device UUID 86800000-c156-0000-0000-000000000000
33+
Driver UUID 32322e34-332e-3234-3539-352e33350000
34+
Valid Device LUID No
35+
Device LUID 80c6-4e56fd7f0000
36+
Device Node Mask 0
37+
Device Numeric Version 0xc00000 (3.0.0)
38+
Driver Version 22.43.24595.35
39+
Device OpenCL C Version OpenCL C 1.2
40+
Device OpenCL C all versions OpenCL
41+
```
42+
#### hwinfo
43+
44+
This workload runs ```hwinfo``` utilizing the i915 resource from GPU provisioning and displays the related GPU information. Refer to [link](https://dgpu-docs.intel.com/driver/installation.html#verify-install)
45+
46+
47+
* Build the workload container image.
48+
49+
```
50+
$ oc apply -f https://raw.githubusercontent.com/intel/intel-technology-enabling-for-openshift/main/tests/l2/dgpu/hwinfo_build.yaml
51+
```
52+
53+
* Deploy and execute the workload.
54+
55+
```
56+
$ oc apply -f https://raw.githubusercontent.com/intel/intel-technology-enabling-for-openshift/main/tests/l2/dgpu/hwinfo_job.yaml
57+
```
58+
59+
* Check the results
60+
```
61+
$ oc get pods
62+
intel-dgpu-hwinfo-1-build 0/1 Completed 0 2m23s
63+
intel-dgpu-hwinfo-44k4d 0/1 Completed 0 106s
64+
```
65+
```
66+
$ oc logs intel-dgpu-hwinfo-44k4d
67+
282: PCI aa00.0: 0380 Display controller
68+
[Created at pci.386]
69+
Unique ID: YxOB.+ER_Ec9Ujm4
70+
Parent ID: xBFW.xbjkZcxCQYD
71+
SysFS ID: /devices/pci0000:a7/0000:a7:01.0/0000:a8:00.0/0000:a9:01.0/0000:aa:00.0
72+
SysFS BusID: 0000:aa:00.0
73+
Hardware Class: graphics card
74+
Model: "Intel Display controller"
75+
Vendor: pci 0x8086 "Intel Corporation"
76+
Device: pci 0x0bda
77+
SubVendor: pci 0x8086 "Intel Corporation"
78+
SubDevice: pci 0x0000
79+
Revision: 0x2f
80+
Driver: "i915"
81+
Driver Modules: "i915"
82+
Memory Range: 0x44fe3f000000-0x44fe3fffffff (ro,non-prefetchable)
83+
Memory Range: 0x447000000000-0x447fffffffff (ro,non-prefetchable)
84+
IRQ: 511 (140 events)
85+
Module Alias: "pci:v00008086d00000BDAsv00008086sd00000000bc03sc80i00"
86+
Config Status: cfg=new, avail=yes, need=no, active=unknown
87+
Attached to: #89 (PCI bridge)
88+
```
89+
90+
## See Also
91+
For GPU demos on vanilla Kubernetes, refer to [link](https://github.com/intel/intel-device-plugins-for-kubernetes/tree/main/demo/intel-opencl-icd)

‎tests/l2/qat/README.md

Lines changed: 81 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
### Verify Intel® QuickAssist Technology provisioning
2+
This workload runs [qatlib](https://github.com/intel/qatlib) sample tests using RedHat built and distributed Qatlib RPM packages from the codeready-builder-for-rhel-9-x86_64-rpms repo. Refer to the [qatlib readme](https://github.com/intel/qatlib/blob/main/INSTALL) for more details.
3+
4+
* Build the workload container image
5+
6+
Please replace the credentials in buildconfig yaml with your RedHat account login credentials.
7+
8+
```
9+
$ oc apply -f https://raw.githubusercontent.com/intel/intel-technology-enabling-for-openshift/main/tests/l2/qat/qatlib_build.yaml
10+
```
11+
12+
* Create SCC intel-qat-scc for Intel QAT based workload, if this SCC is not created
13+
14+
```
15+
$ oc apply -f https://raw.githubusercontent.com/intel/intel-technology-enabling-for-openshift/main/security/qatlib_scc.yaml
16+
```
17+
18+
* Create the intel-qat service account to use intel-qat-scc
19+
20+
```
21+
$ oc apply -f https://raw.githubusercontent.com/intel/intel-technology-enabling-for-openshift/main/security/qatlib_rbac.yaml
22+
```
23+
24+
* Deploy the qatlib workload job with intel-qat service account
25+
26+
```
27+
$ oc apply -f https://raw.githubusercontent.com/intel/intel-technology-enabling-for-openshift/main/tests/l2/qat/qatlib_job.yaml
28+
```
29+
30+
* Check the results.
31+
```
32+
$ oc get pods
33+
intel-qat-workload-c6g9v 0/1 Completed 0 4m13s
34+
```
35+
36+
37+
* For all sample tests `cpa_sample_code`
38+
39+
```
40+
$ oc logs intel-qat-workload-c6g9v
41+
qaeMemInit started
42+
icp_sal_userStartMultiProcess("SSL") started
43+
There are no crypto instances
44+
*** QA version information ***
45+
device ID = 0
46+
software = 23.2.0
47+
*** END QA version information ***
48+
Inst 0, Affin: 0, Dev: 0, Accel 0, EE 0, BDF ED:00:01
49+
Inst 1, Affin: 1, Dev: 0, Accel 0, EE 0, BDF ED:00:01
50+
Inst 2, Affin: 2, Dev: 0, Accel 0, EE 0, BDF ED:00:01
51+
Inst 3, Affin: 3, Dev: 0, Accel 0, EE 0, BDF ED:00:01
52+
---------------------------------------
53+
API Traditional
54+
Session State STATELESS
55+
Algorithm DEFLATE
56+
Huffman Type STATIC
57+
Mode ASYNCHRONOUS
58+
CNV Enabled YES
59+
Direction COMPRESS
60+
Packet Size 8192
61+
Compression Level 1
62+
Corpus CALGARY_CORPUS
63+
Corpus Filename calgary
64+
CNV Recovery Enabled YES
65+
Number of threads 4
66+
Total Responses 158400
67+
Total Retries 2242671
68+
Clock Cycles Start 126150916653843
69+
Clock Cycles End 126151409143747
70+
Total Cycles 492489904
71+
CPU Frequency(kHz) 1700160
72+
Throughput(Mbps) 35920
73+
Compression Ratio 0.4897
74+
---------------------------------------
75+
76+
Inst 0, Affin: 0, Dev: 0, Accel 0, EE 0, BDF ED:00:01
77+
Inst 1, Affin: 1, Dev: 0, Accel 0, EE 0, BDF ED:00:01
78+
Inst 2, Affin: 2, Dev: 0, Accel 0, EE 0, BDF ED:00:01
79+
Inst 3, Affin: 3, Dev: 0, Accel 0, EE 0, BDF ED:00:01
80+
---------------------------------------
81+
```

0 commit comments

Comments
 (0)