Kit Testing without User Authentication#

Insecure Connection to the Storage Deployment (No Authentication)#

There is a known issue in Kit 109.0.1, when no authentication is needed for a deployment, you cannot add the connection with in Kit. This will be fixed in the next release of Kit.

Unfortunately, this means to test the connection, you will need to test in Kit slightly differently than you would for a deployment that uses secure connections.

Create the USD File#

First we will upload a simple usda file to the storage service. Save the file below to your local machine as cube.usda.

#usda 1.0
(
   customLayerData = {
      dictionary cameraSettings = {
            dictionary Front = {
               double3 position = (0, 0, 50000)
               double radius = 500
            }
            dictionary Perspective = {
               double3 position = (31.228726468341044, 6.955740397133659, 15.62341018564353)
               double3 target = (0.06364292377851655, 3.4744941220079357, -0.9826701764198784)
            }
            string boundCamera = "/OmniverseKit_Persp"
      }
   }
)

def Xform "World"
{
   def Cube "Cube"
   {
   }

   def SphereLight "KeyLight"
   {
      float inputs:intensity = 10000
      double3 xformOp:scale = (8, 8, 8)
      double3 xformOp:translate = (10, 10, 0)
      uniform token[] xformOpOrder = ["xformOp:translate", "xformOp:scale"]
   }
}

Write the File to the Storage Service#

Now we’ll save the USD data to the storage service.

#generate the USD data
export USD_DATA="$(cat cube.usda)"
# get the data size
export SIZE="$(echo -n "${USD_DATA}" | wc -c)"


# upload the usda file to the storage service
curl -X PUT "http://localhost:8011/v1beta/fileobject/by-address/file-storage%3A%2F%2Ffileservice%2Fcube.usda?data_object_size=${SIZE}&upload_preference=body" -H "Content-Type: application/json" --data "${USD_DATA}"

Validate the Upload#

You should see the proper response from the storage service and you can even list to see what’s in the storage service.

# list the top level of the storage service
curl "http://localhost:8011/v1alpha/filefolder/list/file-storage%3A%2F%2Ffileservice"

Your content is ready for Kit.

Download and Configure Kit#

Follow these steps to download, configure, and launch Kit:

  1. Download Kit 109.0.1 SDK or later Download from the appropriate link: Linux or Windows.

    Kit SDK Download
  2. Extract and Prepare the SDK Unzip the downloaded archive, then change (cd) into the extracted directory. Open a terminal window in that directory and edit the shell file you use to launch Kit:

    cd kit-sdk-linux-109.0.1
    kate omni.app.full.sh
    
  3. Configure Kit for Your Deployment Insert the following line into omni.app.full.sh before the ${EXEC:-exec} line, and replace {discovery-url} with the URL of your Discovery service:

    # for local deployment or deployments that do not use secure connections use http://{discovery-url} instead of https://{discovery-url}
    export OMNI_STORAGE_DISCOVERY=http://{discovery-url}
    
  4. Launch Kit Save your changes and start Kit by running:

    ./omni.app.full.sh
    

Opening your USD file in Kit#

  1. File > Open Because of the limitations described above, you cannot add the connection to the Content Browser and explore the storage service. However, you can still open the USD file by selecting File > Open.

    ../../_images/kit-file-open.png
  2. Enter Your Storage URL To open the USD file, you need to use the file path (without percent encoding), which would look like file-storage://fileservice/cube.usda.

    ../../_images/kit-file-dialog.png
  3. Open the USD File After the file opens, you should see a view like the one below.

    ../../_images/kit-local-test.png