/
4. Set Up a Shared Directory

4. Set Up a Shared Directory

Starting October 11, 2024 (Zephyr Enterprise 8.2), the Zephyr Enterprise documentation moved from its current location on Atlassian to a dedicated, standalone Zephyr Enterprise documentation page. Please see: https://support.smartbear.com/zephyr-enterprise/docs/en/zephyr-enterprise/zephyr-installation-and-upgrade-guides/zephyr-on-premise-production-installation/set-up-zephyr-data-center-cluster/4--set-up-a-shared-directory.html

A shared directory in a cluster is a shared folder where attachments are stored. In a cluster environment, this folder must be shared with write permissions. A folder is shared on NAS (network-attached storage) or similar devices, and then it can be accessed by the users working with Zephyr running on cluster nodes.

To set up a shared directory, do the following:

On Windows:

1. Create a shared folder with read and write access on NAS.

2. On all Zephyr nodes, open the Zephyr folder\tomcat\webapps\flex\WEB-INF\classes\jdbc.properties file, find the following line:

ZEPHYR_DATA = Zephyr folder/zephyrdata

and replace the Zephyr folder part with the IP address of your NAS. For example:

ZEPHYR_DATA= //192.168.11.141/zephyrdata

Now, you can use your shared folder.

On Linux:

Install the NFS (Network File System) server and client on CentOS 7.

On the server side:

1. Install the required NFS packages by running the following command:

 yum install nfs-utils

 2. Create the Zephyrdata directory and allow access to it:

chmod -R 777 /homeZephyrdata

If you installed Zephyr as a non-root user, install the NFS server and client as a root user and create the Zephyrdata directory as a non-root user.

3. Start the following services and add them to the Boot Menu:

systemctl enable rpcbind
systemctl enable nfs-server
systemctl enable nfs-lock
systemctl enable nfs-idmap
systemctl start rpcbind
systemctl start nfs-server
systemctl start nfs-lock
systemctl start nfs-idmap

4. Open exports for editing –

sudo gedit /etc/exports

– and type the following:

/home/zephyrdata 192.168.0.101(rw,sync,no_root_squash,no_all_squash)
/home/zephyrdata 192.168.0.102(rw,sync,no_root_squash,no_all_squash)

 192.168.0.101 and 192.168.102 are the IP addresses of the clients.

5. Start the NFS service by running the following command:

 systemctl restart nfs-server

 6. Add the NFS service override in the CentOS 7.0 firewall-cmd public zone service:

firewall-cmd --permanent --zone=public --add-service=nfs
firewall-cmd –reload

The NFS server is ready to work.

On the client side (on each Zephyr node):

1. Install the required NFS packages by running the following command:

yum install nfs-utils

2. Start the following services and add them to the Boot Menu:

systemctl enable rpcbind
systemctl enable nfs-server
systemctl enable nfs-lock
systemctl enable nfs-idmap
systemctl start rpcbind
systemctl start nfs-server
systemctl start nfs-lock
systemctl start nfs-idmap

3. Mount the NFS share on the client machine by running the command below:

mount -t nfs 192.168.0.100:/home/zephyrdata /<zephyrlocation>/zephyrdata

4. Change the ZEPHYR_DATA path to the mounted path for all the nodes in the

Zephyr folder\tomcat\webapps\flex\WEB-INF\classes\jdbc.propeties file.

For example:

ZEPHYR_DATA = <zephyrlocation>/zephyrdata

5. You are connected to the NFS share. Now you can crosscheck it by running the following command:

df -kh

< Prev Step Next Step >

See Also

Set Up Zephyr Data Center
Support and Troubleshooting

 

Related content

1. Connect to an External Database
1. Connect to an External Database
More like this
6. Bring Up the Whole System
6. Bring Up the Whole System
Read with this
4. Set Up a Shared Directory
4. Set Up a Shared Directory
More like this
Zephyr Production Installation for Windows
Zephyr Production Installation for Windows
Read with this
4. Set Up a Shared Directory
4. Set Up a Shared Directory
More like this
Zephyr Production Installation for Linux
Zephyr Production Installation for Linux
Read with this