Skip to main content

XVHost Push

Michael Satterfield
Updated

Troubleshooting

Image conversions to Apteryx require an XVHost Push in order to upload the converted images from the client's machine to their Apteryx site. This upload should typically be done concurrently with the conversion, except for cases of high resource usage, and 3D images.

** If you are converting 3D images, DO NOT start XVHost Push until following steps in the 3D Images section of this OneNote.

  1. Obtaining Apteryx Site Certs

    1. Confirm client's Apteryx URL (they should be logged in to their Apteryx site on the server). The URL should be the same as found in the conversion Zendesk ticket.

    2. Search for the URL in the Apteryx Sites Dashboard. Office name should match office name in ticket. If so, click URL.

    3. Click Site Locations and compare Name, Phone, Address fields to same fields in Zendesk ticket. These should all be very similar if not the same.

    4. Go back to the site's landing page and click Download Cetificates. Input URL then click confirm. Certs should download to your default directory.

      1. Move certificates to a different location on your PC if needed for easier access.

  2. Setting up Push Loop

    1. In LogMeIn File Manager, transfer cert zip from your PC to the \converter\XVHost folder

    2. Unzip certs to \converter\xvhost folder

    3. Copy the path of the .pfx file (hold shift key when right-clicking .pfx file, choose copy as path)

    4. In the XVHost folder, right click the push-delloop.bat > edit

    5. Paste .pfx file path after cert (retain quotes around path)

    6. Paste subdomain of Apteryx site after dicom.Apteryx.net:2762/

    7. Save file

  1. Running Push Loop

    1. Search bar (windows key + Q) > cmd > run as Administrator

    2. Navigate to the \converter\xvhost folder

    3. Run push-delloop.bat

    4. Momentarily, images should begin pushing. Message in command prompt window will say something like "1 of ### - success"

    5. Window will say "No DICOM Images Found" if there are no images in the Apteryx-Images folder

    6. Once the conversion has completed and there are no images left in the Apteryx-Images folder, the push is complete.

Troubleshooting

  • XVHost Taking Up Space

  • Association Rejected

  • Sequence Contains No Elements

  • System.Exception

  • Files Stuck in Images Folder

  • Missing SOP Class UID

  • 32-bit Windows Error

  • Slow Connections/Time-outs

  • Conversion Percentage

XVHost Taking Up Space

If XVHost crashes continuously, it will create a bunch of .dmp files in the XVHost folder which can take up a lot of space and cause the command to delete the Apteryx-stored contents to not work.

You can remove the .dmp files from the XVHost folder and run the following command line arguments manually to empty the Apteryx-stored folder:

dir /b ..\Apteryx-stored >> ..\stored-UID-list.txt

NOTE: Confirm the Stored-UID-list.txt file was actually written to and contains some of the UIDs in the Apteryx-stored folder before proceeding to the next command.

del /q ..\Apteryx-stored\*

Association Rejected

DICOM files that fail to upload with error "Failed:  Association Rejected" or "Missing SOP Class UID"

Open some of these files in DicomViewer, and see if the SOP Class UID tag is present.

If SOP Class UID is missing for these files, this tag will need to be added:

  1. Install Sante DICOM Editor

  2. Launch Sante DICOM Editor

  3. Go to File > Batch > Modify DICOM Files

  4. Enter the path to the Apteryx-Images folder where the files that failed to upload are stored.

  5. Check the Modify box, and check Insert tag if not exists

  6. Click Create New Template
     

    XVHost1.png

  7. Click Insert Tag…

  8. Enter the DICOM tag info for SOP Class UID, or click From List… to select it manually:

    XVHost2.png

  9. Enter the new value for the SOP Class UID to be assigned to all files.  The correct SOP Class UID may not be the same for all files.  Here are some example:

    1. Intraoral X-ray (IO modality):   1.2.840.10008.5.1.4.1.1.1.3

    2. 3D/CT file (CT modality):   1.2.840.10008.5.1.4.1.1.2

      1. These are typically large files over 30MB, and would need to be updated separately from the smaller files.

    3. Generic CR modality:  1.2.840.10008.5.1.4.1.1.1

  10. In this example, all files will be set to Intraoral X-ray SOP Class UID: 

    XVHost3.png

  11. Click OK on both windows, and you will be prompted to save these settings to a "Template.sdt" file. Save this file.

  12.  Back in the Batch Modify window, under Modify, click Select Template . Select the path to the template sdt file that was saved above.

  13. Click the Process button.

    XVHost4.png

  14. The tool will create a new set of DICOM files in the same directory, with _mod added to the filename.

    XVHost5.png

  15. Move all the old DICOM files to a backup folder, leaving only the _mod files in the directory to be uploaded.

  16. Run xvhost push command to upload the _mod DICOM files.

Sequence Contains No Elements

Most likely a DICOM tag is empty, or a DICOM sequence is missing some tags.

Example:

XVHost6.png

The sample DICOM file on the left defines an "Anatomic Region Sequence", but then it is missing the Code Value, Coding Scheme Designator, Code Meaning tags.

Resolution:  These tags would either need to be manually added (if the correct value is known), or the customer would need to be notified that these files could not be imported due to missing anatomic information.

System.Exception

Error:  Exception of type 'System.Exception' was thrown.

Try opening these files in DicomViewer, and go to View Image to confirm that the image displays successfully.

Most likely the image format is not supported. It may be possible to use the Image Importer in XVCapture to import these files instead.

Files Stuck in Images Folder

Issue: Files push with result "Success", but they do not get moved from the Images folder to the Stored folder.

Cause 1:  Windows permissions prevent the file from being moved to the Stored folder.

Fix:  Take ownership of all files and subfolders within the converter directory and subfolders. Then change permission on all files and subfolders in the converter directory to Full Control for Everyone.

Fix 2:  Alternatively, run the push completely at least 3 times to make sure all files have pushed successfully.

Cause 2:  files with the same name already exist in the Stored folder, so the move fails. In this case nothing needs to be done.

Missing SOP Class UID

See instructions under related error: Association Rejected

32-bit Windows Error

Error:  Xvhost.exe is not compatible with the version of Windows you're running.  Check your computer's system information to see whether you need a x86 (32-bit) or x64 (64-bit) version of the program, and then contact the software publisher.

Cause:  XVHost needs to be run from a 64-bit version of Windows, not 32-bit.

Resolution:  Contact the customer and request to connect to a newer PC in the office (Windows 10) which will most likely be 64-bit.  Run the xvhost upload from that PC, while still running the conversion from the server.

Slow Connections/Time-outs

For customers with slow internet connections, or issues with timeouts, while running the normal xvhost push command, add this parameter at the end:

one-at-a-time

Original command example: 

xvhost push "D:\converter\Apteryx-Conversion\Images" to dicoms://dicom.Apteryx.net:2762/testing cert "D:\converter\Apteryx_net_testing.pfx"  move-to  "D:\converter\Apteryx-Conversion\Stored"

New command example:

xvhost push "D:\converter\Apteryx-Conversion\Images" to dicoms://dicom.Apteryx.net:2762/testing cert "D:\converter\Apteryx_net_testing.pfx"  move-to  "D:\converter\Apteryx-Conversion\Stored" one-at-a-time

Conversion Percentage

First you need to obtain the most upto date Imagecache and logs folder images sheet.

Open the imagecache in Notepad and scroll to bottom to copy this string.

Next, using Notepad++ search the file with the thread you copied.

Inside Notepad++ the thread was on 644,026 of total 1,358,451.  Divide 644,026 / 1,358,451 = 47%

Alternatively, place this executable in the converter directory, open a command-line prompt, and run the exe. 

NOTE: This does NOT work for Apteryx / XV4 / Dentrix Ascend conversions.

Can’t insert EXE because IT blocked the file from download in OneNote

Sample output: