ZCS Connector for Outlook, 6.0.8
Previous Next


Zimbra Connector for Outlook Administrator Guide : Customizing ZCO Installation File

Customizing ZCO Installation File
When ZCO is installed, the only information needed to complete the installation is the ZCS server name and whether to use a secure connection Users can enter this information when they create the default profile during ZCO installation or you can customize the ZCO .msi file with this information and then users only need to enter their email address and the password to install ZCO.
To customize the installer to add the server name and set the secure connection option, you modify the ZmCustomizeMSI.js. file. This is a Java Script file that runs under the Windows Scripting Host. This file can be found in the Zimbra download directory on the Administration Console.
1.
Copy the ZmCustomizeMSI.js file and the ZCO .msi file to a computer running the Windows platform.
Note: The ZCO .msi file name is different from the example shown here. Please note the exact file name when you download it.
2.
Open the Windows Command Prompt and go to the directory where the ZmCustomizeMSI.js file is saved. For example, if it is saved in the temp folder on your C drive, you would type cd c:\temp.
3.
cscript ZmCustomizeMSI.js <path/msi-filename> -sn <servername.com>-sp <port> -ssl <1 | 0>//nologo
Description of command input:
ZmCustomizeMSI.js. The name of the js file.
<path/msi-filename>. Directory path and the ZCO .msi file name. Verify exact name of file.
<servername.com>. Zimbra server domain name (DNS) to be configured in the .msi file
<port>. Port number to be configured. For non-secured connections, the default is 80. For secured connection, the default is 443. Your configuration can be different.
Note: If your port number is different than the default port for your connection type, your users will need to include the port number when they provide the server name. The server should be entered in the form of example.domain.com:<port>
<1 | 0>. Whether User Secure Connection should be checked. Enter 1 for the secure connection using a HTTPS connection or enter 0 to use a HTTP connection.
Press Enter and the ZCO .msi file is modified.
Example :
cscript ZmCustomizeMSI.js ZimbraOlkConnector.msi -sn server.example.com -sp 443 -ssl 1 //nologo
4.
To verify that the modification is correct, you can run the .msi installer and create a dummy profile. The Zimbra Server Configuration Settings dialog should include the server name, server port, and the check box marked/unmarked.
 
 
Once you have checked the modified .msi file, you can deploy it to users using your group policy software, or you can save it to a directory that users can access to download the file to their computers. Users must have administrator privileges on their computer to install ZCO.
Other Items to Customize in the .msi file
You can make additional changes to the .msi file before users install ZCO to change the following functionality in ZCO:
n
Set the password rule to require users to log in every time they retrieve their email. 1 means that the encrypted password is saved in their profile (default). Users do not need to enter their password when they open ZCO. 0 means that the password is not saved. Users are prompted to enter their passwords whenever they sync to the server.
r
n
GAL sync mode. 2 to disable GAL sync. 1 to make GAL sync a manual option only. 0 for GAL syncs to occur automatically every x days. The interval is controlled by the -gsr switch below. The default is every 7 days. Note that with this option, users can also sync the GAL manually.
r
n
r
r
n
Where sync failure notifications are saved. 1 to create sync failure messages only in the sync Issues folders. 0 to create the sync failure messages in the sync issues folders and in the user’s Inbox.
r

Zimbra Connector for Outlook Administrator Guide : Customizing ZCO Installation File

Previous Next
ZCS Connector for Outlook, 6.0.8
Copyright © 2010 Zimbra Inc.