Guide Configuration

jUDDI Configuration

Introduction

jUDDI will look for a juddiv3.properties file on the root of the classpath. In the juddiv3.war you can find it in juddiv3.war/WEB_INF/classes/juddiv3.properties.

Authentication Properties

Table 1. Authentication properties that can be referenced in the juddiv3.properties file

Property Name	Description	Required	Default Value or [Example Value]
juddi.authenticator	The jUDDI authenticator class to use. See Chapter <add ref> of the Userguide for the choices provided.	N	org.apache.juddi.v3.auth.JUDDIAuthenticator
juddi.authenticate.Inquiry	This flag determines whether authentication (the presence of a getAuthToken) is required on queries invoking the Inquiry API. By default, jUDDI sets this to false for ease of use.	N	false

Startup Properties

Table 2. Startup properties that can be referenced in the juddiv3.properties file

Property Name	Description	Required	Default Value or [Example Value]
juddi.server.baseurl	Token that can be accessed in accessPointURLs and resolved at runtime.	N	http://localhost:8080
juddi.root.publisher	The username for the jUDDI root publisher. This is usually just set to "root".	N	root
juddi.seed.always	Forces seeding of the jUDDI data. This will re-apply all files with the exception of the root data files. Note that this can lead to losing data that was added to the entities that are re-seeded, since data is not merged.	N	false
juddi.load.install.data	This property allows you to cancel loading of the jUDDI install data.	N	false
juddi.locale	The default local to use.	N	en_US
juddi.persistenceunit.name	The persistence name for the jUDDI database that is specified in the persistence.xml file.	N	juddiDatabase
juddi.configuration.reload.delay	The time in milliseconds in which juddiv3.properties is polled for changes.	N	5000

Email Properties

Table 3. Email properties that can be referenced in the juddiv3.properties file

Property Name	Description	Required	Default Value or [Example Value]
juddi.mail.smtp.from	The Operator’s Email address	Y	[[email protected]]
juddi.mail.smtp.host	The hostname of the SMTP server	Y	[localhost]
juddi.mail.smtp.port	The portname of the SMTP server	Y	[465]
juddi.mail.smtp.socketFactory.class	If set, specifies the name of a class that implements the javax.net.SocketFactory interface. This class will be used to create SMTP sockets.	N
juddi.mail.smtp.socketFactory.fallback	If set to true, failure to create a socket using the specified socket factory class will cause the socket to be created using the java.net.Socket class. Defaults to true.	N	true
juddi.mail.smtp.starttls.enable	f true, enables the use of the STARTTLS command (if supported by the server) to switch the connection to a TLS-protected connection before issuing any login commands. Note that an appropriate trust store must configured so that the client will trust the server’s certificate. Defaults to false.	N	false
juddi.mail.smtp.socketFactory.port	Specifies the port to connect to when using the specified socket factory. If not set, the default port will be used.	N	[465]
juddi.mail.smtp.auth	If true, attempt to authenticate the user using the AUTH command. Defaults to false.	N	[false]
juddi.mail.smtp.username	Username used to authenticate to the SMTP server	Y, if juddi.mail.smtp.auth is true	[[email protected]]
juddi.mail.smtp.password	Username used to authenticate to the SMTP server	Y, if juddi.mail.smtp.auth is true	[secret]

Query Properties

Table 4. Query properties that can be referenced in the juddiv3.properties file

Property Name	Description	Required	Default Value or [Example Value]
juddi.maxBusinessesPerPublisher	The maximum number of UDDI Businesses that can be registered per publisher. A value of '-1' indicates any number of businesses is allowed (These values can be overridden at the individual publisher level)	N	-1
juddi.maxServicesPerBusiness	The maximum number of UDDI BusinessServices allowed per Business. A value of '-1' indicates any number of artifacts is valid (These values can be # overridden at the individual publisher level).	N	-1
juddi.maxBindingsPerService	The maximum number of UDDI TemplateBindings allowed per BusinessService. A value of '-1' indicates any number of artifacts is valid (These values can be overridden at the individual publisher level).	N	-1
juddi.maxTModelsPerPublisher	The maximum number of TModels allowed per publisher. A value of '-1' indicates any number of artifacts is valid (These values can be overridden at the individual publisher level).	N	-1
juddi.maxInClause	The maximum number of "IN" clause parameters. Some RDMBS limit the number of parameters allowed in a SQL "IN" clause.	Y	[1000]
juddi.maxNameElementsAllowed	The maximum name size and maximum number of name elements allows in several of the FindXxxx and SaveXxxx UDDI functions	N	[5]
juddi.maxNameLength	The maximum name size of name elements	N	[255]
juddi.maxRows	The maximum number of rows returned in a find_* operation. Each call can set this independently, but this property defines a global maximum. This is related to the maxInClause setting (the same?).	N	1000

RMI Proxy Properties

These properties are used to bring up RMI server socket. The settings allow for registering this service to JNDI.

Table 5. RMI Proxy properties that can be referenced in the juddiv3.properties file and is only used by RMITransport.

Property Name	Description	Required	Default Value or [Example Value]
juddi.proxy.factory.initial	JNDI Contect Facory	N	[org.jnp.interfaces.NamingContextFactory]
juddi.proxy.provider.url	JNDI Provider Address	N	[jnp://localhost:1099]
juddi.proxy.factory.url.pkg	JNDI Naming Convention	N	[org.jboss.naming]

Key Generation Properties

Table 6. UDDI Key generation properties that can be referenced in the juddiv3.properties file.

Property Name	Description	Required	Default Value or [Example Value]
juddi.cryptor	jUDDI Cryptor implementation class that jUDDI will use to encrypt and decrypt password settings	N	org.apache.juddi.cryptor.DefaultCryptor
juddi.keygenerator	Key generator implementation that jUDDI will use to create UDDI keys if no key is passed in by the user.	N	org.apache.juddi.keygen.KeyGenerator

Subscription Properties

Table 7. Subscription properties that can be referenced in the juddiv3.properties file.

Property Name	Description	Required	Default Value or [Example Value]
juddi.subscription.expiration.days	Days before a subscription expires	N	[30]
juddi.subscription.chunkexpiration.minutes	Minutes before a "chunked" subscription call expires	N	[5]
juddi.notification.interval	Specifies the interval at which the notification timer triggers. This is the upper boundary set by the registry. Between the user defined endDate of a Subscription and this value, the registry will pick the earliest date.	N	3000000
juddi.notification.start.buffer	Specifies the amount of time to wait before the notification timer initially fires	N	20000

Custody Transfer _~~~~ .Tranfer properties that can be referenced in the juddiv3.properties file.

Property Name	Description	Required	Default Value or [Example Value]
juddi.transfer.expiration.days	Days before a transfer request expires.	N	[3]