...
...
Administrator setting up softlinks
Understanding the Soft Link Between Tomcat and PhixFlow
When you want to reference a file saved on the PhixFlow server, you need to use a path that the PhixFlow Webapp can understand. The PhixFlow webapp runs within Tomcat, so only knows about files below /opt/tomcat/webapps/phixflow
...
...
...
...
/opt/phixflow/data/phixflow/datalink/
Where has the above come from? This will only exist if someone has already configured it?
- You may not want to save files under the datalink directory on the PhixFlow server. For example, you could have a directory for each project, and the files belong to a specific project. In this case, you can add a second soft link.
...
/opt/phixflow/data/phixflow/datalink/MyProject/
...
Upgrade Considerations
You need to configure soft links in the /tomcat/webapps/phixflow directory.
| Warning |
|---|
When you upgrade PhixFlow to the latest version, the process replaces everything in This is also why you must never add files directly to /tomcat/webapps/phixflow or it's subdirectories. |
Creating Soft Links
| Anchor | ||||
|---|---|---|---|---|
|
In the following commands:
path/folder_nameis the full path to the directory to which you want to linksoft_linkis the path to the directory where you want to access the soft link.
On Linux create soft links using the ln command
ln -s path/folder_name soft_linkIf a file path includes spaces, enclose it in double-quotes.
| Code Block | ||
|---|---|---|
| ||
sudo ln -s /opt/phixflow/data/ /opt/tomcat/webapps/phixflow/datalink |
On Windows create soft links using the mklink command
By default, the mklink command creates links to specific files. To link to a directory, use the /D option.
mklink /D soft_link path/folder_name
| Code Block | ||
|---|---|---|
| ||
mklink /D c:\app\tomcat\webapps\phixflow\datalink c:\path\phixflow\data |
Securing Soft Links
To ensure soft links from Tomcat to PhixFlow directories are secure, configure the context.xml file as follows:
- Edit
/opt/tomcat/conf/context.xml - Find the line:
<Resources cachingAllowed="true" cacheMaxSize="1000000" /> - Replace it with:
<Resources allowLinking="true" cachingAllowed="true" cacheMaxSize="1000000" />
...
Example Soft Links
In the following
...
path/folder_nameis the full path to the directory to which you want to linksoft_link_nameis the directory name you want to use as a soft link in the current directory.
On Linux use the ln command
ln -s path/folder_name soft_link_name - Can we have an example: sudo ln -s /opt/phixflow/data/phixflow/datalink/ /opt/tomcat/webapps/phixflow/If a file path includes spaces, enclose it in double-quotes
On Windows use the mklink command
mklink /D soft_link_name path/folder_name - Can we have an example
To soft link to a specific file, omit /D.
For more information about symlinks, see this article on Creating Symbolic Links.
The Path or URL to Use
Within PhixFlow, to refer to a file on the server, start the path with the datalink directory.
Examples:
- file path:
datalink/Project1/Images/file1.png - URL:
url("https:datalink/MyProject/MyImage.png")
...
In your PhixFlow application, to display an image stored on the PhixFlow server, use the URL for it's location, for example: url("https:datalink/MyProject/MyImage.png").
For example, you can configure the following CSS Properties to use an image stored on the PhixFlow server as a background image.
...
example, Tomcat has a soft link called images-link to a files/images directory in PhixFlow.
| OS | Soft link in a Tomcat directory | points to → | PhixFlow server directory containing files |
|---|---|---|---|
| Linux | <path>/tomcat/webapps/phixflow/images-link |
| |
| Windows | <path>\tomcat\webapps\phixflow\ | <path>/phixflow/ |
You can also create soft links within the PhixFlow server, for example to simplify paths.
| OS | Soft link in Tomcat directory | points to → | Soft link in PhixFlow server | points to → | Directory containing files |
|---|---|---|---|---|---|
| Linux | <path>/tomcat/webapps/phixflow/proj1-images |
| /opt/phixflow/allprojects/apps/project1/ | ||
| Windows | <path>\tomcat\webapps\phixflow\proj1-images | <path>/phixflow/images/project1/ | <path>/phixflow/ |