User manual

System maintenance

  1. Introduction

    The System Maintenance page enables users to access system information, including application version, release details, disk space allocation, database information, and more. Additionally, it allows system monitoring and Tomcat log tracking.

    To access the System maintenance page, navigate to the System section in the main menu, then select Maintenance.

  2. Information

    On the Information tab, you can find important system-related details. Check the release info for feature updates and the latest application functionalities.


    This tab includes:

    1. VM IP address - The unique address assigned to your virtual machine.

    2. Database name - The name of the database associated with your application.

    3. Database startup time - The timestamp indicating when the database was last started.

    4. Database IP - The IP address of the database server.

    5. Database schema - The name of the database schema which stores all the data related to your application.

    6. Database port - The specific network port used for database communication.

    7. Build time - The timestamp indicating when the application was last built.

    8. Revision - The revision number indicating the version of the application.

    9. Version - The version number of your application.

    10. System edition - The specific edition or version of the system you are using.

    11. Release info - Information about your application's latest feature updates and enhancements. Click the Open release info button to open it in a new tab.

    12. Server time - The current timestamp on the server where your application is hosted.

    13. Reload system parameters - Refresh and apply any changes to the system settings, ensuring they take effect immediately.

  3. Services

    View a list of all applications and services connected to your system. You can export the list of services in XLS, PDF, CSV, or XML format.

    On the Services tab, you can:

    1. Start a system-wide job.

      In the system, three types of jobs should only be handled by a single service: Batch mail jobs, Scheduled report jobs, and Jobs scheduled in the Jobs Dashboard. Multiple services should not execute these jobs to ensure smooth system operation.

    2. Stop system-wide job.

    3. Ping service to check its reachability from the application.

      • If the service is unreachable, you will receive the message "Service failed to respond", and the service's status will change to unavailable.

      • If the service is reachable, you will receive the message "Service responded", and the service's status will change to available.

  4. Disk info

    On the Disk info tab, you can view details such as the total storage capacity, used space, and available free space.

    Regularly checking this tab allows you to proactively manage disk space, identify potential storage issues, and take action to prevent problems. This ensures your Linux virtual machine operates efficiently without interruptions.

  5. Diagnostics

    Click the Run system diagnostic button to execute a system script aimed at gathering system information. This process may take a few minutes. Once completed, a link will appear below the button.

    For a comprehensive analysis, download the script log file and forward it to YouTestMe. Please do not close this browser tab while the script is running. If you close it, the script will not complete its download. You can continue your work in the application by opening a new tab.

    This feature is exclusive to On-premise hosting.

  6. Database

    Use the Database tab to manage your application's database. This feature is exclusive to On-premise hosting.

    1. When you click the Export database button, the database will be exported to a file. Once the export is completed, you can download the file using the link provided below the button. You can continue using the application while the database is being exported.

    2. Click the Import database button to choose an exported database file (*.dmp) and import it into the application. Importing a database will replace all existing data in the application with the data from the imported database. We strongly recommend exporting your current database before proceeding with the import.

  7. Monitoring

    Clicking the Performance monitoring button will open a new tab with a monitoring tool. This tool measures and calculates statistics on the application's operation based on user activity, focusing on request statistics and evolution charts.

    The image below displays monitoring statistics captured at a specific date and time, categorized accordingly.

    One crucial statistic you can measure is the number of active HTTP sessions during a predefined period. You can preview the statistics report, which includes the number of concurrent users.

    You can access the statistics report containing the number of concurrent users in two ways:

    1. Click on HTTP sessions - 1 day to preview reports on connected users during the selected time period (in this case, throughout the day).

    2. Under System information on the same page, click the link labeled View HTTP sessions.

    1. HTTP sessions - 1 day

      After selecting the HTTP sessions - 1 day option, you'll see a report displaying the number of HTTP sessions per day. The report also indicates the duration of each session by user. The chart depicts the number of users logged into the application within the specified time period. The monitoring tool tracks user sign-ins per session over time. Refer to the chart report below to preview the number of HTTP sessions throughout the day.

      Note: One HTTP session is equivalent to the one signed-in user.

      Actions available with the HTTP sessions report include:

      1. Return to the monitoring home page.

      2. Main page - Returns you to the monitoring home page.

      3. Update the chart.

      4. Display reports in PDF format.

      5. Online help - Opens the monitoring tool's help page in a new tab.

      6. Desktop - Download the monitoring tool on your computer.

      Additionally, you have the option to customize the period for viewing the report. You can choose:

      1. Day – Preview daily statistics report.

      2. Week – Preview weekly statistics report.

      3. Month – Preview monthly statistics report.

      4. Year – Preview yearly statistics report.

      5. All – View the report for all periods.

      6. Customized – Select a specific period by choosing start and end dates.

      7. By deployment – Choose a system version to preview the report.

    2. View HTTP sessions

      To preview a report click the View HTTP session link.

      The report includes the following columns:

      1. Session ID – The identification number of a session.

      2. Last access – The timestamp when the user accessed the session.

      3. Age – The duration of the session.

      4. Expiration – The exact time when the session expires.

      5. IP address – The user's IP address.

      6. Country – The location of the user signed into the HTTP session.

      7. Browser – The browser used to start the session.

      8. OS – The operating system of the user's computer.

      Note: These columns are essential for administrators and statistical analysis. Number of attributes, Serializable, and Serializable size are additional attributes in the table.

      You can also perform the following actions:

      1. Return back.

      2. Update the table.

      3. Display the report in PDF format.

      4. Invalidate the HTTP sessions.

  8. Log

    View a list of Tomcat logs organized by date. Download the log file to conduct a more detailed analysis.

    The application's log file is saved in two formats. The .log file contains the complete log from deployment onward, while .log.gz files store daily logs. Each .log.gz file has a maximum size of 50 MB; if the daily log exceeds this size, multiple .log.gz files will be created.

System maintenance