AnzoGraph 2.1 Installation and Upgrade Notes

To view installation and upgrade instructions for AnzoGraph, see Deploying a Static AnzoGraph Cluster in the Anzo Deployment and User Guide.

If you use Anzo Unstructured in Anzo Version 5.x and you are upgrading to AnzoGraph Version 2.1.x from Version 2.0.1 or earlier, there are additional requirements for setting up AnzoGraph to work with Elasticsearch. After installing AnzoGraph Version 2.1.x, follow the instructions in Configuring AnzoGraph for Use with Elasticsearch below to configure AnzoGraph and the host servers.

If you use the Anzo Data Toolkit Service to incorporate data from remote endpoints into graphmarts and you are upgrading to AnzoGraph Version 2.1.x from Version 2.0.1 or earlier, there are also additional requirements for setting up AnzoGraph for use with the service. After installing AnzoGraph Version 2.1.8, follow the instructions in Configuring AnzoGraph for Use with the Data Toolkit Service below to configure AnzoGraph and the host servers.

Configuring AnzoGraph for Use with Elasticsearch

Follow the instructions below to configure AnzoGraph for use with Elasticsearch.

Make sure that the azgmgrd and anzograph services are stopped before proceeding.

AnzoGraph requires Java Development Kit version 11. Follow these steps to install OpenJDK 11 and set $JAVA_HOME to the Java Runtime Environment.
If you upgraded from AnzoGraph Version 2.0.1 or 2.1.x and installed OpenJDK 11 previously, you do not need to complete this step.
Perform these steps on all servers in the cluster:
1. Run the following command to install OpenJDK 11:
```
sudo yum install java-11-openjdk
```
2. Modify the AnzoGraph system management service, azgmgrd.service, to set the $JAVA_HOME variable to the java runtime environment for the OpenJDK that you installed. To set the variable, add the following line to /usr/lib/systemd/system/azgmgrd.service:
```
ENVIRONMENT=JAVA_HOME=/usr/lib/jvm/jre-11
```
Copy the data toolkit plugin, datatoolkit-1.0.0.jar, provided by Cambridge Semantics to the <install_path>/lib/udx directory on the AnzoGraph leader server. This jar file contains the client interface that AnzoGraph uses to communicate with Elasticsearch. The AnzoGraph leader broadcasts the jar to the compute nodes when the database is started.
If you upgraded from Version 2.0.1, remove elasticsearch-1.0.0.jar from the directory if it exists. Version 2.1.x does not use that .jar file.
Make sure that the AnzoGraph leader server can access Elasticsearch via the Elasticsearch server's IP address. To test the connection, Cambridge Semantics recommends running the following telnet command from the AnzoGraph leader server:
```
telnet <Elasticsearch_server_IP> 9200
```
If you upgraded from AnzoGraph Version 2.0.1 and chose not to update the configuration settings, open the <install_path>/config/settings.conf file and look for enable_context_query_string=true. If the file contains that setting and it is enabled, remove the line from the file or change the value to false. The setting is not valid in Version 2.1.x.
If you upgraded from Version 2.0.1, there may be JVM support libraries on the AnzoGraph file system that are incompatible with Version 2.1.x. Before starting AnzoGraph, follow the instructions below to remove the incompatible files.
If you upgraded from AnzoGraph Version 2.1.x, you do not need to complete this step.
Perform these steps on all servers in the cluster:
1. Remove udx-1.5.0-SNAPSHOT.jar and udx-1.5.0-SNAPSHOT.javadoc.jar from the /<install_path>/lib/udx directory. For example:
```
rm /opt/anzograph/lib/udx/udx-1.5.0-SNAPSHOT.jar
```
```
rm /opt/anzograph/lib/udx/udx-1.5.0-SNAPSHOT.javadoc.jar
```
2. Remove jvm-1.0.0-SNAPSHOT.jar and jvm-1.0.0-SNAPSHOT.javadoc.jar from the /<install_path>/lib/jar directory. For example:
```
rm /opt/anzograph/lib/jar/jvm-1.0.0-SNAPSHOT.jar
```
```
rm /opt/anzograph/lib/jar/jvm-1.0.0-SNAPSHOT.javadoc.jar
```
Start the azgmgrd service on each AnzoGraph server:
```
sudo systemctl start azgmgrd
```
On the leader node, start the anzograph service:
```
sudo systemctl start anzograph
```

Configuring AnzoGraph for Use with the Data Toolkit Service

If you use the Anzo Data Toolkit Service to retrieve data from remote endpoints and incorporate it into graphmarts, follow the instructions below to configure AnzoGraph for use with the service. If you use Anzo Unstructured and have configured AnzoGraph for use with Elasticsearch, you do not need to complete this task.

Make sure that the azgmgrd and anzograph services are stopped before proceeding.

AnzoGraph requires Java Development Kit version 11. Follow these steps to install OpenJDK 11 and set $JAVA_HOME to the Java Runtime Environment.
Perform these steps on all servers in the cluster:
1. Run the following command to install OpenJDK 11:
```
sudo yum install java-11-openjdk
```
2. Modify the AnzoGraph system management service, azgmgrd.service, to set the $JAVA_HOME variable to the java runtime environment for the OpenJDK that you installed. To set the variable, add the following line to /usr/lib/systemd/system/azgmgrd.service:
```
ENVIRONMENT=JAVA_HOME=/usr/lib/jvm/jre-11
```
Copy the data toolkit plugin, datatoolkit-1.0.0.jar, provided by Cambridge Semantics to the <install_path>/lib/udx directory on the AnzoGraph leader server. The AnzoGraph leader broadcasts the jar to the compute nodes when the database is started.
Start the azgmgrd service on each AnzoGraph server:
```
sudo systemctl start azgmgrd
```
On the leader node, start the anzograph service:
```
sudo systemctl start anzograph
```