Using the RPM Installation

14.2.2 Using the RPM Installation

You can run the downloaded RPM file to install the Oracle Graph Server.

Parent topic: Oracle Graph Server Installation

14.2.2.1 Prerequisites for Installing Oracle Graph Server

Before installing the graph server using the RPM file, ensure you perform the following prerequisite steps:

Ensure that you meet the system prerequisites as explained in System Requirements for Installing Oracle Graph Server.
Verify if you already have an installed version of the graph server by running the following command:
```
sudo rpm -q oracle-graph
[sudo] password for oracle: 
oracle-graph-24.2.0-0.x86_64
```
Graph server installation may throw an error if an installation already exists. In that case, see Upgrading Oracle Graph Server to upgrade to a newer version.

Parent topic: Using the RPM Installation

14.2.2.2 Installing Oracle Graph Server For Linux x86-64

The installation steps for installing Oracle Graph Server in standalone mode are as shown:

As a root user or using sudo, install the RPM file using the rpm command line utility:
```
sudo rpm -i oracle-graph-<version>.rpm
```
Where <version> reflects the version that you downloaded. (For example: oracle-graph-24.2.0.x86_64.rpm)

The .rpm file is the graph server.
The following post-installation steps are carried out at the time of the RPM file installation:
- Creation of a working directory in /opt/oracle/graph/pgx/tmp_data
- Creation of a log directory in /var/log/oracle/graph
- Automatic generation of self-signed TLS certificates in /etc/oracle/graph
  Note:
  
  You can also choose to configure and set up transport layer security (TLS) in graph server. See Setting Up Transport Layer Security for more details.
  
  For demonstration purposes, if you wish to disable transport layer security (TLS) in graph server, see Disabling Transport Layer Security (TLS) in Graph Server for more details.
As root or using sudo, add operating system users allowed to use the server installation to the operating system group oraclegraph. For example:
```
usermod -a -G oraclegraph <graphuser>
```
This adds the specified graph user to the group oraclegraph.
Note that <graphuser> must log out and log in again for this to take effect.
As <graphuser>, configure the server by modifying the files under /etc/oracle/graph by following the steps under Prepare the Graph Server for Database Authentication.
Ensure that authentication is enabled for database users that will connect to the graph server, as explained in User Authentication and Authorization.
As a root user or using sudo, start the graph server (PGX) by executing the following command:
```
sudo systemctl start pgx
```

You can verify if the graph server has started by executing the following command:

systemctl status pgx

If the graph server has successfully started, the response may appear as:

● pgx.service - Oracle Graph In-Memory Server
   Loaded: loaded (/etc/systemd/system/pgx.service; disabled; vendor preset: disabled)
   Active: active (running) since Wed 2021-01-27 10:06:06 EST; 33s ago
 Main PID: 32127 (bash)
   CGroup: /system.slice/pgx.service
           ├─32127 /bin/bash start-server
           └─32176 java -Dlogback.configurationFile=/etc/oracle/graph/logback-server.xml -Doracle.jdbc.fanEnabled=false -cp /opt/oracle/graph/pgx/bin/../../pgx/server/lib/jackson-databind...

The graph server is now ready to accept requests.

If the graph server has not started, then you must check the log files in /var/log/oracle/graph for errors. Additionally, you can also run the following command to view any systemd errors:
```
sudo journalctl -u pgx.service 
```

For instructions to deploy the graph server in Oracle WebLogic Server or Apache Tomcat, see:

You can also deploy the graph server behind a load balancer. See Deploying Oracle Graph Server Behind a Load Balancer for more information.

Parent topic: Using the RPM Installation

14.2.2.3 Installing Oracle Graph Server for Linux ARM

The installation steps for installing Oracle Graph Server in standalone mode for Linux ARM are as shown:

As a root user or using sudo, install the RPM file using the rpm command line utility:
```
sudo rpm -i oracle-graph-<version>.rpm --ignorearch
```
Where <version> reflects the version that you downloaded. (For example: oracle-graph-24.2.0.x86_64.rpm)

The .rpm file is the graph server.
The following post-installation steps are carried out at the time of the RPM file installation:
- Creation of a working directory in /opt/oracle/graph/pgx/tmp_data
- Creation of a log directory in /var/log/oracle/graph
- Automatic generation of self-signed TLS certificates in /etc/oracle/graph
  Note:
  
  You can also choose to configure and set up transport layer security (TLS) in graph server. See Setting Up Transport Layer Security for more details.
  
  For demonstration purposes, if you wish to disable transport layer security (TLS) in graph server, see Disabling Transport Layer Security (TLS) in Graph Server for more details.
As root or using sudo, add operating system users allowed to use the server installation to the operating system group oraclegraph. For example:
```
usermod -a -G oraclegraph <graphuser>
```
This adds the specified graph user to the group oraclegraph.
Note that <graphuser> must log out and log in again for this to take effect.
As <graphuser>, configure the server by modifying the files under /etc/oracle/graph by following the steps under Prepare the Graph Server for Database Authentication.
As <graphuser>, edit the /etc/oracle/graph/pgx.conf file to add and set the scheduler parameter to use the basic scheduler as shown:
```
"scheduler": "basic_scheduler"
```
Ensure that authentication is enabled for database users that will connect to the graph server, as explained in User Authentication and Authorization.
As a root user or using sudo, start the graph server (PGX) by executing the following command:
```
sudo systemctl start pgx
```

You can verify if the graph server has started by executing the following command:

systemctl status pgx

If the graph server has not started, then you must check the log files in


                    /var/log/oracle/graph

for errors. Additionally, you can also run the following command to view any systemd errors:

sudo journalctl -u pgx.service

Parent topic: Using the RPM Installation

14.2.2.4 Uninstalling Oracle Graph Server

To uninstall the graph server, make sure the graph server is shut down.

Run the following command as a root user or with sudo:
```
sudo rpm -e oracle-graph
```
- During uninstall /opt/oracle/graph/pgx/tmp_data/ and /etc/oracle/graph/server_keystore.jks are removed.

Parent topic: Using the RPM Installation

14.2.2.5 Upgrading Oracle Graph Server

To upgrade the graph server, ensure that you first shut down the existing graph server version. You can then run the following command with the newer RPM file as an argument.

Verify the version of your current graph server installation.
```
sudo rpm -q oracle-graph
```
Stop the graph server if it is already running.
```
sudo systemctl stop pgx
```
Upgrade the graph server by running the following command as a root user or with sudo.
```
sudo rpm -U oracle-graph-24.2.0.x86_64.rpm
```
Also, note the following:
- The upgrade process automatically preserves the previous PGX (pgx.conf), server (server.conf), and the logging (logback-server.xml, logback.xml) configurations files. However, if the new version contains changes, then the upgrade process will create the newest versions of these files with the .rpmnew extension. You can them compare the two files (to verify if there are any changes in the default parameter values or if a new parameter is added) and pick up the latest changes.
- Any manual configuration changes in the systemd configuration file for the PGX service (/etc/systemd/system/pgx.service) is lost. However, if you are using a drop-in file, then all customizations in the drop-in file are maintained.
- Existing log files in /var/log/oracle/graph are preserved.
- Existing server keystore file (/etc/oracle/graph/server_keystore.jks) is preserved.
  
  Caution:
  If you are upgrading the graph server from version 22.3.0 or earlier to 24.2.0, then note that the RPM file installation in Graph Server and Client Release 24.2.0 will generate a self-signed server keystore file by default. If you are using a self-signed server certificate, then note that the server configuration fields, server_cert and server_private_key are deprecated and will be desupported in a future release. See Setting Up Transport Layer Security for more information.
Verify if the tmp_data folder exists in the /opt/oracle/graph/pgx/ directory path.
If it does not exist, then create one and assign ownership and permission as shown:
```
mkdir -p /opt/oracle/graph/pgx/tmp_data
chown -R :oraclegraph /opt/oracle/graph/pgx/tmp_data
chmod 0770 /opt/oracle/graph/pgx/tmp_data
```

Restart the graph server.

sudo systemctl daemon-reload
sudo systemctl start pgx

Parent topic: Using the RPM Installation