Page Comparison

...

• Calling shutdown from the console

  Code Block
  language none title Shuts down with a prompt
  ddf@local>shutdown

  Code Block
  language none title Force Shutdown without prompt
  ddf@local>shutdown -f

• Running the stop script

  Code Block
  title *NIX
  DDF_INSTALL/bin/stop

  Code Block
  title Windows
  DDF_INSTALL/bin/stop.bat

  Warning
  title Shutdown
  Do not shutdown by closing the window (Windows, Unix) or using the kill -9 <pid> command (Unix). This prevents a clean shutdown and can cause significant problems when Insert excerpt ApplicationName ApplicationName nopanel trueApplicationName  is restarted. Always use the shutdown command or the Ctrl-D keystroke (Windows) from the command line console.

Anchor
SystemBoot SystemBoot

Automatic Start on System Boot

Because 

Insert excerpt
ApplicationName ApplicationName nopanel trueApplicationName

 is built on top of Apache Karaf, 

Insert excerpt
ApplicationName ApplicationName nopanel trueApplicationName

 can use the Karaf Wrapper to enable automatic startup and shutdown.

1. Create the Karaf wrapper

   Code Block
   title Within the DDF console
   ddf@local> features:install wrapper ddf@local> wrapper:install -s AUTO_START -n ddf -d ddf -D "DDF Service"

2. (Windows users skip to next step) (All *NIX) If 

   Insert excerpt
   ApplicationName ApplicationName nopanel trueApplicationName

    was installed to run as a non-root user (recommended) edit DDF_INSTALL/bin/ddf-service

   Change:

   Code Block
   title DDF_INSTALL/bin/ddf-service
   #RUN_AS_USER=

   to:

   Code Block
   title DDF_INSTALL/bin/ddf-service
   RUN_AS_USER=<ddf-user>

3. Set the memory in the wrapper config to match with DDF default memory setting

   a) Add the setting for PermGen space under the JVM Parameters section

   b) Update Heap space to 2048

   Code Block
   language bash title DDF_INSTALL/etc/ddf-wrapper.conf
   #Add the following: wrapper.java.additional.9=-XX:PermSize=128m wrapper.java.additional.10=-XX:MaxPermSize=512m wrapper.java.additional.11=-Dderby.system.home="..\data\derby" wrapper.java.additional.12=-Dderby.storage.fileSyncTransactionLog=true wrapper.java.additional.13=-Dcom.sun.management.jmxremote wrapper.java.additional.14=-Dfile.encoding=UTF8 wrapper.java.additional.15=-Dddf.home=%DDF_HOME%   #Update the following: wrapper.java.maxmemory=2048

4. Set DDF_HOME property

   Code Block
   title DDF_INSTALL/etc/ddf-wrapper.conf
   set.default.DDF_HOME="%KARAF_HOME%"

5. Install the wrapper startup/shutdown scripts

   Windows

   Run the following command in a console window. The command must be run with elevated permissions

   Code Block
   DDF_INSTALL/bin/ddf-service.bat install

   Startup and Shutdown settings can then be managed through the Services MMC Start -> Control Panel -> Administrative Tools -> Services

   Redhat

   Code Block
   root@localhost# ln -s DDF_INSTALL/bin/ddf-service /etc/init.d/ root@localhost# chkconfig ddf-service --add root@localhost# chkconfig ddf-service on

   Ubuntu

   Code Block
   root@localhost# ln -s DDF_INSTALL/bin/ddf-service /etc/init.d/ root@localhost# update-rc.d -f ddf-service defaults

   Solaris

   Code Block
   root@localhost# ln -s DDF_INSTALL/bin/ddf-service /etc/init.d/ root@localhost# ln -s /etc/init.d/ddf-service /etc/rc0.d/K20ddf-service root@localhost# ln -s /etc/init.d/ddf-service /etc/rc1.d/K20ddf-service root@localhost# ln -s /etc/init.d/ddf-service /etc/rc2.d/K20ddf-service root@localhost# ln -s /etc/init.d/ddf-service /etc/rc3.d/S20ddf-service

   Note
   While not necessary, information on how to convert the System V init scripts to the Solaris System Management Facility can be found at http://www.oracle.com/technetwork/articles/servers-storage-admin/scripts-to-smf-1641705.html

   Note
   title Solaris specific modification
   Due to a slight difference between the Linux and Solaris implementation of the "ps" command, the ddf-service script needs to be modified

...

Karaf Documentation

Because 

Insert excerpt
ApplicationName ApplicationName nopanel trueApplicationName

 is built on Apache Karaf, more information on operating 

Insert excerpt
ApplicationName ApplicationName nopanel trueApplicationName

 can be found in the Karaf documentation at http://karaf.apache.org/index/documentation.html .

Troubleshooting

Insert excerpt
Exception Starting DDF Exception Starting DDF nopanel trueException Starting DDF