Starting in version 2.0.5, SE Suite contains a requirements checker. This resource is a functionality, executed during the SE Suite initialization, which aims to make sure the server meets all the requirements for system use. If a requirement for system use is not met, the checker will display a message to indicate the configuration that needs to be solved.
See below some configurations that may be required to start the SE Suite service:
By default, the time zone used in Java is the same of that configured in the operating system. To start the application with a time zone different from the one used by the operating system, it is necessary to indicate that to Java in the system start up, through the user.timezone attribute, according to the following examples:
SE Suite in Windows
▪Execute the "Tomcat monitor" application (TOMCAT_HOME\bin\tomcat7w.exe) ▪Access the Java tab ▪Add a new line in the "Java options" field with the value: -Duser.timezone=America/Los_Angeles
Adjusting the day light saving time
If the system displays the divergence message between daylight saving time between Java and PHP, the problem may be in the version of the Java time zone database, to update the database follow the steps:
▪If Java JRE is being used, download the "Timezone Updater Tool" application available on the Oracle website; If Java OpenJDK is being used, download the "ZIUpdater Time Zone Tool" application available on the Azul Systems website. ▪ Run the application with the same Java virtual machine used by SE Suite with the command line "java -jar tzupdater.jar -f". For Java OpenJDK, execute the "java -jar ziupdater-1.0.1.2.jar -f" command.
If the current directory is different to where tzupdater.jar is, use the full path up to the tzupdater.jar file.
1) If it is JVM Oracle, use the command below to update the service:
"%JAVA_HOME%/bin/java.exe" -jar tzupdater.jar -v -f -l file:////tzdata2014a.tar.gz
For example:
"C:\Program Files\Java\jre1.8.0_101\bin\java.exe" -jar tzupdater.jar -v -f -l file:///Users/Administrator/Desktop/sesuitetz-windows/tzdata-latest.tar.gz
|
2) If it is JVM OpenJDK, use the command below to update the service:
"%JAVA_HOME%/bin/java.exe" -jar ziupdater.jar -v -f -l file:////tzdata2014a.tar.gz
For example:
"C:\Program Files\Java\jre1.8.0_101\bin\java.exe" -jar ziupdater.jar -v -f -l file:///Users/Administrator/Desktop/sesuitetz-windows/tzdata-latest.tar.gz
|
▪To compare the time zone database versions of Java and of the application, execute the "java -jar tzupdater.jar -V" command. |
|
To set the time zone that will be used by PHP, it is necessary to edit the php.ini file (usually located in SESUITE_HOME\web\phpBaseclass\php.ini). Locate and edit the following line according to your time zone:
date.timezone = America/Los_Angeles
|
|
System
|
Parameter
|
Description
|
GENERAL
|
HD
|
"HD free space is {SPACE AVAILABLE IN DISK}, when it should be at least 5GB."
|
Solution: Free up physical space on the machine.
|
GENERAL
|
JavaVersion
|
"The installed Java version is {JAVA VERSION}, when it should be 1.8."
|
Solution: Remove the java version and install the correct one.
|
GENERAL
|
TomcatMemory
|
"The Apache Tomcat server is configured to use up to {CONFIGURED_MEMORY} MB of memory. At least 1024 MB are required. See how to perform this operation in the Installation guide."
|
Solution: For Windows environments, refer to the memory configuration procedure described in the Apache Tomcat installation section.
|
|
System
|
Parameter
|
Description
|
GENERAL
|
output_buffering
|
"Output_buffering variable value is {VALUE}, when it should be 1. Check configuration in php.ini."
|
GENERAL
|
max_input_time
|
"Max_input_time variable value is {VALUE}, when it should be at least 300. Check configuration in php.ini."
|
GENERAL
|
memory_limit
|
"Memory_limit variable value is {VALUE}, when it should be -1. Check configuration in php.ini."
|
GENERAL
|
post_max_size
|
"Post_max_size variable value is {VALUE}, when it should be at least 500M. Check configuration in php.ini."
|
GENERAL
|
upload_max_filesize
|
"Upload_max_filesize variable value is {VALUE}, when it should be at least 500M. Check configuration in php.ini."
|
GENERAL
|
session.name
|
"Session.name variable value is {VALUE}, when it should be se-authentication-token. Check configuration in php.ini."
|
GENERAL
|
session.gc_probability
|
"Session.gc_probability variable value is {VALUE}, when it should be 0. Check configuration in php.ini."
|
GENERAL
|
session.gc_maxlifetime
|
"Session.gc_maxlifetime variable value is {VALUE}, when it should be 86400. Check configuration in php.ini."
|
GENERAL
|
session.cache_expire
|
"Session.cache_expire variable value is {VALUE}, when it should be 86400. Check configuration in php.ini."
|
GENERAL
|
opcache.enable
|
"Opcache.enable variable value is {VALUE}, when it should be 1. Check configuration in php.ini."
|
GENERAL
|
opcache.memory_consumption
|
"Opcache.memory_consumption variable value is {VALUE}, when it should be 256. Check configuration in php.ini."
|
GENERAL
|
opcache.interned_strings_buffer
|
"Opcache.interned_strings_buffer variable value is {VALUE}, when it should be 128. Check configuration in php.ini."
|
GENERAL
|
opcache.max_accelerated_files
|
"Opcache.max_accelerated_files variable value is {VALUE}, when it should be 70000. Check configuration in php.ini."
|
GENERAL
|
opcache.save_comments
|
"Opcache.save_comments variable value is {VALUE}, when it should be 1. Check configuration in php.ini."
|
GENERAL
|
opcache.load_comments
|
"Opcache.load_comments variable value is {VALUE}, when it should be 1. Check configuration in php.ini."
|
GENERAL
|
opcache.enable_cli
|
"Opcache.enable_cli variable value is {VALUE}, when it should be 0. Check configuration in php.ini."
|
GENERAL
|
max_execution_time
|
"Max_execution_time variable value is {VALUE}, when it should be at least 200. Check configuration in php.ini."
|
GENERAL
|
session.save_path
|
"Session.save_path variable was not configured. Check configuration in php.ini."
|
GENERAL
|
date.timezone
|
Date.timezone Java variable (JAVA_TIMEZONE) must be the same as the PHP variable (PHP_TIMEZONE). Java uses the time zone defined by the operating system, while PHP uses the value defined in the php.ini file."
|
Solution:
1.Open the SUITE_HOME\web\php\php.ini file and search for the message variable. 2.Check for other similar variables (repeated). 3.If there are repeated variables, add a “;” (semi-colon) at the beginning of the line for it to be commented, thus the variable will not be validated. Example of a commented variable: ;cgi.force_redirect = 1
Example of valid variable (uncommented):
cgi.force_redirect = 1
4.After locating the variable, define the correct value, as described in the message. 5.Save the file and restart SE Suite. |
WINDOWS
|
realpath_cache_size
|
"Realpath_cache_size variable value is {VALUE}, when it should be at least 1024k. Check configuration in php.ini."
|
WINDOWS
|
cgi.force_redirect
|
"Cgi.force_redirect variable value is {VALUE}, when it should be 0. Check configuration in php.ini."
|
WINDOWS
|
fastcgi.impersonate
|
"Fastcgi.impersonate variable value is {VALUE}, when it should be 1. Check configuration in php.ini."
|
Solution:
1.Open the SUITE_HOME\web\php\php.ini file and search for the message variable. 2.Check for other similar variables (repeated). 3.If there are repeated variables, add a “;” (semi-colon) at the beginning of the line for it to be commented, thus the variable will not be validated. Example of a commented variable: ;cgi.force_redirect = 1
Example of valid variable (uncommented):
cgi.force_redirect = 1
4.After locating the variable, define the correct value, as described in the message. 5.Save the file and restart SE Suite. |
WINDOWS
|
Zend OPcache
|
"zend_extension=ZendLoader.dll extension is not enabled. Check configuration in php.ini."
|
WINDOWS
|
memcache
|
"extension=php_memcache.dll extension is not enabled. Check configuration in php.ini."
|
WINDOWS
|
zip
|
"extension=zip.dll extension is not enabled. Check configuration in php.ini."
|
WINDOWS
|
soap
|
"extension=soap.dll extension is not enabled. Check configuration in php.ini."
|
WINDOWS
|
gd
|
"extension=gd.dll extension is not enabled. Check configuration in php.ini."
|
Solution:
1.Open the SUITE_HOME\web\php\php.ini file and search for the extension described in the message. 2.Check for other similar extensions (repeated). 3.If there are repeated extensions, add a “;” (semi-colon) at the beginning of the line for it to be commented, thus the extension will not be validated. Example of a commented extension: ;zend_extension=php_opcache.dll
Example of a valid extension (uncommented):
zend_extension=php_opcache.dll
4.After locating the extension, define the correct value, as described in the message. 5.Save the file and restart SE Suite. |
|
System
|
Parameter
|
Description
|
GENERAL
|
...web\include\template
|
The {NAME_OF_FILE} template is not a template in the JSON format.
|
Solution: Contact SoftExpert.
|
|
System
|
Methods
|
Description
|
GENERAL
|
GET/POST/PUT/DELETE
|
The application server is configured to block HTTP restrictions with the {METHOD} method
|
Solution: Release requests for the application server with the required method. Usually, the WebDav module of IIS blocks some methods by default.
|
|
Database port configuration
During CHECKSYSTEM (process that validates the system while it starts), a validation of the export service occurs. One of the most common issues that occur in this service is having a specific port defined that is not accessible to the service. Thus, it is recommended to update the database directly, defining an automatic (value 0) or specific port to solve this situation.
Update through the database:
UPDATE bi2config SET nrportexport = 0 --Port number
WHERE oid = 1;
Node.js verification points
• Make sure the installed node version is 8.9.1.
• All libraries must be installed during the installation process.
• The TEMP path must have all correct permissions.
• The server must meet the memory requirements, as there may be slowness in exports or failures.
• Make sure the server has all fonts used in the system installed; the server must have at least the Arial font available.
• Make sure that, if there is an antivirus service installed in the server, it will be necessary to add SE Suite to an internet scanning exception list, under website blocking.
|
|