Compare commits
No commits in common. "4325560ec4552ebd778f981698dd22d9670fd43a" and "52ffedffc72306edcf1ded258e9cd4e9c2654202" have entirely different histories.
4325560ec4
...
52ffedffc7
126
README.md
126
README.md
@ -14,6 +14,64 @@ Only the clients need a connection to this service on configured port.
|
|||||||
- check why windows guests display "can't acquire license" although in log there is no message displayed and license is
|
- check why windows guests display "can't acquire license" although in log there is no message displayed and license is
|
||||||
also acquired successfully
|
also acquired successfully
|
||||||
|
|
||||||
|
## Endpoints
|
||||||
|
|
||||||
|
### `GET /`
|
||||||
|
|
||||||
|
Redirect to `/-/readme`.
|
||||||
|
|
||||||
|
### `GET /-/health`
|
||||||
|
|
||||||
|
Status endpoint, used for *healthcheck*.
|
||||||
|
|
||||||
|
### `GET /-/config`
|
||||||
|
|
||||||
|
Shows current runtime environment variables and their values.
|
||||||
|
|
||||||
|
### `GET /-/readme`
|
||||||
|
|
||||||
|
HTML rendered README.md.
|
||||||
|
|
||||||
|
### `GET /-/docs`, `GET /-/redoc`
|
||||||
|
|
||||||
|
OpenAPI specifications rendered from `GET /-/openapi.json`.
|
||||||
|
|
||||||
|
### `GET /-/manage`
|
||||||
|
|
||||||
|
Shows a very basic UI to delete origins or leases.
|
||||||
|
|
||||||
|
### `GET /-/origins?leases=false`
|
||||||
|
|
||||||
|
List registered origins.
|
||||||
|
|
||||||
|
| Query Parameter | Default | Usage |
|
||||||
|
|-----------------|---------|--------------------------------------|
|
||||||
|
| `leases` | `false` | Include referenced leases per origin |
|
||||||
|
|
||||||
|
### `DELETE /-/origins`
|
||||||
|
|
||||||
|
Deletes all origins and their leases.
|
||||||
|
|
||||||
|
### `GET /-/leases?origin=false`
|
||||||
|
|
||||||
|
List current leases.
|
||||||
|
|
||||||
|
| Query Parameter | Default | Usage |
|
||||||
|
|-----------------|---------|-------------------------------------|
|
||||||
|
| `origin` | `false` | Include referenced origin per lease |
|
||||||
|
|
||||||
|
### `DELETE /-/lease/{lease_ref}`
|
||||||
|
|
||||||
|
Deletes an lease.
|
||||||
|
|
||||||
|
### `GET /-/client-token`
|
||||||
|
|
||||||
|
Generate client token, (see [installation](#installation)).
|
||||||
|
|
||||||
|
### Others
|
||||||
|
|
||||||
|
There are some more internal api endpoints for handling authentication and lease process.
|
||||||
|
|
||||||
# Setup (Service)
|
# Setup (Service)
|
||||||
|
|
||||||
## Docker
|
## Docker
|
||||||
@ -280,64 +338,6 @@ Restart-Service NVDisplay.ContainerLocalSystem
|
|||||||
'C:\Program Files\NVIDIA Corporation\NVSMI\nvidia-smi.exe' -q | Select-String "License"
|
'C:\Program Files\NVIDIA Corporation\NVSMI\nvidia-smi.exe' -q | Select-String "License"
|
||||||
```
|
```
|
||||||
|
|
||||||
## Endpoints
|
|
||||||
|
|
||||||
### `GET /`
|
|
||||||
|
|
||||||
Redirect to `/-/readme`.
|
|
||||||
|
|
||||||
### `GET /-/health`
|
|
||||||
|
|
||||||
Status endpoint, used for *healthcheck*.
|
|
||||||
|
|
||||||
### `GET /-/config`
|
|
||||||
|
|
||||||
Shows current runtime environment variables and their values.
|
|
||||||
|
|
||||||
### `GET /-/readme`
|
|
||||||
|
|
||||||
HTML rendered README.md.
|
|
||||||
|
|
||||||
### `GET /-/docs`, `GET /-/redoc`
|
|
||||||
|
|
||||||
OpenAPI specifications rendered from `GET /-/openapi.json`.
|
|
||||||
|
|
||||||
### `GET /-/manage`
|
|
||||||
|
|
||||||
Shows a very basic UI to delete origins or leases.
|
|
||||||
|
|
||||||
### `GET /-/origins?leases=false`
|
|
||||||
|
|
||||||
List registered origins.
|
|
||||||
|
|
||||||
| Query Parameter | Default | Usage |
|
|
||||||
|-----------------|---------|--------------------------------------|
|
|
||||||
| `leases` | `false` | Include referenced leases per origin |
|
|
||||||
|
|
||||||
### `DELETE /-/origins`
|
|
||||||
|
|
||||||
Deletes all origins and their leases.
|
|
||||||
|
|
||||||
### `GET /-/leases?origin=false`
|
|
||||||
|
|
||||||
List current leases.
|
|
||||||
|
|
||||||
| Query Parameter | Default | Usage |
|
|
||||||
|-----------------|---------|-------------------------------------|
|
|
||||||
| `origin` | `false` | Include referenced origin per lease |
|
|
||||||
|
|
||||||
### `DELETE /-/lease/{lease_ref}`
|
|
||||||
|
|
||||||
Deletes an lease.
|
|
||||||
|
|
||||||
### `GET /-/client-token`
|
|
||||||
|
|
||||||
Generate client token, (see [installation](#installation)).
|
|
||||||
|
|
||||||
### Others
|
|
||||||
|
|
||||||
There are some more internal api endpoints for handling authentication and lease process.
|
|
||||||
|
|
||||||
# Troubleshoot
|
# Troubleshoot
|
||||||
|
|
||||||
## Linux
|
## Linux
|
||||||
@ -358,9 +358,6 @@ This message can be ignored.
|
|||||||
|
|
||||||
- Ref. https://github.com/encode/uvicorn/issues/441
|
- Ref. https://github.com/encode/uvicorn/issues/441
|
||||||
|
|
||||||
<details>
|
|
||||||
<summary>Log example</summary>
|
|
||||||
|
|
||||||
```
|
```
|
||||||
WARNING:uvicorn.error:Invalid HTTP request received.
|
WARNING:uvicorn.error:Invalid HTTP request received.
|
||||||
Traceback (most recent call last):
|
Traceback (most recent call last):
|
||||||
@ -379,8 +376,6 @@ Traceback (most recent call last):
|
|||||||
h11._util.RemoteProtocolError: no request line received
|
h11._util.RemoteProtocolError: no request line received
|
||||||
```
|
```
|
||||||
|
|
||||||
</details>
|
|
||||||
|
|
||||||
## Windows
|
## Windows
|
||||||
|
|
||||||
### Required cipher on Windows Guests (e.g. managed by domain controller with GPO)
|
### Required cipher on Windows Guests (e.g. managed by domain controller with GPO)
|
||||||
@ -457,9 +452,6 @@ The driver wants to release current leases on shutting down windows. This endpoi
|
|||||||
is currently not implemented. The error message looks like and safely can be ignored (since we have no license
|
is currently not implemented. The error message looks like and safely can be ignored (since we have no license
|
||||||
limitation :P):
|
limitation :P):
|
||||||
|
|
||||||
<details>
|
|
||||||
<summary>Log example</summary>
|
|
||||||
|
|
||||||
```
|
```
|
||||||
<1>:NLS initialized
|
<1>:NLS initialized
|
||||||
<1>:License acquired successfully. (Info: 192.168.178.110, NVIDIA RTX Virtual Workstation; Expiry: 2023-3-30 23:0:22 GMT)
|
<1>:License acquired successfully. (Info: 192.168.178.110, NVIDIA RTX Virtual Workstation; Expiry: 2023-3-30 23:0:22 GMT)
|
||||||
@ -482,8 +474,6 @@ limitation :P):
|
|||||||
<0>:End Logging
|
<0>:End Logging
|
||||||
```
|
```
|
||||||
|
|
||||||
</details>
|
|
||||||
|
|
||||||
# Credits
|
# Credits
|
||||||
|
|
||||||
Thanks to vGPU community and all who uses this project and report bugs.
|
Thanks to vGPU community and all who uses this project and report bugs.
|
||||||
|
Loading…
Reference in New Issue
Block a user