Lisa¶

Lisa has shifted to Chromium-based web browsers and adopted OpenSilver as its frontend. This change eliminates the requirement to install Silverlight, which has reached its end of life. Users can now enjoy Lisa without any additional plugins.

Requirements¶

Lime CRM Server Hvannadalsnjúkur - Version 2023.1.1566(2.568.5) or later.
Chromium-based web browser.

Features¶

Available in Lime CRM Web Client: No need to remember different URLs, simply log in to Lime CRM Web Client and access Lisa within Lime CRM Admin.
Register Database: Database registration is disabled in Lisa. Use limefu database register [OPTIONS] instead.
Performance Monitoring and Error Tracking: Enables easier identification and resolution of issues, enhancing user experience.

How to use Lisa¶

Login to Lime CRM Web Client:
- Log in using a user account with admin rights.
Access Lisa:
- Navigate to Lime CRM Admin -> Settings -> Lisa.
- For a full-width view, use the following URL: https://<serverl_url>/client/login/?next=/lisa/.

Installation/Upgrade¶

Add limepkg-lisa as a dependency to your Lime CRM solution:
```
poetry add limepkg-lisa@latest
```
Build and install the solution.

It's recommended to upgrade limepkg-lisa to latest version everytime building a new solution.

Configuration¶

Lime CRM Webserver¶

Update Lime CRM Webserver Configuration:

Option 1:

Active Directory: Editable
Username Format: Open
Views: Limited to application views only

Silverlight Lisa: Deactivated

plugins:
    limepkg_lisa:
        lisa_api_server_backend_url: "http://localhost:5474"
        is_hosting: False
        is_limited_admin: True

Option 2:

Active Directory: Editable
Username Format: Open
Views: Full access, including database editing, user sessions, and all server views

Silverlight Lisa: Accessible

plugins:
    limepkg_lisa:
        lisa_api_server_backend_url: "http://localhost:5472"
        is_hosting: False
        is_limited_admin: False

Option 3:

Active Directory: Not editable
Username Format: Limited to email format
Views: Limited to application views only

Silverlight Lisa: Deactivated

plugins:
    limepkg_lisa:
        lisa_api_server_backend_url: "http://localhost:5474"
        is_hosting: True
        is_limited_admin: True

Restart Lime CRM Webserver.

Registry Editor and Lisa Backend¶

Registry Editor:
- Open the Registry Editor.
- Edit: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Lundalogik\Hosting.
- Add:
  - DisableHostingValidation (REG_DWORD) - Set to 1.
  - GroupAuthorizationEnabled (REG_DWORD) - Set to 0.
  - IsHosting (REG_DWORD) - Set to 0.
  - IsHostingServer (REG_DWORD) - Set to 1.
  - UseLookupForMaggie (REG_DWORD) - Set to 0.
Lisa Configuration:
- Edit C:\Program Files (x86)\Lundalogik\LIME Pro Server\Lundalogik.Lisa.WindowsServiceHost.exe.config.
- Set the Port(5474 or 5472) to the same value as used in lisa_api_server_backend_url.
- Set AllowExternalConnections to 0.
```
<configuration>
  <appSettings>
    <add key="Port" value="5474"/>
    <add key="AllowExternalConnections" value="0"/>
  </appSettings>
</configuration>
```
Restart Lime CRM Server Administration.

Known Issues¶

Peformance¶

Certain operations in Lisa might be slower compared to Silverlight Lisa. Specifically, loading Users and Groups can be significantly slower. If Active Directory is not used, it's recommended to edit users and groups directly in Lime Admin for a smoother experience.

Efforts are ongoing to optimize these operations and enhance Lisa's performance in future updates.

Lime CRM Web Service¶

In some cases, configuring IsHostingServer to 1 may impact the outdated Lime CRM Web Service. If complications arise with the Lime CRM Web Service, apply this workaround:

Open the Registry Editor.
Edit: HKEY_LOCAL_MACHINE\SOFTWARE\Lundalogik\Hosting. Note: this key is different from the one used for configuring Lisa.
Add IsHostingServer (REG_DWORD) - Set to 0.
Restart Lime CRM Web Service