Installation, itrezzoAgent Server


Edit

1.0 Installation Prerequisites

There are several hardware, software, and Operating System requirements that must be met to complete the itrezzoAgent Server installation successfully. Before continuing, make sure that you have your Windows Operating System and Exchange Server media and their respective license keys available.

Edit

1.1 Minimum Hardware Requirements

Processor1GHz or faster Pentium processor
Memory1GB
Disk Space4GB after installation for software (400MB) and application logs
NetworkHigh Speed LAN connection to local Exchange Server
Minimum Hardware Requirements

The following Virtual Machine platforms are also supported:
Edit

1.2 Maximum Hardware Requirements

Processor2GHz or faster Pentium processor
Memory2GB
Disk Space10GB
NetworkLocal Ethernet Connection
Suggested Hardware Configuration

Edit

1.3 Microsoft Exchange Server Dependencies

These requirements are specific to the version of Microsoft Exchange you are running.

Dependency Type Exchange 2000Exchange 2003Exchange 2007Exchange 2010
Required Service Packs and HotfixesSP4SP2SP1SP1
Minimum CDO.DLL Version6.0.6556.06.5.7638.06.5.8165.06.5.8165.0
Minimum MAPI32.DLL Version6.0.6556.16.5.7638.01.0.2536.01.0.2536.0
Can Outlook be installed on the itrezzoAgent Server?NONONONO

Although it has been tested, we do not recommend installing itrezzoAgent on an Exchange Server.

If itrezzoAgent is installed on a BlackBerry Enterprise Server, coexistence is supported without any degradation of service of either application.

A standalone MAPI-CDO installation package is available from Microsoft Downloads.

Exchange Server Dependencies

Edit

1.4 Required Server-Side Permissions

The itrezzoAgent System Administrator account will require the following permissions to perform the tasks listed below:

TaskPermissions Required for Microsoft Exchange Server 5.5Permissions Required for Microsoft Exchange Server 2000/2003/2007
Administering itrezzoAgent ServerDefault Permissions on the itrezzoAgent Exchange MailboxDefault Permissions on the itrezzoAgent Exchange Mailbox
Responding to requests in e-mail attachments (Legacy Feature)User Permissions on the itrezzoAgent Exchange MailboxUser Permissions on the itrezzoAgent Exchange Mailbox
Administering Blackberry Pin Extraction (BPE)Service Account Administrator in the Site and Configuration ContainerSend As and Receive As permissions on the BESadmin Mailbox
Supporting J2ME Attachment Explorer and Print Manager (Legacy Feature)Service Account Administrator in the Site and Configuration ContainerView Only Permissions to the Administrative Groups Send As and Receive As permissions to the Administer Information Store
Running the Emergency Preparedness Software (EPS)Service Account Administrator in the Site and Configuration ContainerView Only Permissions to the Administrative Groups Send As and Receive As permissions to the Administer Information Store(AD also requires Send As Permission for 2003 2007)
Blackberry Enterprise Server (for reference)Service Account Administrator in the Site and Configuration ContainerView Only Permissions to the Administrative Groups
Required Server-Side Permissions

Additional Information concerning 5.5/2000/2003

It is important to assign the Send As permission for all user accounts in the User container of the Active Directory domain. This action will allow for permissions to be replicated from the top level of the root container in the domain down to all necessary containers.

Also, the administrator must be sure that the service account, which will be used by the itrezzoAgent server (this could be the BESAdmin account or an itrezzo specific account), is a local administrator of the box which itrezzoAgent server is to be installed on.

A detailed step by step permissions setup can be found on this page: Permissions setup for itrezzoAgent EPS


Edit

1.5 Setting Service Account Permissions for Exchange 2007

If you run the Windows PowerShell, you must first add the Exchange Management Snap-In:

[PS] add-pssnapin microsoft.exchange.management.powershell.admin

From the Exchange Server, run the Exchange 2007 PowerShell to perform the following actions:

If you are performing the command locally on the Microsoft Exchange 2007 server, type:

[PS] Add-ExchangeAdministrator "SVCitrezzo" –role ViewOnlyAdmin

[PS] add-ADpermission  -User "SVCitrezzo" -accessRights Extendedright -extendedRights Send-As, Receive-As, ms-exch-store-admin

If you are performing the command from another computer, you can prefix either of the above two commands with a method to get the exchange server and pipe the value to the desired command:

get-mailboxserver "email_server_name" |

For example:

[PS] get-mailboxserver "NY-EXCH1" | Add-ExchangeAdministrator "SVCitrezzo" –role ViewOnlyAdmin

Now, follow the additional detailed Active Directory permissions setup here: Permissions setup for itrezzoAgent EPS



Edit

1.6 Additional Application Requirements for Various itrezzoAgent Features

Application or FeatureRequirements
Attachment HandlerOffice 2000/XP/2003; itrezzo Rich Text Distiller; Static or Dynamic MAPI Profile; Windows 2000 SP3 or Higher; Microsoft Transaction Server + SP6a on Windows NT4
Attachment ExplorerOffice 2000/XP/2003; itrezzo Rich Text Distiller; Dynamic MAPI Profile; IIS (run lockdown tool before installing); Not supported on Windows NT4/2000/2003
Personality Agent LoadingMicrosoft Word XP/2003; Dynamic MAPI Profile; IIS (run lockdown tool before installing); Windows 2000 SP4 or Higher; Not Supported on Windows NT4/2003
BPP / BPEDynamic MAPI Profile; Windows 2000 SP4 or Higher; Windows 2003
EPSDynamic MAPI Profile; Windows 2000 SP4 or Higher; Windows 2003
Self Servicec UpdateStatic or Dynamic MAPI Profile; IIS (run lockdown tool before installing); .NET Framework Version 1.1 is required for Windows 2000; Windows 2003; Windows 2000 SP4 or Higher
Additional Application Requirements

Install Microsoft Exchange Server 2003 System Manager or Microsoft Exchange Server MAPI Client and Collaboration Data Objects. Both do not need to be installed by the administrator.

Edit

2.0 Download

Via FTP

Via HTTP



Edit

3.0 Installation Steps

After establishing that the server has met the installation requirements and software dependencies, and the designated account and mailbox have the proper permissions follow these steps to install itrezzoAgent Server.

  1. Login to the server which itrezzo will be installed on using the account which has been specified as the itrezzo service account.
  2. Prepare the machine for installation.
    • Verify that there is internet connectivity to this machine by browsing to any web site with Internet Explorer.
  3. Install itrezzoAgent Enterprise Server.
    • If you have not already done so, download the installer (.exe) using information above in the download section
    • Double click on the installer file to begin the installation process.
    • Click Next when prompted to by the installer.
  4. Accept the License Agreement and choose Next.
  5. Specify the install directory or choose the default installation location and click Next.
  6. Choose the features you would like to install and click Next. Specific details and configuration for these services are contained in the full Installation Manual. If IIS is not present, the Self-Service Update and MAME will not appear as available choices on this menu.
  7. The itrezzoAgent installer will prompt you to specify a user account to be used by the itrezzoAgent service. Please enter the logon credentials of the itrezzoAgent Administrator account you created for itrezzo usage. Be careful to enter the credentials correctly here because if they are incorrect, the application will fail to start as a service. Click Next.
  8. Once the software installation is complete, make sure the checkbox next to Configure itrezzoAgent now is checked and click Finish.
  9. When the Configuration Wizard starts, you will see the Exchange Mailbox information linked to the Administrator account you were prompted for during the installation (above). If the account alias and exchange server name are not there or not underlined, click the select button to choose the correct account from the Global Address List. Once the mailbox has been recognized click Next.
  10. On the Primary Contact screen, please fill out all of the requested information of the individual who will be responsible for communicating with itrezzo for technical support. This account will also initially receive the licenses sent by itrezzo. Click Next to continue.
  11. When prompted to request an Authorization code, click the Get button. Once a license code has been obtained from the itrezzo servers click Next.
  12. Click the checkbox next to Start the itrezzoAgent service now box to initialize the itrezzoAgent server. If you would like to request trial licenses for additional itrezzoAgent services, click the checkboxes next to their names as well. When you click Finish, the service will start up, and email will be sent to itrezzo support with the request for trial licenses (if applicable).

Edit

3.1 Additional Support

A document which may provide additional support for this process can be found here.

Edit

3.2 Release Notes

For the latest release notes and change list for specific versions, consult this list: