...
Make sure the computer meets the system requirements.
Ensure you have the license file (license.lic) and any plugin license files that were provided.
Download the installation file of Zephyr Enterprise for Linux.
Download and install JDK. Use one of the following:
OpenJDK 8 (recommended) - see the installation instructions, section “JDK 8”
Oracle JDK 8 - download and install according to the Oracle documentation.
Download MySQL Connector.
Upload Zephyr License: The Zephyr installer requires access to the license file provided. It will need to be first uploaded to the file system of the server.
Upload the MySQL Connector: The Zephyr installer requires access to the MySQL connector jar file downloaded. It will need to be first uploaded to the file system of the server.
Set ulimitin Linux:increase ulimit on the server to 65535.
...
1. Create a Linux EC2 instance, Name-BASE-01, and configure basic parameters:
Assign an elastic IP.
Login Log in to the instance using your .pem key.
Create the user zephyr and the zephyr password:
...
Expand | ||
---|---|---|
| ||
1. Ensure the installation file has proper permissions to be executed:
2. Launch the installation file with the -c command line option as shown below, and ensure you launch it as sudo or root:
3. You will be prompted to continue with the installation. Choose OK to continue:
4. You may be prompted to choose between a new installation and upgrading. Choose Install.
5. You will be prompted to confirm your system meets the Zephyr Server requirements. Please make sure your system meets the requirements before proceeding:
6. Agree to the Zephyr EULA:
7. Press the Enter key until you see the following, then press 1 to agree to the terms:
8. Specify the destination location to place the Zephyr home directory:
9. Choose the installation type Data Center deployment:
10. Locate your license file:
11. Choose a port to run Zephyr on. By default, Zephyr runs on port 80:
12. Choose a Tomcat Server Shutdown Port. We recommend that you leave the default port for it:
13. You will be prompted to choose a database system. Choose MySQL:
14. Specify the username you use to connect to the database:
15. Specify the password you use to connect to the database:
16. Specify the database connection string:
17. Specify the connection string for Elasticsearch you configured earlier. By default, Elasticsearch will bind to the IP configured in the elasticsearch.yml file edited earlier in the installation instructions. For example: 192.168.56.101:9300:
18. Zephyr will now install the required files:
Choose No for now. |
...
Info |
---|
Write down the IP address of each node – you will need them at the next step 7. |
Note |
---|
After installing Zephyr on Java virtual machines, you need to allocate memory for the Tomcat server and set the amount of native memory that can be used for class metadata. To do that, open the file |
5. After you install Zephyr Enterprise on all the nodes, you need to modify the following files file on each node:
...
title | Zephyr\tomcat\conf\server.xml |
---|
...
<Zephyr Directory>/tomcat/webapps/flex/WEB-INF/classes/hazelcast.properties
In this file, find the following
...
Code Block | ||
---|---|---|
| ||
<Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"/> |
and replace it with the following:
Code Block | ||
---|---|---|
| ||
<Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"channelSendOptions="8">
<Manager className="org.apache.catalina.ha.session.DeltaManager"
expireSessionsOnShutdown="false"
notifyListenersOnReplication="true"/>
<Channel className="org.apache.catalina.tribes.group.GroupChannel">
<Membership className="org.apache.catalina.tribes.membership.McastService"
address="228.0.0.22"
port="45564"
frequency="500"
dropTime="3000"/>
<Receiver className="org.apache.catalina.tribes.transport.nio.NioReceiver"
address="auto"
port="4000"
autoBind="100"
selectorTimeout="5000"
maxThreads="6"/>
<Sender className="org.apache.catalina.tribes.transport.ReplicationTransmitter">
<Transport className="org.apache.catalina.tribes.transport.nio.PooledParallelSender"/>
</Sender>
<Interceptor className="org.apache.catalina.tribes.group.interceptors.TcpFailureDetector"/>
<Interceptor className="org.apache.catalina.tribes.group.interceptors.MessageDispatch15Interceptor"/>
</Channel>
<Valve className="org.apache.catalina.ha.tcp.ReplicationValve"
filter=""/>
<Valve className="org.apache.catalina.ha.session.JvmRouteBinderValve"/>
<Deployer className="org.apache.catalina.ha.deploy.FarmWarDeployer"
tempDir="/tmp/war-temp/"
deployDir="/tmp/war-deploy/"
watchDir="/tmp/war-listen/"
watchEnabled="false"/>
<ClusterListener className="org.apache.catalina.ha.session.ClusterSessionListener"/>
</Cluster> |
Expand | ||
---|---|---|
| ||
– and add the IPs of all the nodes instead of 127.0.0.1. For example:
– and replace it with an IP address that has an asterisk instead of the last component. For example:
|
...
title | zephyr/tomcat/webapps/flex/WEB-INF/classes/hazelcast-hibernate.xml |
---|
In this file, find the line –
<member>127.0.0.1:5702</member>
– and add the IP addresses of all the nodes instead of 127.0.0.1. For example:
<member>172.17.18.141:5702</member>
<member>172.17.18.157:5702</member>
<member>172.17.18.223:5702</member>
<member>172.17.18.201:5702</member>
Find the line –
<interface>127.0.0.1</interface>
...
lines and change the values as shown below:
zephyr.hz.cluster.enabled=false - set it totrue
.
zephyr.hz.cluster.name=zephyr-hazelcast-cluster - specify a unique name for each cluster, for example, zephyr-hazelcast-cluster_smartbear
.
zephyr.hz.interfaces.enabled=false - set to true
.
zephyr.hz.interface=127.0.0.1 - This is the IP of the IP interface. Replace it with an IP address that has
...
asterisks instead of the last
...
two components. For example:
...
<interface>172.17.18.*</interface>
Expand | ||
---|---|---|
| ||
Find the line –
– and replace websocket with sse:
|
Expand | ||
---|---|---|
| ||
In the file, before the web-app tag, add the tag <distributable />: |
...
Code Block | ||
---|---|---|
| ||
cp cluster.properties.tmpl ../classes/ |
...
Code Block | ||
---|---|---|
| ||
mv cluster.properties.tmpl cluster.properties |
7. Edit the cluster.properties file on all the nodes and update the following information:
Code Block |
---|
cluster.key=node1 (this should be a unique name of the node)
cluster.node.1.key=node1
cluster.node.1.url=172.17.18.141 (the IP address of node 1)
cluster.node.count=4
cluster.node.2.key=node2
cluster.node.2.url= 172.17.18.157 (the IP address of node 2)
cluster.node.3.key=node3
cluster.node.3.url=172.17.18.223 (the IP address of node 3)
cluster.node.4.key=node4
cluster.node.4.url=172.17.18.201 (the IP address of node 4) |
Note |
---|
The |
8. zephyr.hz.interface= 192.168.*.*
zephyr.hz.tcp-ip.enabled=false - set it to true
.
zephyr.hz.members=127.0.0.1 - specify the IP addresses and port number of each node separated by a comma. For example: zephyr.hz.members=192.168.0.1:5701,192.168.0.2:5701
6. Start Zephyr on the first node by using the following commands:
...
Code Block |
---|
***************** Zephyr Started ***************** |
After Zephyr is launched, the HAZELCAST_USERNAME and HAZELCAST_PASSWORD values will be generated in the zephyr/tomcat/webapps/flex/WEB-INF/classes/cluster.properties file.
9. Copy the HAZELCAST_USERNAME and HAZELCAST_PASSWORD values and paste them to the zephyr/tomcat/webapps/flex/WEB-INF/classes/cluster.properties file on the other Zephyr nodes.
10. Stop the first node7. Start the other nodes.
8. Stop all the nodes.
Now you can set up a shared folder. To learn how to do that, click Next Step below.
See Also