The EAC typically starts automatically within the Endeca HTTP Service, though you can also start and stop it independently.
Option Description Windows In the Services menu, start or restart the Endeca HTTP Service. UNIX Run the $ENDECA_ROOT/tools/server/bin/startup.sh
script.This also starts any other components that run on the same port.
Option Description Windows In the Services menu, stop the Endeca HTTP Service. UNIX Run the $ENDECA_ROOT/tools/server/bin/shutdown.sh
script.This also stops any other components running on the same port.
On UNIX, you may wish to start the EAC with the
init
process. See the following topic for details.
In a UNIX production environment, the Endeca Application
Controller can start with
init
by entering the corresponding shell script in
inittab
.
In
a UNIX development environment, the Endeca HTTP Service can be started from the
command line. In a UNIX production environment, however, Oracle recommends that
it be started with the
init
process. If the service crashes or terminates,
init
automatically restarts it.
The UNIX version of Platform Services contains a variant of
startup.sh
, named
$ENDECA_ROOT/tools/server/bin/endeca_run.sh
, that
calls
run
instead of
start
and redirects
stdout
and
stderr
to
$ENDECA_CONF/logs/catalina.out
.
You can write a script to call
endeca_run.sh
as a non-root user. This lets you set
a
$USER
environment variable that is inherited by EAC
scripts.
Example 7. Example
This sample script below,
start_endeca_http_service.sh
, sets
$ENDECA_USER
to the “endeca” user, sets
$INSTALLER_SH
to the path of the environment variables
script and sources it, and then changes to the “endeca” user and starts the
EAC:
#!/bin/sh ENDECA_USER=endeca INSTALLER_SH=/usr/local/endeca/PlatformServices/workspace/setup/installer_sh.ini # We want to use installer_sh.ini variables in this script, # so we source it here. source $INSTALLER_SH # change to user endeca su $ENDECA_USER -c "/bin/sh -c \"source $INSTALLER_SH; \ cd $ENDECA_CONF/work; exec env USER=$ENDECA_USER \ $ENDECA_ROOT/tools/server/bin/endeca_run.sh\""
Note
On Solaris platforms, replace "source" with "." since source is not a command in the Bourne shell.
You can add this script to
inittab
with an entry similar to the following:
ec:2345:respawn:/usr/local/endeca/PlatformServices/workspace/setup/start_endeca_http_service.sh