This page explains the various configuration options of the Rifidi Edge Server

RifidiEdgeServer.ini

The RifidiEdgeServer.ini is a property file that contains options for various options when the edge server starts up.

Default .ini file

By default it looks like this:

-os
${target.os}
-ws
${target.ws}
-arch
${target.arch}
-nl
${target.nl}
-console
-vmargs
-Declipse.ignoreApp=true
-Dosgi.noShutdown=true
-Dorg.rifidi.edge.configuration=test.ini
-Dosgi.clean=true
-Dorg.osgi.framework.bootdelegation=javax.xml.ws
-Dcom.sun.management.jmxremote.port=2021
-Dcom.sun.management.jmxremote.authenticate=false
-Dcom.sun.management.jmxremote.ssl=false
-Djava.rmi.server.hostname=127.0.0.1
-Dorg.rifidi.edge.core.rmi.port=1101
-Dorg.rifidi.edge.ale.port=8081
-Dorg.rifidi.edge.ale.host=127.0.0.1
-Dorg.rifidi.edge.jms.hostname=127.0.0.1
-Dorg.rifidi.edge.jms.port=1100
-Dosgi.framework.extensions=org.eclipse.equinox.weaving.hook
-Dorg.aspectj.osgi.verbose=true

Console

-console

This starts up the OSGi console so that you can interact with the edge server from the command line. For a list of commands that are available see Edge Server Commands. If you would like the console to be available over the network, supply a port after the -console (e.g. -console 2020). Now it is possible to telnet into the server at the given port. It is recommended that you use ssh tunneling for security reasons (i.e. first ssh to the machine that is running the edge server, then telnet to the console). One thing to note is that after you telnet to the OSGi console, you cannot use the exit command as you normally would to close the telnet session. This is because exit will be caught by the OSGi console and will perform a System.exit(). Instead, to exit the telnet session while keeping the server running, just close the telnet window.

VMArgs

VMArgs must follow the -vmargs flag in the .ini file. They must start with -D. Default values can be found in the bundle.properties file in the spring directory for the appropriate option. Important VM args:

-Dorg.rifidi.edge.configuration

This is the path to the persistence file. See #rifidi.ini.

-Dcom.sun.management.jmxremote.port

The port to open up JMX on. This is important if you are using a program like VisualVM to profile the server

-Djava.rmi.server.hostname

The hostname to open up the RMI registry at. Default is 127.0.0.1

-Dorg.rifidi.edge.core.rmi.port

The port of the RMI registry Default is 1101

-Dorg.rifidi.edge.ale.host

The hostname to publish the ALE webservices at. Default is 127.0.0.1

-Dorg.rifidi.edge.ale.port

The port to publish the ALE webservices at. Default is 8081

-Dorg.rifidi.edge.ale.read

The service name of the ALE reading service. Default is ALEService

-Dorg.rifidi.edge.ale.logicalreader

The service name of the ALE logical reader service. Default is ALELRService

-Dorg.rifidi.edge.jms.hostname

The hostname to use for JMS. Default is 127.0.0.1

-Dorg.rifidi.edge.jms.port

The port to use for JMS. Default is 1100

-Dorg.rifidi.edge.jms.topic.tags

The topic name that JMS will publish all tag read events at. Default is org.rifidi.edge.external.tags

-Dorg.rifidi.edge.jms.topic.notifications

The topic name that JMS will publish all notification events (such as when a reader is added or a session is started). Default is org.rifidi.edge.external.notifications

rifidi.ini