# Installing enaio® webclient

enaio® • 10.10 »

In this version, enaio® webclient is installed as a 'osweb' microservice with enaio® service-manager and has to be reconfigured with enaio® services-admin as part of an update.

The previous configuration cannot be transferred. This configuration has been saved in the osweb.properties file. Save this file before uninstalling enaio® webclient version 10.0.

Some parameters have been removed from enaio® webclient's functionality. The corresponding settings are now based on the general enaio® settings and the individual system roles and access rights of the users.

## Installation Requirements

- enaio® server is installed and launched.

- The 'WEB' license is integrated in enaio® enterprise-manager.

- The following microservices are installed: 'license' und 'dms'.

- enaio® gateway is installed, started, and configured for login.

- enaio® appconnector is installed and launched.

## New Installations

If the installation requirements have been met, then please perform the following steps:

- Install the 'osweb' service via enaio® service-manager.

- Configure it with enaio® services-admin.

## Updating

To perform an update, please follow these steps:

- As with the new installation, install the 'osweb' service and configure it.

- After the technical user has been removed, check whether the access rights for the users need to be changed.

- After removing configuration parameters for the functionality, check whether the system roles for the users need to be changed.

- Delete the entry for the webclient-updates endpoint for the update feature of enaio® webclient as a desktop application from the application-prod.yml configuration file of enaio® gateway as well as the osweb endpoint located there:

      proxy:
      defaultEntryPoint: '/osweb'
      services:
       endpoints:
       - endpoint:
          name: osweb
          url: 'http://<host>:9090'

- The previous port '9090' has been changed to '7900'. Check whether any changes need to be made, such as to the firewall settings.

- Calls can no longer be made using the \entry.do parameter. Instead, you can use /#/entry? to enter.

- Once the update is complete, the old installation can be deinstalled using the Control Panel.

- If the former technical user does not have functions elsewhere, then it can be deleted.

- Configurations for integrating into an iFrame are no longer necessary.

## enaio® webclient version 10.10

### Access Rights – Technical User

Until now, a technical user was integrated for enaio® webclient, whose access rights had a significant influence: The access rights of an enaio® webclient user were based on where the access rights of the technical user and those of the logged-in user overlapped. This concept made it possible to adhere to restrictions for object types that differed between enaio® webclient and enaio® client. Thanks to the approximate functional equality of enaio® webclient and enaio® client, this is no longer necessary and the function of the technical user has been eliminated. This standardized configurations for enaio® client and enaio® webclient and made them clearer for enaio® webclient.

Access rights are only based on the individual access rights of the users.

If extensive adjustments to user access rights and scripts are necessary in installations, then the technical user can continue to be included as a transitional measure. This option will only be available until the next major release after 11.0.

### Functionality

The functionality of enaio® is based on the individual system roles and general enaio® settings. The following parameters have been removed:

version 10.0 parameters | Replaced with:
--- | ---
Open location com.os.osdrt.location.enable | A new system role has been added for this function: Webclient: Open location
Enable workflow com.os.osdrt.workflow | System role 'Client: Use workflow'
Show object search com.os.odrt.search.enabled | System role 'Client: Run default search'
Enable export com.os.osdrt.exportfiles.enabled | System role 'Client: Export document contents'
Enable hit list export com.os.osdrt.exporthits.enabled | System role 'Client: Export index data'
Support for basic parameters com.os.osdrt.baseparams.use | Entry in the as.cfg file of the file directory: SHOWBASISPARAMETER
Enable full-text search com.os.osdrt.fulltext.use | The full-text search is enabled if the 'search' microservice is installed. Users need the 'Client: Run default search' system role.
Office 365 integration com.os.osdrt.office365 | Office 365 is enabled if the Office 365 microservices are installed.
Enable variant administration com.os.osdrt.variant.administration.enabled | The variant administration is always enabled for enaio® webclient.
Logging com.os.osdrt.loglevel | The logging is configured via enaio® services-admin.
Server connection com.os.osdrt.appserver.server com.os.osdrt.appserver.port | enaio® service-manager knows the data for the server connection.
Technical user com.os.osdrt.appserver.mainuser com.os.osdrt.appserver.mainuserpwd | The technical user has been removed.

Navigation | Navigate through the help pages using the table of contents on the left. If it is not displayed when the window width is small, you can temporarily show it via the hamburger menu on the right. Use the arrows on the toolbar to navigate to the next/previous page. You can show hidden areas. Use the toolbar to show all hidden areas at once:
--- | ---
Clicking the product icon in the header returns you to the beginning of the current area. Use the toolbar to access the initial page:

Full-text Search | The search does not feature case sensitivity. A search term is also found as part of a string. Multiple search terms in the exact order as entered will be found if they are enclosed in quotation marks (").
--- | ---
Boolean Operators | You can use the following Boolean operators:
AND | Finds the pages that contain all search terms. Spaces, '+', and '&' function the same.
OR | Finds the pages that contain at least one of the search terms. The pipe character (|) functions the same.
You can combine search terms and Boolean operators using parentheses. Example: Paul AND (Peter OR Meyer)
The current portal area is used for the search. You can use Google to search through all portal areas. Example: follow-ups site:help.optimal-systems.com

Please contact the OPTIMAL SYSTEMS technical editorial staff for questions and comments regarding the documention at dokumentation(at)optimal-systems.de.