Qrulla Docs

Reference

Common problems

What to do when a connection fails, the license can't be checked or something doesn't look as you expected.

Couldn't connect

  • Check the host, the port and that your network reaches it (VPN, firewall). If the server is only reachable from another machine, use an SSH tunnel.
  • “Wrong user or password”: check the credentials. In MongoDB the user is checked against the admin database.
  • With TLS, if verifying the certificate fails, load the CA's certificate under “Certificates” or lower it to “Required” while you sort it out.

“Oracle Instant Client is missing”

Qrulla needs Oracle's official 64-bit client. Follow the Instant Client steps. If you already picked it and it still fails, check that the folder is the unzipped one (the one with oci.dll on Windows or libclntsh on Mac and Linux) and, on Linux, that libaio is installed.

“SSH server not confirmed yet” or “The SSH server fingerprint changed”

The first time you must confirm the SSH server's fingerprint: open “Edit” on the connection and use “Test connection”. If it says the fingerprint changed, don't trust the new one without checking with whoever runs the server.

“The system keyring is not available”

Qrulla keeps passwords in the system keyring. On Linux it needs a keyring service (GNOME Keyring or KWallet) running. Meanwhile, uncheck “Save the password” and type it when you connect.

The license can't be checked

  • “No connection to the license server”: check your internet. Qrulla keeps working for up to 24 hours after the last check.
  • “This computer's clock is behind”: fix the system date and time.
  • “Your license is already active on another computer”: release the old one under “Computers”. See Computers.
  • “Too many attempts”: wait 15 minutes and try again.

A purchase or a seat doesn't show up

Confirm your email with the link you got when you created the account; until then, what's given to that address doesn't arrive. Then click “Check now” in “License and account”.

I can't save changes in the grid

  • The table has no primary key: it opens read-only.
  • “A row changed or was deleted since it was read”: someone else touched it. Refresh with F5 and make your change again.

Accents look wrong when importing or running a file

Change the encoding to Windows-1252 (Latin-1) in the dialog. Spanish Excel files often come that way.

Help

Write to support@qrulla.com with what you were trying to do, the error message and your system. A copy's or an SQL file's log can be copied with “Copy log”.

Something missing or unclear? Write to support@qrulla.com.