XVHost Push Command:

xvhost push “<directory>” to dicoms://<address>:<port>/<AE> from cert <filename.pfx> callingAE <uniquename>

Example:

xvhost push “C:\Images” to dicoms://dicom.Apteryx.net:2762/demo2 cert "C:\demo2.pfx"

date-from example:

vhost push "F:\Apteryx\XVCapture\Databases\Images" to dicoms://dicom.Apteryx.net:2762/gcd cert "F:\Apteryx\XVCapture\Apteryx_net_gcd.pfx" date-from 01/01/2022

Failure to run

Run the vc_redist.x*.exe

Other flags

no-timeout

one-at-a-time     (use for very slow connections)

move-to "C:\Folder-to-move-pushed-files\"

Can Manually Serve but not Run as a Service

Make sure that the account being used to run XVHost as service has been granted access to the SQL database.

Connection String

Data Source=*instance*;Initial Catalog=*database name*;Integrated Security=true;multipleactiveresultsets=True;

Cannot Install XVHost as a Service (Error 0)

Try installing xvhost using the service manager command line util.  don’t forget to use an admin command prompt.

sc create xvjpst displayname= "XVHost" binpath= "*Fully qualified path*\xvhost.exe"

Push

In order for you to use the XVHost.exe program to do a DICOM push, all you need is the “XVHost.exe” executable file, and an ”XVhost.config” file (it does not matter if the variables like “Server” or “Database” have any information in their values or not. The file just needs to exist in the folder or XVHost.exe will complain). You may also need to run the vcredist for C++ 2015, depending on the age of the OS you are trying to run the push from.

If you open a CMD window to the XVHost folder, the basic push command is as follows:

xvhost push “*Directory Path of Images to be pushed*” to dicoms://*destservernameorIP*:*port*/*AETitle*

You can also add some additional variables after the end of this main command: Cert, Move-to, Date-To, Date-From, Study-Date-To, Study-Date-From

1. Cert *pathtopfxsecurityfile* - you will need to use this with the pfx security file to push images to Apteryx.

2. Move-To *destinationfolderpath* - this variable and path will move the images from the original directory specified in the main command to the destination path after the successful push. We use this quite a bit. If something happens in the middle of the push which causes it to crash, if the server restarts, etc. the push has to start all over again since XVHost is not indexing anything in the source folder. If you move the images as they are pushed, it can pick back up where it left off when you start it again. The downside to this is that you cannot move the images if your source image folder is being used as part of a live image database. You would need to replicate the data to a separate folder that you can push from so it can be moved to a separate folder without impacting people’s viewing in production.

3. The study-date-from and study-date-to can only be used in conjunction with each other and indicate a time range of dicom study dates to push. Date formats are always MM/DD/YYYY format and must include the forward slashes.

4. the date-from and date-to can be used independently from other commands to specify a floor/ceiling of dates to push. Date formats are always MM/DD/YYYY format and must include the forward slashes.

Errors

(0110) Sequence contains more than one element

This is caused by there being more DICOM tags in the image than Apteryx is expecting to receive (unconfirmed). There is no known workaround for this issue using XVH. The practice will need to import these images directly into Apteryx.