Before installing or upgrading Attaché, ensure your system has been set up according to the following requirements. This article should be read by your System Administrator or IT Support person.
Hardware and network compatibility
All workstation and server operating systems meet our hardware requirements.
8GB RAM is available and dedicated for Attaché.
IPv4 is set up as the method of TCP/IP communication. (Note: IPv6 is not supported by Attaché.)
Ports 6597, 6587, 25 are open on the server hosting the Attaché Database Server for internal traffic.
Port 6597 is the default port for the Attaché Database Server.
Port 6587 is the default port for the Attaché API Service.
Port 25 must be opened on outgoing if Document Delivery is using mailforalex.com. See: Set up Alex when Port 25 is closed
Attaché users have full control permissions applied to the Attaché Desktop application folder.
Standard procedure is to grant full control to the whole \Apps\ folder, so all Attaché related files underneath inherit the permissions.
E.g. C:\Apps\Attache.
For connectivity between Attaché Desktop and Attaché Online using Cloud Connector. The User running these services has internet access. The default Service User upon installation is Local System.
TLS1.1 and TLS1.2 are enabled in Internet Options.
If using a Proxy Server.
Cloud Connector services have no facility to input authentication details, above and beyond setting the User under which the services run.
Therefore, connections to hub.attacheonline.com & api.attacheonline.com should not require authentication above coming from an authenticated domain account.
Generic whitelisting is the easiest way to ensure connectivity. Encrypted HTTPS (port 443) traffic:
*.attacheonline.com*
*.attachesoftware.com*
*.attachecloud.com*
Detailed whitelisting:
Port 443 hub.attacheonline.com.
Confirm internet connectivity by navigating here and getting a current status of OK.
📌 Note: This only checks the currently logged in user's internet access (not Local System)
Port 443 api.attacheonline.com.
Confirm internet connectivity by navigating here and getting a response of "This XML file does not appear to have any style information associated with it".
📌Note: This only checks the currently logged in user's internet access (not Local System).
Port 443 id.attacheonline.com.
Port 443 gateway.attacheonline.com.
Microsoft Windows Compatibility
Ensure all workstation and server operating systems are Microsoft-supported versions as per the Microsoft Windows lifecycle fact sheet.
The Attaché Service API and Cloud Connector services require Microsoft Message Queueing (MSMQ) to be enabled.
.NET Framework 4.7.2 and .NET Framework 3.5 are installed on the server and all workstations. If necessary, you can install.NET Framework version 3.5 and .NET Framework version 4.7.2 from the Microsoft website.
.NETCore 2.1 (x86) & ASP.NET Core 2.1 (x86) runtimes.
Visual C++ Redistributable for Visual Studio 2015 is installed on the server and all workstations. If necessary, you can install Visual C++ Redistributable for Visual Studio 2015 from the Microsoft website.
All current Microsoft updates and service packs are installed.
Notes:
Microsoft Windows System settings
System Properties, Advanced System Settings:
Processor Scheduling = Programs.
DEP for essential Windows Programs and Services Only = ON.
(or exclude all Attaché executables).
Set Windows Region and Language to English (Australian).
Set Windows Location to Australia or New Zealand.