Recovering YAPI from Back Up

If a catastrophic failure occurs on the server that houses YAPI and its services, corruption may occur to YAPI that can cause a fatal error and as a result, cause YAPI to not function. This can be seen when attempting to start the YAPI Service from the server; an error message can appear stating that the service has timed out or that the service is unable to start. 

Untitled_2.png

As a result, YAPI must attempt to be reinstalled on the server to function correctly once more, but this will also clear any preexisting data such as configurations, forms, and other essential data.

Under the circumstance that the Practice has already established a Back-Up Recovery program on the server, YAPI can be recovered with prior data while also avoiding data loss. This process will require overriding a pre-existing folder called the YService with another version of YService from a prior saved instance of the server. 

To recover a broken YAPI with a back-up copy, do the following steps:

Warning! Be sure to have the backup copy of the YService available before proceeding. Ensure that this copy is from an instance when YAPI was still functioning.

  1. Search for the YAPIServiceManager icon on the desktop of the server. Right-click on the icon, then from the dropdown that appears click on the Open File Location option.

    2020-05-27_14-25-58.png

  2. A Windows Explorer will open showing the contents of the YService. From the bar at the top of the Windows Explorer, click on Practical Dental Solutions. This will show the folder that houses the Service.

    2020-01-08_14-25-12.png

    NOTE: The typical file location for a YAPI Service installation will be in:

    C:\Users\*******\AppData\Local\Practical Dental Solutions\YService 

    (******* will refer to the User that was used during the initial YAPI installation)

    If YAPI was cloned to another drive besides its default location, Open File Location the shortcut on the desktop to determine its new location.

  3. Right-click on the YService folder and from the dropdown that appears, click on the Delete option. DO NOT CLICK OUT OF THIS WINDOW YET.

  4. Copy the back-up copy of the YService folder from the pre-existing server instance. Paste the folder in its entirety in the Practical Dental Solutions folder. 

  5. On the desktop of the server, right-click on the YAPIServiceManager icon and click on Run as Administrator from the dropdown selection.

    2020-05-27_14-25-58.png

  6. From the YAPI Service Manager window, click on the Configure button on the right-hand side of the window. An error may occur claiming that the NIC card needs adjustment. 

    2020-05-27_15-04-04.png

  7. A new Configure Service window will appear. The service will actively use the NIC card it has been defaulted to on the server. If the IP Address is valid for use on the server, click on the Proceed button. Otherwise, click on the Always use this network interface checkbox and from the dropdown below it, click on the NIC card to use instead. 

    2020-05-27_15-08-18.png

    NOTE: Windows may require permission for the ports used in YAPI to be opened. If these pop-ups occur, proceed to allow them access. A list of YAPI Outgoing and Incoming Network Ports is available if needed in the future.

  8. Returning back to the YAPI Service Manager, click on the Configure Plug-in button on the right-hand side of the window. 

    2020-05-27_15-04-04.png

  9. Depending on the Practice Management Software used with YAPI, the process to tether the PMS with YAPI will be different.

    • Open Dental

      1. A YAPI Plugin for Open Dental window will appear requesting credentials to access the active Open Dental on the local machine. In the Server field, type in the IP address of the server. The additional fields will be information found on the Open Dental Database window.

        image28.jpg

         NOTE: Match this section from Open Dental by going through OpenDental> File>Choose Database and match these fields.

      2. The following will be requesting specific statuses that will be linked to actions within Open Dental. Use the following chart to match the Action with the Status.

        Patient Here Status Arrived
        Patient Seated Status In Treatment Room
        Treatment Completed Status In Treatment Room
        Patient Gone Status Dismissed
        Appointment Confirmed Status Appointment Confirmed
        Appointment Confirmation Audit Trail ApptRelated
        Medical History Update Audit Trail Misc

         

      3. A pop-up will appear confirming the plugin version, click Ok. After which a Forms window will appear showing the default Patient Information and Medical History forms available in the plugin. Exit out of this window so as to not override any custom edited forms used by the office. 

      4. After a delay, a new pop-up requesting MySQL dependency will appear. Click the Yes option, and the Open Dental plugin configuration will be complete. 

        image48.png

    • Eaglesoft
      1. A pop-up will appear confirming the plugin version, click Ok. After which a Forms window will appear showing the default Patient Information and Medical History forms available in the plugin. Exit out of this window so as to not override any custom edited forms used by the office.

      2. A new window will appear showing a highlighted script that can be copied. This window can be closed out since the script as already been applied to the Eaglesoft during the initial installation. 

      3. After closing out of the last window, the Eaglesoft plugin configuration will be complete. 

    • Dentrix

      1. Authorize Access to Dentrix window will appear with preset fields highlighted in green. Continue by clicking the Ok button.

        2020-05-28_14-19-57.png

        NOTE: If there is missing data within the fields or if the fields are not highlighted, contact YAPI support to apply the necessary executables. 

      2. A window confirming an Integration action is in the process will appear, click Ok

      3. A pop-up will appear confirming the plugin version, click Ok. After which a Forms window will appear showing the default Patient Information and Medical History forms available in the plugin. Exit out of this window so as to not override any custom edited forms used by the office. After closing this out, the Dentrix plugin configuration will be complete. 

  10. After completing the Plugin configuration, click on the Start Service button on the top-left corner of the window. If the Stop Service button lights up blue, then the service is now active. 

    2020-05-28_14-32-00.png

  11. Launch YAPI from the server to confirm that it is functioning. If any additional errors or if missing data is still apparent, contact YAPI Support.

Was this article helpful?
1 out of 2 found this helpful