Ajcody-Notes-Archive-Discovery-Mailstore-Setup: Difference between revisions
No edit summary |
|||
Line 47: | Line 47: | ||
* Installing: zimbra-core zimbra-store zimbra-apache zimbra-spell | * Installing: zimbra-core zimbra-store zimbra-apache zimbra-spell | ||
===Modify Configuration=== | ====Modify Configuration==== | ||
Press Enter to modify the system. The selected packages are installed on the server. | Press Enter to modify the system. The selected packages are installed on the server. | ||
Line 93: | Line 93: | ||
The installation of the mailbox server is complete. | The installation of the mailbox server is complete. | ||
===After Install=== | ====After Install==== | ||
Confirm server status | Confirm server status |
Revision as of 07:22, 18 July 2008
Issues That Have Caused Confusion
zimbra-archive (the package/rpm you see from the installer) should be installed on all mailstores which you want to use for cross mailbox search. This also sets the zimbraComponentAvailable archiving config attribute which allows the mta(s) to turn on archiving. zimbra-archive is not installed directly on the mta, it's just enabled.
You install zimbra-archive on a mailbox server but the service runs on the mta node.
If you add zimbra-archiving to an existing install you need to install it on one or more mailbox servers and then set zimbraServiceInstalled archiving and zimbraServiceEnabled archiving on all the mta nodes.
zmprov ms mta.example.com +zimbraServiceInstalled archiving +zimbraServiceEnabled archiving
The How-To
Reference Documents
http://www.zimbra.com/docs/ne/latest/multi_server_install/multi-server_install.5.1.html
http://www.zimbra.com/docs/ne/latest/administration_guide/Archiving.14.1.html
Assumptions
This install how-to assumes you have an existing LDAP/Mailstore/MTA server(s) for your normal production environment, the Zimbra license and logger are installed on the primary ZCS server(s), and that you are NOT running the proxy module.
Example archive mailstore hostname is : archive.example.com
Example primary ZCS hostname is : mail.example.com
Preliminary Items
Things to do or check before install:
- DNS entry for new mailstore and primary ZCS server(s) can resolve to it.
- DNS configured properly on mailstore server.
- Master Root LDAP Server mail.example.com
- Master Root LDAP Password
- On LDAP server do : su – zimbra ; zmlocalconfig –s ldap_root_password
- Master LDAP port – default is 389
- SMTP Server
Installation Of New Mailstore That Will Have A&D
Install Modules
- Type y to install the zimbra-store, zimbra-archiving and zimbra-spell (optional) packages.
- Do Not Install MTA! These Instructions Do Not Take That Into Account.
- When zimbra-spell is installed the zimbra-apache package is also installed.
- Installing: zimbra-core zimbra-store zimbra-apache zimbra-spell
Modify Configuration
Press Enter to modify the system. The selected packages are installed on the server.
At this point the Main menu displays the default entries for the Zimbra component you are installing.
To expand the menu to see the configuration values type x and press Enter.
To navigate the Main menu, select the menu item to change. You can modify any of the defaults.
- Common Configuration
- LDAP
- Ldap master host: [set this to the FQDN of your LDAP server]
- Ldap port: 389 [set this if your LDAP server isn’t using default]
- Ldap Admin password: [this is your LDAP servers Root LDAP password]
- On LDAP server do : su – zimbra ; zmlocalconfig –s ldap_root_password
- TimeZone: [set this]
- LDAP
- For zimbra-store
- Set the Admin Password
- +License filename: UNSET [if you see this, then something is wrong with your
- LDAP configuration. It should of pulled the license info from the LDAP server.
- Set the SMTP host
- Set the Admin Password
Type r to return to the Main menu, if you aren’t there already.
When the mailbox server is configured, return to the Main menu and type a to apply the configuration changes.
Press Enter to save the configuration data.
When Save Configuration data to a file appears, press Enter.
The next request is where to save the files. To accept the default, press Enter.
To save the files to another directory, enter the directory and then press Enter.
When “The system will be modified - continue?” appears type y and press Enter.
The server is modified.
Installing all the components and configuring the server can take a few minutes.
When Installation complete - press return to exit displays, press Enter.
The installation of the mailbox server is complete.
After Install
Confirm server status
su – zimbra ; zmcontrol status
Populate the ssh keys, on each server in your environment
su-zimbra ; zmupdateauthkeys
The key is updated on /opt/zimbra/.ssh/authorized_keys.
Upgrading A Zimbra Server For An Archive & Discovery Mailstore
This will retain your current settings for the system. Your server will experience downtime during the upgrade.
untar zcs*.tar that matches your existing system
cd zcs-version-directory ./install choose upgrade select zimbra-archiving
The upgrade of the mailbox server is complete.
Confirm server status
su – zimbra ; zmcontrol status
Note, zimbra-archiving only runs as a service on a MTA server.
Populate the ssh keys, on each server in your environment
su-zimbra ; zmupdateauthkeys
The key is updated on /opt/zimbra/.ssh/authorized_keys.
Configure The Primary ZCS Server For New Mailbox and A&D
Example mailstore hostname is : archive.example.com
- Go to your primary admin console url. [https://[example.com]:7071/zimbraAdmin]
- Confirm you see the new mailstore under Configuration > Servers
- Under Configuration > Servers > [MTA servername(s)] > Services
- [each MTA server needs this]
- You’ll see a box for Archiving and Discovery
- Check this to enable the MTA server(s) for Archiving and Discovery.
- This effectively does:
zmprov ms mta.example.com +zimbraServiceInstalled archiving +zimbraServiceEnabled archiving
- Go to Configuration > Class of Service > default [or your primary domain] > Server Pool
- You’ll want to make sure it’s limited to the correct server pools
- Your new mailstore for A&D should be unchecked.
- Click on New for a new Class of Server (COS)
- Call it archive or something similar
- Under Server Pool > Limit > have only the new mailstore checked
- You’ll want to make sure it’s limited to the correct server pools
- Go to Configuration > Class of Service > default [or your primary domain] > Server Pool
Setup Initial A&D With First Account
On LDAP server, as zimbra (su – zimbra).
format : zmarchiveconfig –s servername enable user@example.com archive-cos <cos>
example : zmarchiveconfig –s archive.example.com enable account@example.com archive-cos archive
The above command will create the mail domain for the archive accounts using the template defaults, user@example.com to make example.com.archive
Back to the admin console
- Configuration > Domains > [domainname].archive > General
- Change “Default Class of Service” to your COS [archive]
- Address > Accounts
- Change “Default Class of Service” to your COS [archive]
You should see the archive account in here now.