Frequent Questions

This chapter will show some normal situations and how to handle them.

Address already in use: JVM_Bind:8080

If you are receiving this error "Address already in use: JVM_Bind" it may be caused by another process using the same port Carol Connect is configured to use.

Let's start verifying the ports defined in the "app.config.yml" file:

applicationConnectors:
    - type: http
      port: 8880
  adminConnectors:
    - type: http
      port: 8881

In the example, it is using the ports 8880 and 8881. The port "adminConnectors" can be changed without any impact. The port defined in "applicationConnectors" will change the URL that you access Carol Connect.

🚧

After changing the file "app.config.yml" you need to restart it

After updating the config file, you need to restart the Carol Connect to make sure the configuration will be considered.

Another important validation is the command "netstat". This command shows the ports In use, so you can identify the other process using the port configured in Carol Connect.

Usage:

  • Windows: "netstat -ano"
  • Linux: "netstat -an"

Both will show a list of processes and the ports in use. For Linux based environments, you can use the "grep" to filter the port you are looking for. For Windows, you can send the output to a file and analyze the content in a text editor.

Handling rowid column with varchar type field

For 2C to recognize the field type "rowid", we need to use an internal function in Oracle to convert this column to a recognized formated:

  • Instead to use the ROWID column :
465465

We need to use the ROWIDTOCHAR function:

473473

So, in this way the column type is converted to char/string and 2C/Carol can handle this column. Better to create a view and sync the view to Carol.

How to update 2c

To update 2c to a new version, follow these steps:

WINDOWS

  • stop 2c service;
  • remove 2c service using this bat serviceremove.bat on administrator cmd;
  • Extract and overwrite the zip files in the root directory to 2c;
  • execute serviceinstall.bat on administrator cmd;
  • and finally start the service again.

LINUX

  • Remove 2c service from initial load using: sudo systemctl disable [service_name]
  • Stop 2c service using this command: sudo systemctl stop [service_name]
  • To check if the service has stopped use this command: sudo systemctl status [service_name]
  • If the service is still running use this command to kill a process on Linux: kill [pid_number]
  • Extract and overwrite the zip files in the root directory to 2c.
  • After updating 2c, start 2c service using this command: sudo systemctl start [service_name]
  • If the service is configured correctly, it will start right away. Meanwhile, to check Linux services i.e. their health status we can use: sudo systemctl status [service_name]
  • It is also possible to have a service running while the operating system is loading. Use: sudo systemctl enable [service_name]

How to remove 2c

To remove 2c, follow these steps:

WINDOWS

  • stop 2c service;
  • remove 2c service using this bat serviceremove.bat on administrator cmd;

LINUX

  • Remove 2c service from initial load using: sudo systemctl disable [service_name]
  • Stop 2c service using this command: sudo systemctl stop [service_name]
  • To check if the service has stopped use this command: sudo systemctl status [service_name]
  • If the service is still running use this command to kill a process on Linux: kill [pid_number]

How to obtain or edit the connection database from 2C to Carol

Please follow up this steps:

13661366

How to sync Images with Protheus

If you need to sync the employees images to Carol, you need to configure a directory connection with the folder called 'shared', for further information about how to create a directory connection click on this link: https://docs.carol.ai/docs/carol-connect-2c#creating-a-connection-to-your-directory

Notes: The directory connection needs to sync with a scheduled strategy, see more here: https://docs.carol.ai/docs/carol-connect-2c#synchronization-strategy

Example:

  • First define the recurrancy of the sync: I want the sync every day at 12:00. So we can use a site to help us to search this cron option:

http://www.cronmaker.com/

12641264

So with this expression: 0 0 12 1/1 ? we can update the app.config.yml to change the schedule:

13661366

And we change with the new value:

13661366

Please save the file, and follow up this steps for the changes have effect:

  • Stop the service;

  • Start the service again;

And we can find this update on 2C:

13661366

Now set to execute every day at 12:00 And if you need to resend the images again, please click on resend data:

13651365