Upgrade Considerations

You need to configure soft links in the /tomcat/webapps/phixflow directory.

Creating Soft Links 

In the following commands:

• path/folder_name is the full path to the directory to which you want to link

• soft_link is 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_link

If a file path includes spaces, enclose it in double-quotes. 

Example ln command

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

Example mklink command

mklink /D c:\app\tomcat\webapps\phixflow\datalink c:\path\phixflow\data

Tomcat configuration

If you have installed Tomcat according to the standard recommendations (Install Tomcat), you will already have the configuration you need.

But to check, or in case of problems:

For Linux installations only, configure the context.xml file as follows:

1. Open /opt/tomcat/conf/context.xml

2. Find the line: <Resources cachingAllowed="true" cacheMaxSize="1000000" />

3. Replace it with: <Resources allowLinking="true" cachingAllowed="true" cacheMaxSize="1000000" />

For Windows installations, you must not include this option. It is not needed, and adding it can cause security issues. 

Example Soft Links

In the following example, Tomcat has a soft link called images-link to a files/images directory in PhixFlow.

You can also create soft links within the PhixFlow server, for example to simplify paths.