vGPU Profile

Overview#

You can configure vGPU profile selection as a customizable option for SolusVM products in WHMCS. This allows customers to choose an NVIDIA GPU profile when ordering a virtual server.

Prerequisites#

Before you configure a vGPU Profile configurable option, make certain that:

• You use version 1.0.61 or higher of the SolusVM 2 module.
• You have configured a vGPU profile for at least one GPU-equipped compute resource in SolusVM.

For more information and steps to enable vGPU support, configure vGPU, and create a vGPU-enabled plan, see our Virtual GPUs (vGPUs) documentation.

Create a vGPU Profile configurable option#

1. Log in to the WHMCS Admin Area.

2. Go to Configuration > System Settings > Configurable Options:

   

3. Click Create a New Group or select an existing group.

4. Enter a group name, select the product you created earlier to assign to the group, and then click Save Changes.

   

5. Click Add New Configurable Option and specify the option settings.

6. Enter vGPU Profile as the option name and select Dropdown as the option type.

7. Run the following command on the SolusVM management node to retrieve the GPU profile IDs:

   docker exec -it $(docker ps -q -f name=solus_postgres | head -n1) psql -U$(docker exec $(docker ps -q -f name=solus_postgres | head -n1) env | grep POSTGRES_USER | awk -F "=" {'print $2'}) $(docker exec $(docker ps -q -f name=solus_postgres | head -n1) env | grep POSTGRES_DB | awk -F "=" {'print $2'}) -c 'SELECT gp.id, gp.name, COUNT(DISTINCT g.compute_resource_id) AS connected_crs_count FROM gpu_profiles gp LEFT JOIN gpus g ON g.gpu_profile_id = gp.id GROUP BY gp.id ORDER BY gp.name;'

   The output lists each profile’s ID, name, and the number of compute resources currently using that profile:

    id |     name      | connected_crs_count
   ----+---------------+---------------------
    17 | NVIDIA L4-12A |                   0
     9 | NVIDIA L4-12Q |                   0
     4 | NVIDIA L4-2Q  |                   1
     7 | NVIDIA L4-6Q  |                   1
   (4 rows)

   Record the id and name values for the profiles that you want to offer.

   Important:

   Server provisioning succeeds only for profiles with a connected_crs_count value of 1 or higher.

8. In the Add Option text box, enter the option value using the format: GPU_PROFILE_ID|DISPLAY_NAME, where:

   • GPU_PROFILE_ID is the id value from the command output.
   • DISPLAY_NAME — The label that displays to customers.

   Note:

   • IDs must exactly match the values in the SolusVM database. Incorrect IDs will cause server provisioning to fail.
   • To allow customers to order a server without a vGPU, add 0|None as the first value.

9. Click Save Changes.

10. Repeat steps 8 and 9 for each GPU profile that you want to offer, and then click Close Window.