32 Database

This chapter explains the database settings you can configure in Agile PLM.

32.1 Configuration of Database Settings

From the Database node you can view and configure Agile PLM's system-wide database settings.

To modify a Database setting:

Under Server Settings, double-click Database. The Database window appears.
In any editable field, enter a new value or select from the drop-down list.
When you have finished, click Save.
Restart the Agile Application Server to activate the change.

Caution:

If you change the Notification Enabled setting, it takes effect immediately. Changing any other Database setting requires that you restart the Agile Application Server > for the new setting to take effect. All active users' connections will be terminated when the Agile Application Server is restarted.

32.2 Database Properties

The following tables lists Database properties.

Table 32-1 Property Settings for Email SMTP Connection (RUP10+)

Property Name	Valid Value	Comment
mail.connection.security	* SSL/TLS * STARTTLS	character case is not sensitive
mail.smtp.port	* SSL/TLS with default port 465 * STARTTLS with default port 587 * No connection security with default port 25
mail.smtp.auth	true or false	character case is not sensitive
mail.smtp.user	mail user account
mail.smtp.pwd	encrypted password	Use command line tool <AgileDomain>/bin/encryptPwdUtil.cmd to encrypt

Table 32-2 Database Properties

Property	Description	Default
Discovery Privilege	Enabling Discovery Privilege allows all Discover privilege masks for this Agile PLM system to function. If Disabled, all Discover privilege masks and Discovery-related SmartRules are disabled. If you are not using Discovery functions, you can improve your system's performance by setting this property to Disabled.	Enabled
GUID	The unique ID for your company's Agile PLM database. This property is not editable.	(GUID)
Name	The name of the main Agile PLM database; you can rename the node, using up to 29 letters.	Agile Database
Notification Enabled	Whether email notifications are sent to users. If this property is disabled (= No), all other email notification settings are ignored. This setting is especially important with regard to Event Management: all "event-based" notifications will not be active if Notification Enabled is set to No.	No
Schema	Database "username," or the name of the schema, that is used to log in to the database. This property is not editable.	(Schema name)
Server	The name of the current Agile PLM database server. This property is not editable.	(Server name)
DB Version	The version of Agile PLM database being used. This property is not editable.	(DB version)
Mail From Domain	Domain name for email notification, for example, mydomain.com.	(None)
Mail From User	The From email address that is used in Agile PLM email notifications. The value must be a valid email address, for example, `AgileAdmin@mydomain.com`.	(None)
Mail Server External	The name of the computer running your external email server.	(None)
Mail Server Internal	The name of the computer running your internal email server.	(None)
Customer ID	The unique ID for your company. This property is not editable.	(ID number)
Year Cycle - Start Month	First month of your company's fiscal year.	(Set during installation)
Year Cycle - Start Day	First day of your company's fiscal year.	(Set during installation)

32.3 Configuring SMTP to use TLS or STARTTLS and Password Authentication in Agile

This section describes how to configure SMTP connections from Agile PLM to use TLS or STARTTLS connection security as well as how to configure password authentication for your SMTP connection.

32.3.1 Connection Security

To enable SMTP connection security, a new property setting mail.connection.security is added in config file agile.properties, two options are available:

SSL/TLS with default port 465
STARTTLS with default port 587

User can override the default port by setting property mail.smtp.port in agile.properties.

32.3.2 SMTP Username and Password Authentication

Specify the following in agile.properties:

mail.smtp.auth=true
mail.smtp.user=<username>
mail.smtp.pwd=<encrypted_password>

The value of mail.smtp.pwd must be encrypted and generated by AGILE_HOME/agileDomain/bin/encryptPwdUtil.cmd/sh

32.3.3 Java Client Setting

Example of Notification configuration in Agile PLM

Table 32-3 Java Client Notification

Property Name	Valid Value	Comment
mail.connection.security	SSL/TLS STARTTLS	Values are not case sensitive
mail.smtp.port	SMTP port number (only needs to be specified when overriding the default)	Used to override the default SMTP port. Default port is 25 with no connection security configured Default port is 465 for SSL/TLS Default port is 587 for STARTTLS
mail.smtp.auth	true false	Values are not case sensitive
mail.smtp.user	Mail account username
mail.smtp.pwd	Mail account encrypted password	To generate encrypted password, use command line toolAGILE_HOME/agileDomain/bin/encryptPwdUtil.cmd/sh