Retain Mobile Archiving

Specs

Tomcat Embedded With Retain

  • Retain ships with embedded Tomcat, which requires you to install and use the embedded Tomcat. Instal­lation on an existing Retain system running a standard Tomcat installation will remove the current Tom­cat connection and install the embedded Tomcat featured with Retain. Installation instructions are found in the install section.

Core System Requirements

  • Before implementing Retain, decide where everything should be installed. Once the support and core components are installed, the features and capabilities are the same no matter what platform it is installed on. You may spread out Retain’s compo­nents on different servers or run them all on one. VMWare ESX and ESXi is supported, but requirements are still in full effect and must be observed.
  • Retain may be configured in separate ways which heavily impact the requirements of the Retain server, indexing engine, database server, and locations dictate resource needs. Ultimately, the number of active users in the system determine the resource needs of the system.

Minimum System Requirements

  • Dual-Core 3 GHz or better Processor
  • Server requires 12 GB RAM free
  • Apache 2.2.x or IIS
  • Supported SQL Database
  • Java Development Kit (JDK) 1.8 64-bit
    • Storage Space: As much storage space as messaging system requires

NOTE: The Retain system requires a minimum of 10 GB of free disk space or it will enter maintenance mode. Retain will send warning messages when there is less than 20 GB free space for the storage, index, and system. Messaging systems will have storage space requirements far exceeding the minimum and Administrators should look to the ‘Estimating Storage Requirements’ for minimum storage space estimation instructions.

  • RAM: Memory needs will vary depending on the load and use of the Retain system, however, Java will automatically tune for the memory which is available on the server. Tuning depends on what is selected for installation. The installation will detect the amount of ram and automatically assign memory values as shown:
    • Less than 16 GB system memory:
      • 8 GB: Server and Worker
      • 6 GB: Server only
    • Less than 20 GB system memory:
      • 12 GB: Server and Worker
      • 10 GB: Server only
    • More than 20 GB system memory:
      • 16 GB: Server and Worker
      • 14 GB: Server only
  • In all cases where only the Worker is installed, the memory is tuned to 3 GB.

Single Server

  • Retain Server, Retain Worker, Database, and Index engine housed on same machine and archiving less than 500 active mailboxes. The Retain Message Router should be installed on dedicated server in the DMZ.
  • 16-24 GB RAM

Remote Database

  • Dedicated Index server*, Dedicated Database server, Dedicated Retain Server
    • 50,000 Active mailboxes
    • 16+ GB RAM for Retain Server (depending on environment)
    • Database on appropriate server
    • Retain Worker is installed remotely on each post office in the message system
  • 500-5,000 active mailboxes:
    • 12-16 GB RAM
  • 5,000-30,000 active mailboxes:
    • 16-32 GB RAM
  • Disk space is dependent on the amount of email being archived and length of retention time. It is recom­mended to estimate two years of storage and adding additional space as needed. Storage speed is a determining factor for performance. SAN and local storage preferred. NAS is not supported.

Supported Linux Versions

  • SUSE Linux Enterprise Server 15 (64-bit)
  • SUSE Linux Enterprise Server 12 SP3 (64-bit)
  • SUSE Linux Enterprise Server 12 SP2 (64-bit)
  • SUSE Linux Enterprise Server 12 SP1 (64-bit)
  • SUSE Linux Enterprise Server 12 (64-bit)
  • SUSE Linux Enterprise Server 11 (64-bit)
  • Open Enterprise Server 11, 2015, and 2018 (64-bit)

NOTE: The Retain system requires more than space. Due to the storage of many small files, especially on systems archiving mobile message data, sufficient iNodes are also an issue. SLES 11 changed the way the EXT3 file system defaults, and unless modifications are made, the EXT3 file system on SLES 11 will become insufficient for large storage systems. For information on the limitations and how to fix it, see How to setup an EXT3 partition with more iNodes. If a substitute file system is desired, the XFS file system is flexible enough to mitigate the risk.

Supported Windows Versions

  • MS Windows 2016
  • MS Windows 2012 R2 64-bit
  • MS Windows 2012 64-bit
  • MS Windows 2008 (R2) 64-bit
  • PowerShell 3.0 or higher

Supported SQL Database Servers

  • MySQL 5.6x or 5.7x
  • Oracle 10/11g/12c
  • MS SQL Server 2008 R2, 2012, 2014. 2016
  • PostgreSQL 9
  • MariaDB 10.x

Ports In Use

  • Retain utilizes many ports to facilitate communication between the different components and for com­munication with the different archived systems. By default, Retain will use the ports listed below for the services listed below.

