Description of the setup items:
Version: Displays the installed version of Opinio.
Default language: The default language for a new user. The user can then set the language by clicking on the "user" menu button.
Character encoding: The encoding used to display pages in the system. See internationalization.
Main email server: This is the main email server to use when sending email. Only SMTP servers are supported. Other server types will be added in later versions. Enter user name and password if your main email server requires authentication for sending email.
Secondary email server (optional): The SMTP email server to use if the main server is down (cannot be contacted). This ensures that the mail will be sent. Enter user name and password if your secondary email server requires authentication for sending email.
Cache size in MB: This is the survey cache. Each survey takes on average 64K memory. This is a very uncertain number. If your surveys are very large, it may take more than 100K, or less than 50K if they are small. But we have set the “average” size to 64K. This means that 16 surveys will fit in a 1MB cache. If you have many surveys running, we recommend to set the survey cache even higher (5-10MB).
From email name and address This section allows setting the email from name and address. This is the global settings, and will be used if the user's email address is not set. For survey specific emails, it will be used if the from name/address is not set for a particular survey.
If a user doesn't have access to a survey/folder: Controls the visibility of surveys and folders. Select show survey/folder name as text if you want users to see all surveys and sub-folders in a folder. Select hide survey/folder name if you want users to see only surveys and folders they have access to.
Error visibility in survey module: Controls the visibility of errors. If you want the survey respondents to see if an error occurs while responding to the surveys, select show error messages (screen and log file). Otherwise, select don't show error messages. If you are not monitoring the site regularly, you might want the respondents to see the errors, so they can report to you about it. If errors are not shown, Opinio will let the respondent continue to respond, despite the fact that it cannot store the responses in the database. It will then keep trying to store the response at 1 hour intervals (see above).
Send errors to email: If errors occur while establishing connection to the database, the error is reported to the email recipient specified here. Any other error occurring while saving a survey response to the database is also reported to this email address.
Maximum store attempts: If errors occur while storing a survey response, Opinio will keep trying to store it with 1 hour intervals. This setting specifies how many times Opinio will try, until it will give up and discard the respondent. This feature allows the database to be down for a short period, and still keep the responses, as long as the web server (servlet container) is up during this period. When the database is back up, the responses will be stored. Note that the responses will be kept in memory during this period, and if the site is busy, it may require a large amount of memory to keep all the responses. They will be removed from memory once the database is back up and the responses are stored, or Opinio has given up after the specified number of retries. It is always recommended to check the log file periodically for errors.
System base URL (optional): Opinio will by default create the URLs for entering the survey, reports URLs etc. - all automatically. But sometimes you need to set the base URL manually, for example if you are running in clustering mode (in that case, each cluster member will create a different URL). In clustering mode, you must set the base URL to the load balancer. So, if your load balancer is http://www.myaddress.com/opinio, and you have 2 cluster members at http://10.0.2.10/opinio and http://10.0.2.11/opinio, the base address should be set to http://www.myaddress.com/opinio
Preferred IP address (optional): If the server has more than one Network Interface Cards (NIC), then you should assign which card you prefer to use for your Opinio installation. Java returns a list of NICs installed on your server. Opinio will by default use the first NIC in this list, and if this ip address isn’t your preferred ip address for the Opinio installation you will need to set the preferred ip address. Also, if a new NIC is added, the ip address for which you have registered your Opinio installation, will not necessary be the first NIC found by Java, and the license will no longer be valid if you don’t set the preferred ip address.
Database information:
Java information: