Skip to main content
3DEXPERIENCETechnical Tips

3DEXPERIENCE Alert: 3DNotification Troubleshooting

By May 26, 2022July 18th, 2023No Comments

Attention 3DEXPERIENCE Users on Linux

There is a situation that may be specific to Linux in which the 3DNotification service does not start properly. It seems if the Oracle environment variables are not declared for the x3ds user (or whatever user is used to start the 3DNotification service) the service does not start properly.

Symptoms of the problem:

Try to browse to the health check page and receive 503 Service Unavailable error.

Check the status of the node and receive a message that the process ID (pid) exists but the node is dead. That can’t be good.

The root cause of the problem is that in this scenario, 3DNotification deployed on Red Hat Linux using Oracle database, is that the 3DNotification service cannot reach the ORACLE_HOME location. Furthermore, in this scenario, the PATH setting does not help the situation. That is, even though the ORACLE_HOME location is declared in the PATH variable, 3DNotification does not start normally.


To solve the problem declare the ORACLE_HOME variable with the appropriate path, for example from a shell command issue the following:

export ORACLE_HOME=/opt/oracle/product/19c/dbhome_1

Then start the 3DNotification node and check its status:

Then browse to the health check page:


The following variables should be declared in the .bashrc file of the user used to start the 3DNotification service. In this case the x3ds user. The file is located in the /home/x3ds folder. An example of this declaration is as follows:

# Oracle related variables
ORACLE_BASE=/opt/oracle ORACLE_HOME=$ORACLE_BASE/product/19c/dbhome_1

Close Menu