Retain Server

  • The Retain Server is the key component in the Retain system. Other Retain processes communicate with the Server through port 48080 by default. The Server is always listening on that port regardless of how other components might be configured to communicate with it (i.e., SSL port 443).
  • 48080 (TCP) Requires incoming access if any Retain processes are running on a server external to the server hosting the Retain Server.
  • The Server Requires outgoing access if the Reporting & Monitoring Server component has been installed on a server external the server hosting the Retain Server. See also the Reporting & Mon­itoring component in this article.
  • 48009 (TCP) The AJP (Apache JServ Protocol) port is used by for communication between the web server and Tomcat. Since both should reside on the same server, there are no external port access requirements. 80 / 443 (TCP–HTTP / HTTPS) Requires incoming access to reach the Server web interface.
  • 80 / 443 (TCP - HTTP/HTTPS) Requires incoming access to reach the Server web interface.
  • 25 (TCP) Requires outgoing access so that the Retain Server can send email notifications on server errors, job statuses, and job errors. Outgoing access to Database Management System (DBMS) port. This depends on the database system you are using. See the “Database Manage­ment Systems” section of this page.
  • Other ports will also need to be opened on the server hosting the Retain Server depending on the mod­ules being used.

Retain Worker

  • The Retain Worker is the component that pulls the data from the messaging source, whether that be an email system, social media application, or mobile device.
  • 48080 (TCP) Requires outgoing access if on a server external to the Retain Server.
  • 80 or 443 (TCP HTTP or HTTPS) Requires incoming access to reach the Worker web interface.
  • Other ports will also need to be opened on the server hosting the Retain Worker depending on the mod­ules being used; and, in some cases, on servers hosting the messaging system Retain will be archiving.

Retain Message Router

  • The Message Router is for customers of the Retain for Mobile module. The Message Router connects with mobile devices to handle SMS message log forwarding, BBMP device configuration. It typically would sit inside a DMZ.
  • 443 (TCP) Requires both incoming from and outgoing access to the Internet as well as incoming from and outgoing access to the Retain Server.
  • 111/2049 (UDP / TCP) for NFS Client services. (Only required if not using REST) Requires outgoing access if the Worker is not on the Message Router server so that it can place the logs on the Worker's server. Samba can be used, but NFS seems to be more reliable.

Other ports may need to be considered for NFS to work properly.

  • It is up to the customer to do this research to get NFS services to work properly.

Retain Reporting and Monitoring Server

  • New to Retain v3.4, this process provides archive job and server reporting and monitoring services. It is not installed by default unless specifically selected during the installation process.
  • 48080 (TCP) Requires both incoming and outgoing access if on a server external to the Retain Server.
  • 80 / 443 (TCP) Requires Incoming access to reach the R&M Server's web interface.
  • 25 (TCP) If running on a server external to the Retain Server, then it requires outgoing access.

Retain Stubbing Server

  • The Retain Stubbing Server is the component that provides stubbing services to the Retain Server. It is rarely used or installed by customers. See the Administration and Users Guide for a listing of its advan­tages and disadvantages.
  • 48080 (TCP) Requires outgoing access if on a server external to the Retain Server
  • 80 / 443 (TCP) Requires incoming access to reach the Stubbing Server web interface.

Database Management Systems

The following are the default ports these database management systems use, but they are configurable within those systems. Requires incoming access for the database server and outgoing access on the Retain Server.

  • MySQL: 3306
  • MS SQL: 1433
  • Oracle: 1521
  • Postgres: 5432

Mobile requirements

  • 80/443 (TCP) Requires both incoming and outgoing access so that the Retain Server and the Message Router can communicate device configuration information with each other. See also the Retain Message Router component in this article as well as the Mobile subsection under Retain Worker. See also the Retain Message Router component in this article.
  • 111/2049 (UDP/TCP) for NFS Server services Requires incoming access if the Worker is not on the Message Router server so that the Message Router can place the logs on the Worker's server. Samba can be used, but NFS seems to be more reliable.
  • Other ports may need to be considered for NFS to work properly.
  • It is up to the customer to do this research to get NFS services to work properly.

CellTrust Secureline

  • CellTrust Gateway 4.2.0 +
  • 111/2049 (UDP/TCP) on the CellTrust Secureline server for NFS Server services.
  • Requires incoming access if the Worker is not on the CellTrust Secureline server so that it can retrieve the CSV logs. Samba can be used, but NFS seems to be more reliable.
  • Other ports may need to be considered for NFS to work properly.
  • It is up to the customer to do this research to get NFS services to work properly.

RetainService app Android Requirements

  • Lollipop (5.0) or higher

BlackBerry requirements

  • BES 5.04, 10, 10.2, 12, 12.2
  • BBM Enterprise

Supported browsers

  • Internet Explorer 10+ (NOTE: Retain’s support of IE 10 will be limited after Microsoft ends support for IE 10 on January 12, 2016)
  • Firefox 34+
  • Chrome 39+
release-rel-2019-8-1-2404 | Tue Aug 6 19:30:17 PDT 2019
2404
release/rel-2019-8-1-2404
Tue Aug 6 19:30:17 PDT 2019