General deployment instructions
Deploying in Tomcat or another container is normally as simple as copying the .war file in a folder (check here for Websphere). For Tomcat it's sufficient to drop the file in $TOMCAT_HOME/webapps for example.
When started for the first time, the application will try to create a repository in the repository folder. By default the folder is ./mwpRepositoy (see below to configure it). In Tomcat the repository will be created in $TOMCAT_HOME/bin, it can be different for other containers. You may need to give read/write permissions to the container's user on that folder.
The following are optional startup parameters that can be specified in the container's startup as JAVA_OPTS
| name | default value | example | explanation |
|---|---|---|---|
| com.kv.repository | ./mwpRepository | -Dcom.kv.repository=/var/kv/repository | path of the player's repository; the application needs read/write permissions on this folder. |
| com.kv.noCluster | -Dcom.kv.noCluster | when defined the cluster functions are disabled | |
| com.kv.noNodeForwarding | -Dcom.kv.noNodeForwarding | when defined the cluster will not use node forwarding that may be incompatible with some containers | |
| com.kv.tenants | default | -Dcom.kv.tenants=tenant1,tenant2 | comma separated list of tenants' names (also colons and semicolons can be used as separators) |
| com.kv.clusterName | randomly generated | -Dcom.kv.clusterName=mycluster | name of the cluster |
In case there are errors, the server won't be able to startup and you will see some exceptions. If this happens, make sure that the all path settings are correct and refer to existing files on the system. This includes paths in the container's configuration (the JAVA options). Make sure that the container has the permissions to create/read/write the repository folders.
If you get a org.jasypt.exceptions.EncryptionOperationNotPossibleException or another org.jasypt exception during deployment time, install Java Cryptography Extension (JCE) on the server and restart it. Follow the guidelines from section Install Java Cryptography Extension