Workflow Server also runs as a service under Windows. Just like Authentication and Content Server it requires a Windows user with administrator rights.
When a user synchronization with an ACTIVE DIRECTORY is run via Workflow Server, the user under whom Workflow Server runs must be in the same domain as the ACTIVE DIRECTORY.
It is legitimate to use the same Windows user with administrator rights for all DocuWare Servers.
Workflow Server – General information:
DocuWare Workflow Server controls the workflows that are pre-defined in DocuWare Administration.
The port for Workflow Server must be opened on the firewall being used.
Workflow Server Settings
The settings for Workflow Server are defined in the DWWorkflowServer.exe.settings file.
importExportNodeThreads
You can define how many documents are uploaded or downloaded simultaneously as part of each workflow. This setting applies to all workflows in which documents are imported or exported, for example export workflows and synchronization workflows.
If these workflows run on a powerful computer at less than full capacity, you can accelerate the running of these workflows by increasing the number of „importExportNodeThreads". The default value is: importExportNodeThreads="1".
maxTextExtractionInstances
This setting describes the maximum number of text extractions that can be started at the same time. It is also relevant for fulltext workflows. The default value is:
maxTextExtractionInstances="1".
connectionLifeTime
This setting specifies how long connections are kept open. The time is given in seconds. The default value is connectionLifeTime="0" which stands for 10 Minutes.
WorkflowCoreConfig restartWfOnError
This parameter indicates whether a workflow that was stopped due to an error will be stopped permanently or whether it will run again automatically at the next scheduled start time.
Possible values for the parameter are:
"true": The workflow is started again automatically as scheduled.
"false": The workflow is stopped. For the workflow to run again, it must be started manually.
(default value)
UserSyncUsageConfig useNewLDAP
DocuWare Administration
As of DocuWare 5.1b SP 3, a new implementation of the LDAP integration will be used for user synchronization. Should this lead to problems in particular cases, you can disable it using the UserSyncUsageConfig useNewLDAP parameter and revert to the previous variant.
Possible values for the parameter are:
"true": User synchronization uses a new implementation of the LDAP integration.
"false": User synchronization uses the old variant of the LDAP integration 6.5
Notification Server
Notification Server controls e-mail notifications. It is part of the Task Manager add-on module and can only be installed with an appropriate license.
If you want to install an additional Notification Server, please note that only one Notification Server can run in the DocuWare system at the moment. Installing a second Notification Server can still be useful, for example for system stability. If the first Notification Server breaks down, you can immediately start the second server. This will prevent delays in e-mail notifications.
6.6
Database connections
6.6.1
Connecting to the Database
Settings for the database connections are contained in the file DocuWare.DAL.dll.config. There is a separate copy of this file for Authentication Server, Content Server and Workflow Server.
Timeout for Connections and Commands
Apart from the regular commands, DocuWare also has commands with a long expected run-time.
These commands are usually run for administrative operations, e.g. creating a new column, column index or fulltext. The length of time a command takes when run for these tasks depends on the size of the tables involved, which is why such commands take more time than regular commands. If necessary, you can adjust the values, which are all in seconds.
ConnectionTimeout="x" Timeout for creating a connection to the database,
default value: 30 sec.
CommandTimeout="y" Timeout for standard commands, default value: 30 sec.
LongCommandTimeout="z" Timeout for commands with a long expected run-time,
default value: 600 sec. (from DocuWare 5.1b SP3)
If you use a DocuWare version older than 5.1b SP3…
… and large fulltext file cabinets, you should go to the DocuWare.DAL.dll.config file in the Workflow Server and manually set the LongCommandTimeout value to 1200.
… and would like to add file cabinet fields or column indexes later, you should go to the DocuWare.DAL.dll.config file in the Content Server and manually set the
LongCommandTimeout value to 1200. A higher value is particularly useful if you are using MySQL.
6.6.2
Setting up a DSN system for ODBC data sources in 64-bit systems
If you have a 64-bit Windows system and you add a new DSN system for an ODBC connection using the standard ODBC Data Source Administrator (Start / Control Panel / Administrative Tools / Data Sources (ODBC), the DSN system can only be used by 64-bit applications. DocuWare does not work with this DSN system.
To create a new DSN system for an ODBC connection for 32-bit applications, open the ODBC Data Source Administrator via C:\windows\SysWOW64\odbcad32.exe. The newly created DSN system can then be used by DocuWare.
6.7
Imaging Server
Imaging Server, for web-based file cabinet access, converts stored documents that are to be displayed in the Web Client Viewer to a graphics format. This ensures that all main file formats can be displayed and printed in high quality even without a browser plug-in. Imaging Server is also responsible for converting files to PDF and for the text search in the Web Client Viewer.
Imaging Server runs as a local service on Windows.
Installing a Second Imaging Server
To install a second Imaging Server on your DocuWare system, proceed as follows:
1. Open the Windows command line. On Windows Vista/Windows 7, you need the Windows command line with administrative rights, so you need to run e.g. the cmd.exe file via the Open as Administrator context menu. Navigate in the command line to the Imaging Server directory, which in a default installation is located here:
cd "c:\Programme\DocuWare\Imaging Server"
2. Register a second service using the following command. Copy the command exactly, including any spaces or special characters.
DocuWare Administration
sc create DWImagingService2 binPath= "\"%cd%\DWImagingService.exe\"
2" DisplayName= "DocuWare Imaging Server 2" start= auto In this case, the second Imaging Server receives the http addres
http://localhost:9009/DWImaging2 , which is the default address plus the suffix 2
3. Customize the configuration of Web Client Server by adding the second Imaging Server to the web.config file (in the folder …\Inetpub\wwwroot\<Name of Web instance>). Make sure that the value for the "name" attribute is always unique
...
Deleting the Additional Imaging Server
If you want to delete the second Imaging Server, use this command sc delete DWImagingService2
Amend the web.config file back to its original status and delete the directory of the second Imaging Server from the file directory.
6.8
Storage locations for documents
This is where the system administrator defines the storage locations for DocuWare documents.
The user under whom Content Server runs must have "Full Control" permission to all these directories.
6.9
External User Directories
DocuWare can import existing users and groups from Windows or other directory services. This saves you having to set them up afresh.
Using external user directories you can synchronize Windows users and groups (with or without Active Directory) or users and groups from other directory services (with LDAP support) with DocuWare.
If an external user directory is the source of the DocuWare users, the user directory integrated in DocuWare serves as a meta directory for storing users and groups of the external user directory.
It is not possible to synchronize groups that are members of other groups, with DocuWare, since DocuWare does not support hierarchical groups.
How DocuWare user synchronisation works
All DocuWare-specific settings relating to access rights and menu settings are written to the DocuWare user directory. This means that DocuWare does not impose an adjustment of the external user directory.
Before you can initiate a synchronization of DocuWare groups with the groups from the external user directory the System administrator has to create an appropriate workflow at system level.
When setting up the workflow for user synchronization you need the following important settings:
Type of the external user directory: LDAP or Windows / Active Directory
Name of server on which the external user directory has been saved.
Domain (only with Windows / Active Directory):
Select the domain where the server resides that you have specified.
Port (only for LDAP):
Specify either port 389 (non-secure connection) or port 636 (secure connection)
Note: Port 639 was mistakenly entered in DocuWare Administration instead of port 636. Port 636 will be used anyway.
DocuWare Administration
For LDAP synchronization via Novell eDirectory:
Port 636 cannot be used because Novell does not fully support the Transport Layer Security protocol standard.
When creating the workflow you can specify whether you wish to create a network ID for each
synchronized user. The network ID enables a Trusted login, which means no manual entry of user name and password is necessary when starting DocuWare or DocuWare Administration.
As soon as the system administrator assigns the new workflow to an organization, a new
"synchronization" node appears in the user administration.
The organization administrator of this organization uses this node to specify an explicit synchronization procedure.
6.10
Logging
DocuWare Administration provides logging functionality both at system and at organizational level. In order to configure these logging features you must have the required permissions at system and/or organizational level, i.e. system or organization administrator rights, or the rights to the file cabinet for which you wish to configure logging.
When configuring logging functionalities you specify exactly what to log (logging agent), and where to store the log file (logging target).
It is also possible to disable logging completely (DocuWare System/General/Do not run any logging).
However, please note that you will then be unable to obtain assistance from our Support team should problems occur.
6.10.1
Pre-defined logging functionality
DocuWare automatically sets up pre-defined logging agents at system, organization and file cabinet level. These agents log all critical errors as well as all errors that occur during administration and operation of the DocuWare system. For each of these pre-defined logging agents a logging target is set up specifying the storage location of the log file. All log files which are created by the pre-defined logging agents are stored in a special database (dwlog), in which each pre-defined logging agent has its own table. These standard logging targets cannot be removed.
6.10.2
Pre-defined logging at system level Standard logging at system level
The DocuWare installation process automatically sets up the standard logging target at system level.
If Authentication Server is not running or the database connection has been interrupted, the standard logging target will not work. In such an event all critical errors are stored in the Windows Event indicator, under Application.
Attribute Standard setting Form and storage location
Name DWLOG_SYSTEM
Format Database entry
Database connection Database connection for logging (dwlog)
Table name DWLOG_SYSTEM
Maximum
Maximum size 10000 records
Scrolling options
Delete the first 1000 records
Options
May be used by other users Not selected
Standard logging agent at system level
The standard logging agent of the system logs administrative events as well as events that happen during operation. It cannot be removed.
The table below shows the pre-defined settings for this standard logging agent.
Attribute Standard setting
General Information
Name DWSystem
Status started
Logging level Error
Objective DWLOG_SYSTEM
Additional output devices none
Administrative view
Objects Events
All settings Create, modify, delete
View during operation
Objects Events
Authentication Server session Open, closed
Content server session Open, closed
Database connection Open
File Connections Open
SAP HTTP Connection Open
DocuWare Administration
Attribute Standard setting
General Information
Name DWSystem
SAP Workflow Connection Open
External user directory Open
Workflow (Start, Stop) Open, closed
Any information Settings name Type
GUID
Short User Name User organization
Filters none
6.10.3
Pre-defined logging at organization level Standard logging at organization level
When a new organization is created, the system automatically creates a new standard logging target via the logging database connection (dwlog). For the first organization, this standard logging target is created during the DocuWare installation.
Attribute Standard setting
Form and storage location
Name DWLOG_< organization_name >*
Format Database entry
Database connection Database connection for logging (dwlog)
Table name DWLOG_<organization_name>*
Maximum
Maximum size 10000 records
Scrolling options
Delete the first 1000 records
Options
May be used by other users Not selected
* : The name and table name may each contain a maximum of 32 characters. The organization name will therefore be truncated to 26 characters if necessary.
Standard logging agent at organization level
When the system administrator creates a new organization, a new standard logging agent is created for that organization. The table below shows the pre-defined settings for this standard logging agent.
This standard logging agent logs only administrative events and cannot be removed. In order to log events that occur during operation, a special logging agent must be set up.
Attribute Standard setting
General Information
Name DWOrganisation<organization_name>
Status started
Logging level Error
Objective DWLOG_<organization_name>
Additional output devices none
Administrative view
Objects Events
All settings Create, modify, delete
View during operation Objects
Exceptions Any information Settings name Type
GUID
Short User Name User organization
Filters none
6.10.4
Pre-defined logging for file cabinet Standard logging target for file cabinet
When creating a new file cabinet the system automatically also creates the standard logging target with the logging database connection (dwlog). During DocuWare installation, this standard logging target is created for the Sample file cabinet only.
DocuWare Administration
Attribute Standard setting
Form and storage location
Name DWLOG_<organization_name>_<file_cabinet_name>*
Format Database entries
Database connection Database connection for logging (dwlog)
Table name DWLOG__<organization_name>_<file_cabinet_name>*
Maximum
Maximum size 10000 records
Scrolling options
Delete the first 1000 records
Options
May be used by other users Not selected
* : The name and table name may each contain a maximum of 32 characters. The organization name will therefore be truncated to 15 characters if necessary and the short name of the file cabinet used.
Standard logging agent for file cabinet
When a new file cabinet is created, DocuWare automatically configures a new standard logging agent for it. The table below shows the pre-defined settings for this standard logging agent.
Attribute Standard setting
General Information
Name DWArchiv<file_cabinet_name>
Status started
Logging level Error
Objective DWLOG_<file_cabinet_name>
Additional output devices none
Administrative view
Objects Events
All settings Create, modify, delete
View during operation
Objects Events
Exceptions
Document Save, delete
Document Create, modify, delete
Administrative Information File Cabinet, GUID
Attribute Standard setting Name
Type
User organization Short User Name
Information to running time Document name
Organization Short User Name Index Information File Cabinet Doc ID Changes
Usage all
6.10.5
Pre-defined logging for workflows Standard logging target for workflows
Each workflow type is allocated a standard logging target for each organization. During the installation DocuWare creates the standard logging targets of the workflow types for the first
organization, i.e. for these workflow types: file cabinet synchronization, export, migration, conversion, restore, user group synchronization, Fulltext, AUTOINDEX, Deletion, Create REQUEST container, Add file cabinet to REQUEST container, REQUEST: Recording, SAP Barcode Transfer.
Attribute Standard setting
Form and storage location
Name DWLOG_<Organization_name>_<workflow-type>*
Format Database entries
Database connection Database connection for logging (dwlog)
Table name DWLOG_<Organization_name>_<workflow-type>*
Maximum
Maximum size 10000 records
Scrolling options
Delete the first 1000 records
Options
May be used by other users Not selected
DocuWare Administration
* : The name and table name may each contain a maximum of 32 characters. The organization name will therefore be truncated to 15 characters if necessary and the workflows abbreviated as follows:
AUTOINDEX: AUTOIND
User group synchronization: USERSYNC
Convert DocuWare 4 mode file cabinet: CONVERT DW Restore: RESTORE
Export: EXPORT
Fulltext Service: FULLTEXT Deletion: DELETE
Migration: MIGRA
REQUEST: Add file cabinet to REQUEST container: ADDFC REQUEST: Recording: RECORD
Import REQUEST file cabinet: REGIST SAP Barcode Transfer: BARCODE Synchronization: SYNC
Standard logging agent for workflows
The standard logging agent for workflows logs information during operation only. All administrative events are logged at organization level. The default logging level for workflows is Warning. This means that all conflicts that arise in the workflows are logged in addition to actual errors.
Additional output devices None
View during operation
Objects Events
Workflow type Open, closed
Any information Name
Type GUID
User under whom the workflow runs in Windows User organization
Filters none
* : The workflow name and destination will be abbreviated like this:
AUTOINDEX: AUTOIND
User group synchronization: USERSYNC
Convert DocuWare 4 mode file cabinet: CONVERT
REQUEST: Add file cabinet to REQUEST container: ADDFC REQUEST: Recording: RECORD
Import REQUEST file cabinet: REGIST SAP Barcode Transfer: BARCODE Synchronization: SYNC
6.11
System Debug Logging
Changing the size of the logging file(s)
In DocuWare Administration, you have the option of determining the maximum number of logging files to be created for debug logging for the individual DocuWare system server modules (DocuWare Administration > Local menu > System Debug Logging). For the individual server modules, each of these logging files can be 50 MB by default. Once the file has reached its size limit, a new file is created or the oldest file is overwritten.
You also have the option of adjusting the maximum size of the logging files for the individual server modules. To do this, open the DW<.Servername>.exe.config.SeveralFile file, which in a default installation is located in C:\Programs\DocuWare\<Servername>. (Example of Authentication Server:
DWAuthenticationServer.exe.config.SeveralFile file under C:\Programs\DocuWare\Authentication Server.) Each file includes the entry:
maxFileSize="51200"
This value in kilobytes specifies the maximum file size (here 51,200 kilobytes corresponds to 50 MB).
You can change this value if required.
6.12
General settings affecting the whole organization
6.12.1
Client Management
You manage clients in DocuWare Administration, under Organization x / General / Clients.
Clients are divided into registered and non-registered client computers.
Client computers are registered automatically when a network workstation is installed, in the
organization specified at installation. You can also register a computer on which DocuWare is installed with the relevant DocuWare system at a later date (e.g. as a single workstation or as the network client of another DocuWare system).
Non-registered client computers are those on which DocuWare is installed (as a single workstation or as the network client of another DocuWare system) but which are not registered in the relevant DocuWare system.
DocuWare Administration
DocuWare Administration lets you specify whether non-registered clients are to be allowed in the system or not ("Allow non-registered clients" option). This setting is relevant for opening the DocuWare main program and DocuWare Administration.
The "Allow non-registered clients" option can only be disabled from a computer which is itself a registered client.
If this computer is the only registered client computer and if this computer is then deregistered, it will no longer be possible to open DocuWare Administration or the DocuWare main program from any client computer. In this case the organization administrator must install a new network client. This can
If this computer is the only registered client computer and if this computer is then deregistered, it will no longer be possible to open DocuWare Administration or the DocuWare main program from any client computer. In this case the organization administrator must install a new network client. This can