How to Change the Attachments directory in Zephyr Enterprise Edition

August 05, 2016


How to change the attachment directory to other location when the disk space is running low or the 


Attachments is part of Zephyrdata directory where the attachments and other temp data is stored. If you want to change the attachment directory you have change the location of zephyrdata directory. Changing only attachment directory will not work and will result in unknown issues and data loss.

Instructions to move Zephyrdata to a new location

  1. Stop Zephyr Service
  2. Take a backup of zephyrdata folder present under <Zephyr_Installation_Directory>
    For a defaut Installation it will be
    Windows - C:\Program Files\Zephyr\
    Linux - /opt/ Zephyr
  3. Move the directory zephyrdata to a new location with all the files in it. (DO NOT DELETE ANY FILES)
  4. Navigate to the location <Zephyr_Installation_Directory> \tomcat\webapps\flex\WEB-INF\classes for a defaut Installation the complete path will be will be
    Windows - C:\Program Files\Zephyr\tomcat\webapps\flex\WEB-INF\classes
    Linux - /opt/ Zephyr/tomcat/webapps/flex/WEB-INF/classes
  5. Edit the file and change the below parameter value to current directory path. Take a backup of the file before editing.
    ZEPHYR_DATA=C:/Program Files/Zephyr/zephyrdata
    ex : ZEPHYR_DATA=D:/path/zephyrdata
  6. Save the file.
  7. Restart Zephyr Service

Verify the data

  1. Navigate to Testcase Creation and check if you are able to access all the attachments.
  2. Navigate to Testcase Execution and check if you can access all the attachments
  3. Navigate to Requirements and check if you can access all the attachments.
  4. Create attachments for Requirements, Testcases, executions and TestSteps.
  5. Check if the new attachments are created in the new location.

Roll Back Process

If you find any file is not accessible or any unknown issues exists revert the changes.

** We recommend not to go for this approach unless you are not able to increase the data volume of current disk.