Skip to main content

Troubleshoot VWRs

This page provides troubleshooting information for Macrometa PhotonIQ Virtual Waiting Rooms (VWRs).

No Waiting Room Configured​

If a waiting room has not been configured, then the waiting room library returns the header No-Waiting-Room. This means that the waiting room URL is not configured correctly.

Troubleshoot Waiting Room HTML​

You have the option to set the URL for the waiting room HTML template either via the library or the waiting room record. To get a preview of the waiting room HTML template, launch your preferred web browser and go to the following URL: https://<hostname>/waiting-room-path>/preview. For example, http://show.store.com/checkout/preview.

The vwrs-cookie cookie holds valuable information regarding each user's access to the waiting room. If you need to debug and access the content of the cookie, then you can enable debugging mode when calling the handleVwrsRequest() function. Enabling debugging mode stores the unencrypted cookie in the x-vwrs-debug header, granting you access to its content for debugging purposes.

export async function onClientRequest(request) {
  const reqOptions = {
    waitingRoomPath: "/1473985/doc.html",
    debugMode: true,
  };
  await virtualWaitingRoomConfiguration.handleVwrsRequest(request, reqOptions);
}
export async function onClientResponse(request, response) {
  const reqOptions = {
    debugMode: true,
  };
  await virtualWaitingRoomConfiguration.handleVwrsResponse(
    request,
    response,
    reqOptions
  );
}

VWRs EdgeWorker Exceeding PM_USER Space​

The VWRs EdgeWorker uses Akamai's Property Manager user-defined variables. The maximum limit supported by Akamai EdgeWorkers is 1024 characters. If this limit is exceeded, the following error message is displayed by the library code: Setting metadata variable would exceed total variable size limit.

Report Status Codes​

When running library code, the library provides status codes to inform users about limitations and issues in the form of four-letter codes. These status codes are stored in the PMUSER_VWRS_STATUS_CODE variable.

For a comprehensive list of the meaning behind each four-letter code, refer to VWRs Status Codes.

Request-Level Debugging​

Use Akamai’s enhanced debugging to get detailed information on how VWRs runs. For more information, refer to the Enhanced debug headers section of Akamai’s About Javascript troubleshooting documentation.