Dear Valued Customer, We are currently experiencing an issue with Alteryx Designer where the application closes upon opening and/or running workflows. Our team believes it has identified the root cause and is working to remedy the situation. We are sorry for this inconvenience and thank you for your patience. An e-mail will be sent once this issue is resolved. Alteryx Customer Support Team

Alteryx Analytics Hub Knowledge Base

Definitive answers from Alteryx Analytics Hub experts.

How To: Change the Virtual File System (Binary Storage) Location

DavidHa
Alteryx
Alteryx
Created

How To: Change the Virtual File System (Binary Storage) Location

This article describes the procedure to change the Virtual File System location used to store Analytics Hub assets such as Workflows and Data files.


Prerequisites
  • Alteryx Analytics Hub
    • All versions



Background
The Virtual File System is used to store all Alteryx Analytics Hub assets such as Workflows, Analytic Apps, Macros, and data files. These files are available to end users under the Files section of their Site.  More information about the Virtual File System can be found here




At product installation, an installation path is required which specifies where the Alteryx Analytics Hub product binaries are stored, in addition to the Virtual File System assets.





The assets in the Virtual File System are stored in a vfs folder underneath the product installation directory.  For a default installation, that directory path is:


C:\Program Files\Alteryx\vfs\

If you would like to separate out the Virtual File System assets to a different disk location or drive, follow the steps below.


Procedure
 

  1. Perform a backup of the Analytics Hub environment following the steps in the documentation. Do NOT skip this step. 
  2. Take a backup of the [INSTALL_HOME]\Alteryx Analytics Hub\Settings.yml file.  Any errors or typos in this file can prevent Analytics Hub from functioning properly, so proceed with caution.  Do NOT skip this step.
     
  3. Stop Analytics Hub services using the ayxhub.ps1 command line utility. For detailed command usage refer to the command line documentation.
    • [INSTALL_HOME]\Alteryx Analytics Hub\ayxhub.ps1 -stop
       
  4. Update the binary_storage path variable in the Settings.yml file with the desired new location for the Virtual File System storage.
    • [INSTALL_HOME]\Alteryx Analytics Hub\Settings.yml
       
The Default Settings.yml will look like this:
    


The following shows a modified Settings.yml with a new binary storage path pointing to D:\vfs

​​​
  1. ​Move the storage folder from the original vfs directory to inside the new vfs directory.
    ​​​​​​
        Example Old Path - C:\Program Files\Alteryx\vfs\storage
        Example New Path - D:\vfs\storage
 
  1. Use PgAdmin to connect to the Postgres server on your Alteryx Analytics Hub machine. Refer to the documentation for details.
  • Select the ngp database.
  • Right-click and open the Query Tool.



    Execute the following query, be sure to replace the path below with your desired new location.
UPDATE platform.plt_settings SET binary_storage_settings = '{"path":"D:\\vfs","type":"FS_LOCAL"}'

If you need to revert back to the original location, use the following:

 
UPDATE platform.plt_settings SET binary_storage_settings = '{"path":"C:\\Program Files\\Alteryx\\vfs","type":"FS_LOCAL"}'
 
  1. Start Analytics Hub services using the ayxhub.ps1 command line utility. For detailed command usage refer to the command line documentation.
    • [INSTALL_HOME]\Alteryx Analytics Hub\ayxhub.ps1 -start


At this point Alteryx Analytics Hub should be back up and running with the Virtual File System pointed to the new storage directory.  If you encounter any problems, revert back to the original Settings.yml file and Postgres backup.  


 
No ratings