www.gsx.com | log in | register

Last update: . Author: Alan Carson .

Error 503 occurs when Launching GSX Gizmo

This error is due to a known limitation of Apache CouchDB. Fixing the issue requires either:

  • To enable Windows short filename creation, also known as 'NTFS 8.3 file names'.
  • Or to reinstall CouchDB using a path not containing any spaces.

First, we will test if the NTFS 8.3 name option is disabled. If the option is disabled we will then try to enable it.
When allowing short filename creation is not possible, we will reinstall the CouchDB application.

GSX Gizmo 1.0.x

Symptoms

  • Error 503 view.custom.state.error.message 
  • Error From Database 

How to Solve the Issue

Checking the value of the Windows short file name creation option

  1. Open a command prompt with administrator privileges.
  2. Execute the command that checks 8dot3 name creation for drive C:
    • FSUTIL.EXE 8dot3name Query c:
  3. If the registry state value of NtfsDisable8dot3NameCreation is 1, it means Windows short file name creation is disabled on all volumes:
    Check_Registry_State.PNG

When enabling Windows short file name creation is OK

For better server performance, it is recommended to disable short file name creation as explained in this Microsoft TechNet.
Depending on your Windows Server administration best practices, it is not always possible to update this option. A workaround is provided later on in this article when enabling short file name creation is not acceptable.

Please follow these steps:

  1. Uninstall GSX Gizmo.
  2. Stop Apache CouchDB Windows Service from services.msc.
  3. Uninstall Apache CouchDB.
  4. Delete the remaining Apache CouchDB folder: C:\Program Files (x86)\Apache Software Foundation.
  5. Enable short file name creation by following these steps:
  • Open a command prompt with Administrator privileges.
  • Execute the command fsutil.exe behavior set disable8dot3 2
  • Check that the option is now set to the default value for all volumes with this command: FSUTIL.EXE 8dot3name Query c:
    Check_Registry_State_-_Enabled.PNG
  • Install GSX Gizmo.
  •  

    When enabling Windows short file name creation is not possible

    To fix the issue, we have to uninstall Apache CouchDB and reinstall using a folder path without spaces.
    By default CouchDB is installed in C:\Program Files (x86)\Apache Software Foundation. We will have to reinstall using C:/CouchDB or D:/DB/CouchDB for example.

    1. Stop GSX Gizmo Service Windows Service from services.msc.
    2. Stop Apache CouchDB Windows Service from services.msc.
    3. Uninstall Apache CouchDB.
    4. Delete the remaining Apache CouchDB folder: C:\Program Files (x86)\Apache Software Foundation.
    5. Install CouchDB in a folder path without spaces.
    6. Using a web browser, navigate to http://localhost:5984/_utils/
    7. Create a database named gizmo.
    8. Click Configuration on the right side of the page.

    9. Navigate to the httpd section.
    10. Double-click bind_address value.
    11. Change bind_address value from 127.0.0.1 to 0.0.0.0.
    12. Stop Apache CouchDB Windows Service.
    13. Start Apache CouchDB Windows Service.
    14. Start GSX Gizmo Service Windows Service.

    Related links

    Server 2012: Best Practice – Disable short file name creation.


    Downloads:

    Was this article helpful?

    0 out of 0 found this helpful




    Not finding what you are looking for?

    Have more questions? Submit a request