Configuration Issues
Expand |
---|
title | No logs generated in the log file |
---|
|
Step | Possible reason(s) | Possible solution(s) | Remarks |
---|
1 | Issues with the CLASSPATH. Info |
---|
JARS mentioned in the CLASSPATH may not be present in the specified folder. |
| Check whether the JARS used in the CLASSPATH are present at the specified location or not. To check for the path of the JAR files, open logs-archive-cleanup.bat or logs-archive-cleanup.sh file. Here you will find all the JARS used in the CLASSPATH. The log cleanup and archival process will fail and no log will be generated even if a single JAR file is missing from its specified location. In such a case, contact Adeptia support. |
|
...
Expand |
---|
title | Unable to perform cleanup for table <table name> |
---|
|
Step | Possible reason(s) | Possible solution(s)Remarks |
---|
1 | Issues with application settings.
| Do the followings: Set the property abpm.logs.archival.batch.enable to no. Set the property abpm.logs.delete.chunks.enable to no. Retry executing the log cleanup and archival process.
| If not solved, contact Adeptia support. |
|
Database Database issues
Common issues
Expand |
---|
title | Sluggish Transaction/Process Flow execution |
---|
|
Step | Possible reason(s) | Possible solution(s) | Remarks |
---|
1 | The database server is heavily loaded to handle the request, or doesn't have enough number of connections available. | You should always run log cleanup and archival process when either the server has no load or have minimum load. Also make sure that there are enough database connections available to use.If not solved, contact Adeptia support. |
|
Expand |
---|
title | Error at runtime and failure of query execution |
---|
|
Step | Possible reason(s) | Possible solution(s)Remarks |
---|
1 | Compatibility issues between the database driver version and database server. | You should always make sure that database driver jars should be compatible with the database server. If not solved, contact Adeptia support. |
|
SQL Database Errors
Expand |
---|
title | Data truncation: Out of range value for column |
---|
|
Step | Possible reason(s) | Possible solution(s) | Remarks |
---|
1 | One or more columns in log table and their corresponding columns in log archive table differ in size(s). It means that the at least one of the column size of the log table is different then log archive table.
| Alter the log archival table to correct the structure of the table in line with the log table. It can be done by using alter query. If not solved, contact Adeptia support. |
|
Expand |
---|
title | Oracle: No more data to read from socket |
---|
|
Step | Possible reason(s) | Possible solution(s) |
---|
1 | Log cleanup and archival process interrupted due to Oracle database connectivity issues. Info |
---|
This is Oracle specific error. |
|
|
Oracle database server disconnect connection forcefully. This can be because of the server were shutting down at the same moment when archival starts. Once oracle restarts then | Restart the server, and the log cleanup and archival process should |
|
run start running successfully. |
|
Transaction (Process ID 543) was deadlocked on lock resources with another process and has been chosen as the deadlock victim. Rerun the transaction.
This issue should not occur but if it does then it will be a bug into the product. It should be fixed in the product so log the defect to product team.
Expand |
---|
title | No of columns mismatch |
---|
|
It means that number of the columns in the log table is different then log archive table. It can be fixed by altering |
Step | Possible reason(s) | Possible solution(s) |
---|
1 | One or more columns in log table and their corresponding columns in log archive table differ in size(s).
| Alter the log archival table to correct the structure of the table |
|
(same as in line with the log table |
|
). It can be done by using alter query. |
|
Expand |
---|
title | Parameter Number 4 is not an OUT parameter |
---|
|
This error comes when stored procedures are missing. For example, |
Step | Possible reason(s) | Possible solution(s) |
---|
1 | Stored Procedures such as AU_SP_DELETE_ARCHIVE_LOGS, AU_SP_DELETE_LOGS |
|
. Create the stored procedures | Create the missing Stored Procedures in the database. You can find these |
|
procedure Stored Procedure in initialize-log-msq-{dbname}.sql file. For example |
|
, : initialize-log-msq-mysql.sql for |
|
mysql
Expand |
---|
title | ORA-30036: unable to extend segment by 8 in |
---|
|
undo > undo> tablespace 'UNDOTBS1' |
|
Step | Possible reason(s) | Possible solution(s) |
---|
1 | The "undo Tablespace" size is completely occupied or the size for "AU_TransactionLog" is very large. |
|
Set | Set the size of "undo tablespace" to auto-extend in the Database.
|
|
Expand |
---|
title | Lock wait timeout exceeded; try restarting transaction |
---|
|
This error usually comes when the
Step | Possible reason(s) | Possible solution(s) |
---|
1 | |
|
in case of large due to large amount of data present in it |
|
or due to the , large number of uncommitted transactions, etc. |
|
If you'll try Info |
---|
You may encounter this error while trying to delete a bunch of records using |
|
|
MYSQL MySQL administrator or some other DB tool |
|
|
then you'll receive the same error. Increasing value of innodb | Increase the value for innodb_lock_wait_ |
|
timeout should resolve your issue or folders operation Permission issueSometimes logged-in user does |
Step | Possible reason(s) | Possible solution(s) |
---|
1 | User may not have permission to delete the file/folder. |
|
So please check that user have appropriate permission for this. Provide the necessary permission | Check and grant the necessary permissions to the user. |
|
Expand |
---|
title | File/Folder does not exist |
---|
|
Step | Possible reason(s) | Possible solution(s) |
---|
1 | The specified file/folder |
|
has been deleted in between the process. This can happen if is deleted. Info |
---|
This may happen because the file/folder has been deleted manually, or by any other process |
|
|
. Or May be this folder is not created ever. You can create that | Create the required file/folder manually. |
|
are Sometimes at the time of cleanup, the same can be in use by any other process |
Step | Possible reason(s) | Possible solution(s) |
---|
1 | The file/folder may be in use or opened by any |
|
process. In this case file will not be deleted. Check if any files | Check for and close the files that are open in any editor or |
|
it is tool and close that file from editor/Not Enough Disk Space
Sometimes disk space is full at the server and in this case there
Expand |
---|
title | Insufficient disk space |
---|
|
Step | Possible reason(s) | Possible solution(s) |
---|
1 | Disk space on the sever is low or completely exhausted. There is no space to copy new repository files. |
|
Delete folder Mail notification issues
Error while sending the mail notification for log clean and archival process failure.
- In log cleanup and archival process, if there is any issue occurred in the process then user will get an mail notification with error details. Below is a sample,
java.lang.Exception: java.lang.Exception: Failed to connect to mail server.Either mail server is not available or host/port/username/password parameters are invalid.
at notification.SendNotificationMail.sendMail(SendNotificationMail.java:169)
at notification.SendNotificationMail.sendMail(SendNotificationMail.java:60) - You need to check that mail configuration are correct for mail notification. You can find these properties under “Mail Server Properties” group in server-configure.properties file.
- You also need to verify that there is no connectivity issue with the mail server.
- Sometime you may have to enable the less secure apps property. For example if you are using gmail id for mail Notification then you may need to enable this:
Expand |
---|
title | Unable to receive mail notifications for a failed log cleanup and archival process |
---|
|
Step | Possible reason(s) | Possible solution(s) | Remarks |
---|
1 | Incorrect configuration of mail server properties. | Check for and correct the mail server properties configuration. | If not solved, follow the step 2. | 2 | Connectivity issue with the mail server. | Check for and fix any mail server connectivity issues. | If not solved, follow the step 3. | 3 | Mail notifications not allowed from an external app. | Check for and allow the email account/mailbox to accept notifications from an external app. | If not solved, contact Adeptia support. |
|
Issues leading to Force Cleanup
Expand |
---|
title | Log cleanup and archival process is not running |
---|
|
Step | Possible reason(s) | Possible solution(s) |
---|
1 | Increased logs size in the database. | Perform a force cleanup to clean the logs data.
|
|
If you're still unable to fix any of the issues, contact Adeptia support.