WEB2CS INSTALLATION GUIDE FOR PARALLELS / POA HTTP://WWW.XANDMAIL.COM XandMail 32, rue de Cambrai 75019 PARIS - FRANCE Tel : +33 (0)1 40 388 700 - http://www.xandmail.com
TABLE OF CONTENTS 1. INSTALLING WEB2CS 4 1.1. IMPORT THE APPLICATION PACKAGE 4 1.2. CREATE THE XANDMAILWEB2CS RESOURCE TYPE 6 1.3. CREATE THE XANDMAILWEB2CS V4 SITE RESOURCE TYPE 11 1.4. CREATE A SERVICE TEMPLATE 14 1.5. CREATE THE CUSTOMER WHO WILL MANAGE THE WEB2CS INSTALLATION 18 1.6. SUBSCRIBE THE CUSTOMER TO THE WEB2CS SERVICE TEMPLATE 20 1.7. ADD A NEW DOMAIN FOR CUSTOMER XANDMAIL, USING SUBSCRIPTION WEB2CS 22 1.8. CONNECT TO XANDMAIL STAFF USER CONTROL PANEL 24 1.9. ADD A SUBDOMAIN TO HOST THE APPLICATION 25 1.10. PROVISION XANDMAILWEB2CS V4 FOR POA 26 1.11. CREATE A NEW SERVICE USER POSTMASTER@DOMAIN.COM 29 1.12. CHECK THE POSTMASTER WEBMAIL ACCOUNT 32 1.13. CONFIGURE THE APACHE SERVER 34 2. MANAGING MULTIPLE DOMAINS ON THE SAME INSTALLATION 38 2.1. PRESENTATION 38 2.1.1. ONE INSTALLATION FOR SEVERAL DOMAINS, EACH WITH ITS OWN LEVEL OF FEATURES 38 2.1.2. ONE INSTALLATION FOR SEVERAL DOMAINS, ALL WITH THE SAME LEVEL OF FEATURES 39 2.2. ADD A NEW DOMAIN FOR CUSTOMER XANDMAIL, USING SUBSCRIPTION WEB2CS 40 2.3. CONNECT TO XANDMAIL STAFF CUSTOMER CONTROL PANEL 42 2.4. ADD A SUBDOMAIN TO HOST THE APPLICATION 42 2.5. LINK THIS SUBDOMAIN TO THE WEB2CS INSTALLATION 44 2.6. RESTART THE APACHE SERVER 45 2.7. ACCESS THE WEB2CS LOGIN PAGE FOR DOMAIN1.NET 46 2.8. CREATE THE MAILBOXES FOR DOMAIN1.NET 47 2.9. LOGIN TO XMAIL.DOMAIN1.NET AS POSTMASTER 50 2.10. REMOVING A DOMAIN ALIAS FROM THE INSTALLATION 51 2.11. MAKING A BACKUP OF THE DOMAIN SPECIFIC DATA 51 3. USING THE WEB2CS APPLICATION 52 3.1. ACCESS THE ADMINISTRATION INTERFACE 52 3.2. HIDE THE INSTALLATION INSTRUCTIONS PAGE 53 2
3.3. ACCESS THE MAIN INTERFACE 54 3.3.1. DISPLAY THE LOGIN PAGE 54 3.3.2. CHANGE THE APPLICATION COLORS AND LOGO 55 3.3.2.1. Upload a logo 57 3.3.2.2. Change the background color 59 3.3.2.3. Is the customization valid for all domains? 60 3.3.3. APPLICATION CAPABILITIES: LIMITED OR NOT? 61 3.3.4. INSTALL AN UPGRADE LICENSE 63 3.3.5. IS THE LICENSE VALID FOR ALL DOMAINS? 65 3.3.6. CHANGE THE RSS FEED 66 3.3.6.1. Is the RSS feed valid for all domains? 66 3.4. TROUBLESHOOTING 67 3.4.1. UPGRADING XANDMAILWEB2CS 67 3.4.2. LOGIN DOES NOT WORK ON A 64 BITS SERVER 68 4. UNINSTALLING WEB2CS 69 4.1. UNINSTALLING A WEB2CS INSTANCE 69 4.2. REMOVING WEB2CS FROM THE SERVER 69 3
1. INSTALLING WEB2CS The Web2cs application has been packaged for installation on servers managed with Parallel s Automation (POA). 1.1. IMPORT THE APPLICATION PACKAGE Go to Service Director» Applications Manager» APS Catalog. Search for xand* applications. XandMail Web2cs V4 for POA should be listed. Click on the XandMail Web2cs V4 for POA link. Click Import Package. Or, if you have the package available in the form of a download URL, you can: Go to Service Director» Applications Manager» Applications. Click Import Package. Provide the Download package from URL. Click Submit. Go to System Director» Task Manager. 4
Check the list of current scheduled tasks until the package is finished uploading. Go to Service Director» Applications Manager» Applications and check that it is added to the Applications List by searching for an application named xand*. 5
1.2. CREATE THE XANDMAILWEB2CS RESOURCE TYPE Go to Service Director» Provisioning Manager» Resource Types. Click on Add a New Resource Type. Search for Application as the base resource class. Click on the Application link. Define XandMailWeb2cs as the name. Leave the description empty. Click Next. 6
Search for the xand*application. XandMail Web2cs V4 for POA should be listed. Click on the XandMail Web2cs V4 for POA link. If you wish, you can change the default preferences for the application services. Default language Default timezone Administrator account name Domain alias prompt Click Next. 7
In the Additional parameters, choose the following parameters: Check Provision application on account's domain Check Provision application on vendor's domain Choose a Base domain Define the Access URL template as http://xmail.{company name}.{base domain} Uncheck Auto host domains Uncheck Automatically provision application Uncheck Prohibit service users with custom UPN Uncheck Prohibit application instance deinstallation Choose SSL enabled, HTTP entry points for the SSL protection Uncheck Allow account's SSL certificate Uncheck Mandatory for service user Check Show application in navigation menu Uncheck Embed application user interface Leave empty Custom application name or localization key Leave empty Custom application description or localization key Leave empty Custom application icon Click Next. 8
Do not choose any provisioning attributes. Click Next. 9
Check the chosen parameters and click Finish. 10
1.3. CREATE THE XANDMAILWEB2CS V4 SITE RESOURCE TYPE Go to Service Director» Provisioning Manager» Resource Types. Click on Add a New Resource Type. Search for Site Applications as the base resource class. Click on the Site Applications link. Define XandMailWeb2cs V4 Site as the name. Leave the description empty. Click Next. Search for the xand*application. XandMail Web2cs V4 for POA should be listed. Click on the XandMail Web2cs V4 for POA link. 11
If you wish, you can change the default preferences for the application services. Default language Default timezone Administrator account name Domain alias prompt Click Next. Select No for Allow enabling of user permissions for web application folders. Select No for Allow upgrades of web application with user permissions enabled. Click Next. Do not choose any provisioning attributes. Click Next. 12
Check the chosen parameters and click Finish. 13
1.4. CREATE A SERVICE TEMPLATE Go to Service Director» Provisioning Manager» Service Templates. Click Add New Service Template. Name the service template web2cs. Leave the description empty. Check Autoprovisioning. Choose Custom type. Click Next. Check the following resources to be added to the service template: DNS Hosting RT, FTP access, Physical hosting (Apache), QMail Hosting, Traffic, DiskSpace, Additional Staff Members, File Manager, IP addresses, XandMailWeb2cs, XandMailWeb2cs V4 site Click Next. 14
Choose the limits for each resource or check Unlimited. Click Next. 15
Check the chosen parameters and click Finish. 16
Search for the newly created service template. Click on web2cs. Click Activate. Click Parameters. Check and edit the service parameters. If both PHP4 and PHP5 are available on your servers, set Default PHP4 mode for webspaces under Physical hosting (Apache) to Off in order to use PHP5. 17
1.5. CREATE THE CUSTOMER WHO WILL MANAGE THE WEB2CS INSTALLATION Go to Operations Director» Customer Manager» Customers. Click Add New Customer. Name the company (hereafter, the customer will be called xandmail ). Fill in the required information. Click Next. Fill in the Administrative Contact information. Click Next. 18
Define a Login and Password in System info. Fill in the Personal information. Click Finish. 19
1.6. SUBSCRIBE THE CUSTOMER TO THE WEB2CS SERVICE TEMPLATE Go to Operations Director» Customer Manager» Customers. Search for the xandmail customer which was just created. Click on its name. Click Subscriptions. Click Create New Subscription. Search for the web2cs service template (hint: sort by name in reverse order it should then be listed among the first) Click on the web2cs link. Check the resource limits for the new subscription. You can eventually modify the default values of the service template. Click Next. 20
Check the chosen parameters and click Finish. 21
1.7. ADD A NEW DOMAIN FOR CUSTOMER XANDMAIL, USING SUBSCRIPTION WEB2CS Go to Operations Director» Customer Manager» Customers. Search for the xandmail customer which was just created. Click on its name. Click Resources. Click Add New domain. Input the Domain Name. We will thereafter call it domain.com. Check Set Registrar Status to Ready. Choose the web2cs subscription. Click Next. 22
Check that DNS Hosting is set to DNS Hosting RT. Check that Allow DNS management is checked. Check that Web Hosting is set to Apache Website if this domain will host a website in addition to the Web2cs application. Otherwise, set it to None. Check that Mail Hosting is set to QMail (Automatic). Click Next. Check the chosen parameters and click Finish. 23
1.8. CONNECT TO XANDMAIL STAFF USER CONTROL PANEL Go to Operations Director» Customer Manager» Customers. Search for the xandmail customer which was just created. Click on its name. Click on General. Click on Staff members. Click on Login as Customer. 24
1.9. ADD A SUBDOMAIN TO HOST THE APPLICATION In the Customer Control Panel, click on Sites & Domains. Click on Add New Subdomain. Input xmail as the subdomain name, so that the subdomain will be xmail.domain.com. Select None for the web hosting. Click Next. Check the chosen parameters and click Finish. 25
1.10. PROVISION XANDMAILWEB2CS V4 FOR POA In the Customer Control Panel, click on Hosting. Click on XandMailWeb2cs V4 for POA. The Status is not activated. Click on Create. Choose xmail.domain.com as the Installation domain. In the General preferences, choose the default language and timezone. Keep postmaster as the administrator account name, unless you wish to use another mailbox name (in this case, you will need to create the service user accordingly in the next step). Note: If you will be hosting and managing in a single installation several domains (see the domain management section below), remember that you will have to create a mailbox with this administrator email address for each managed domain. In the Mail preferences, if your mailboxes already have specific system folder names for Draft, Sent, Trash and Spam folders, input them so that Web2cs will use them instead of creating different ones. Input the IMAP host and port. Indicate if the login names are full POP3/IMAP4 mail account names or not. Note that to be able to use this installation in multi-domains mode, you will need to use full POP3/IMAP4 mail account names. Input the SMTP host and port. 26
Click Next. 27
Check the chosen parameters and click Finish. 28
1.11. CREATE A NEW SERVICE USER POSTMASTER@DOMAIN.COM In the Customer Control Panel, click on Hosting. Click on Add New Service User. Input Postmaster as the Display name. Input postmaster as the login and choose to login in the existing domain domain.com. Input the password of your choice, and confirm it. Check the E-mail service. Check XandMailWeb2cs V4 for POA service. Choose the language. Click Next. Leave the email address as proposed: postmaster@domain.com. Check Show in Global Address Book. Check Enable virus checking. Check Create storage. Check Storage enabled. Choose the quota of this mailbox. Choose whether or not to enable mail forwarding. Choose whether or not to send notification. Choose whether or not to send a test message to the new Email address. 29
Click Next. 30
Check the chosen parameters and click Finish. 31
1.12. CHECK THE POSTMASTER WEBMAIL ACCOUNT In the Customer Control Panel, click on Hosting. Click on XandMailWeb2cs V4 for POA. Click on Webmail Accounts. The postmaster@domain.com address should be listed. Click on the Open Entry Point link. The login page is displayed in a new tab. Login to the postmaster@domain.com account. If the login works fine, send a message to yourself to check that the messaging operations are also working. The message should appear in your Inbox. 32
Log out. 33
1.13. CONFIGURE THE APACHE SERVER It is best to prevent users from accessing and breaking your application or your server. So even if login works immediately, we strongly recommend adding the security configuration to the Apache server. This configuration is also mandatory to manage Web2cs for multiple domains. Read the instructions on how to configure the Apache server on the login page. Do not close this window, as you will come back to it to copy the path to vhost.conf that is indicated there. In the Main control Panel, click on Service director. Click on Application Manager. Click on Applications. Search for xand*. The XandMailWeb2cs V4 for POA application should be listed. Click on XandMailWeb2cs V4 for POA. Click on Instances. An instance should be listed for domain xmail.domain.com. Note the Webspace ID and the Hardware Host name on which Web2cs is installed. Click on Service Director. Click on Shared Hosting Manager. Click on Websites. Search for the Webspace ID of the Web2cs installation. 34
Note the corresponding Webspace Name. Click on Deployment Director. Click on Server Manager. Click on Hardware Nodes. Click on the Hardware Host name on which Web2cs is installed. Click on Applications. Click on Apache. Click on Customer services includes. Search for the Webspace Name you noted in the Domain service name field. 35
Click on the left-most action icon to edit the Apache configuration. Switch windows back to the Web2cs login page. Copy the full path to vhost.conf that is indicated there. Switch windows back to the main Control Panel. In the Manual editing input field, type Include and paste the full path to vhost.conf. The complete line should look like this: Include /usr/local/pem/vhosts/101222/webspace/siteapps/8227/htdocs/vhost.conf Click Submit. Click on Summary. 36
Click Restart. 37
2. MANAGING MULTIPLE DOMAINS ON THE SAME INSTALLATION 2.1. PRESENTATION 2.1.1. ONE INSTALLATION FOR SEVERAL DOMAINS, EACH WITH ITS OWN LEVEL OF FEATURES It is possible to use a single installation to manage several domains. In this type of installation, you install the application only once, for the first domain. Each subsequent domain can be added / removed through the Web2cs instances for domain aliases service available in the XandMAilWeb2cs V4 for POA application management page on your Customer Control Panel. Each domain needs its own license to enable the features required for that domain, but disk space is used sparingly as only the domain specific files are separated for each domain: 38
2.1.2. ONE INSTALLATION FOR SEVERAL DOMAINS, ALL WITH THE SAME LEVEL OF FEATURES It is possible to use a single installation to manage several domains. In this type of installation, you install the application only once, for the first domain. Each subsequent domain can be added / removed through the Web2cs instances for domain aliases service available in the XandMAilWeb2cs V4 for POA application management page on your Customer Control Panel. A global license is installed to enable a set of features which will be available to all the domains managed by that installation. Only the domain specific files are separated for each domain: 39
2.2. ADD A NEW DOMAIN FOR CUSTOMER XANDMAIL, USING SUBSCRIPTION WEB2CS The installation of the Web2CS application is made on the primary domain. This can be a valid domain managed by one of your customers, or it can be restricted to your own use as the server administrator. We recommend this second solution, as it will prevent your customer from putting in peril (voluntarily or by mistake) the Web2CS application used by other domains than his own. In order for each domain to have his private access to Web2CS, you will have to create a domain alias pointing to the primary Web2CS domain for each of the customer domains. For example, you have installed on xmail.domain.com. Your first customer purchases domain1.net from you. You will create the domain called domain1.net to host his website and a subdomain called xmail.domain1.net (or any other name that you fancy) to be the web2cs entry point. You will provide this xmail.domain1.net subdomain to the Web2CS service as a domain alias. In the main Control Panel, go to Operations Director» Customer Manager» Customers. Search for the xandmail customer. Click on its name. Click Resources. Click Add New domain. Input the Domain Name. We will thereafter call it domain1.net. Check Set Registrar Status to Ready. The web2cs subscription is selected by default. 40
Click Next. Check that DNS Hosting is set to DNS Hosting RT. Check that Allow DNS management is checked. Check that Web Hosting is set to Apache Website if this domain will host a website in addition to the Web2cs application. Otherwise, set it to None. Check that Mail Hosting is set to QMail (Automatic). Click Next. Check the chosen parameters and click Finish. 41
2.3. CONNECT TO XANDMAIL STAFF CUSTOMER CONTROL PANEL Go to Operations Director» Customer Manager» Customers. Search for the xandmail customer which was just created. Click on its name. Click on General. Click on Staff members. Click on Login as Customer. 2.4. ADD A SUBDOMAIN TO HOST THE APPLICATION In the Customer Control Panel, click on Sites & Domains. Click on Add New Subdomain. Input xmail as the subdomain name, so that the subdomain will be xmail.domain1.net. Select None for the web hosting. Select Qmail for the Mail hosting. Select web2cs for the Subscription. 42
Click Next. Check the chosen parameters and click Finish. 43
2.5. LINK THIS SUBDOMAIN TO THE WEB2CS INSTALLATION In the Customer Control Panel, click on Hosting. Click on XandMailWeb2cs V4 for POA. Click on Web2CS instances for domain aliases. Click New. Input xmail.domain1.net as the domain alias. Click Next. Check the chosen parameters and click Finish. 44
2.6. RESTART THE APACHE SERVER In the main Control Panel, click on Deployment Director. Click on Server Manager. Click on Hardware Nodes. Click on the Hardware Host name on which Web2cs is installed. Click on Applications. Click on Apache. Click Restart. 45
2.7. ACCESS THE WEB2CS LOGIN PAGE FOR DOMAIN1.NET In the Customer Control Panel, click on the Open entry Point link for xmail.domain1.net. The Web2cs login page should be displayed. 46
2.8. CREATE THE MAILBOXES FOR DOMAIN1.NET In the Customer Control Panel, click on E-mail. Click on Mailboxes. Click on Add New Mailbox. Input Postmaster as the Display name. Input postmaster as the login and choose to login in the existing domain domain1.net. Input the password of your choice, and confirm it. Click Next. Leave the email address as proposed: postmaster@domain1.net. Check Show in Global Address Book. Check Enable virus checking. Check Create storage. Check Storage enabled. Choose the quota of this mailbox. Choose whether or not to enable mail forwarding. Choose whether or not to send notification. Choose whether or not to send a test message to the new Email address. 47
Click Next. Choose XandMailWeb2cs V4 for POA as the application to use for the web mail access. Click Next. 48
Check the chosen parameters and click Finish. Create in the same way mailboxes for all the users of every domain of this Web2cs service. 49
2.9. LOGIN TO XMAIL.DOMAIN1.NET AS POSTMASTER Switch to the already opened window showing the Web2cs login page for xmail.domain1.net. Input postmaster@domain1.net as the login name. Input the password. Choose your preferred language. Click Login. If the login works fine, send a message to yourself to check that the messaging operations are also working. The message should appear in your Inbox. 50
2.10. REMOVING A DOMAIN ALIAS FROM THE INSTALLATION Removing a domain alias from the installation will delete the entire user data associated to that domain alias. In the Customer Control Panel, click on Hosting. Click on XandMailWeb2cs V4 for POA. Click on Web2CS instances for domain aliases. Select the domain alias to delete. Click Remove. 2.11. MAKING A BACKUP OF THE DOMAIN SPECIFIC DATA To backup all the domain specific data of your web2cs installation, simply backup the domains directory. 51
3. USING THE WEB2CS APPLICATION 3.1. ACCESS THE ADMINISTRATION INTERFACE The application administrator defined during the installation process ( postmaster by default) has access to the administration interface, using his login and password. The URL of that administration interface is indicated in this installation instructions page, but will no longer be available in the user interface once the installation instructions page is hidden (which is the next step). If you forget it, however, it will still be indicated in the installation.log file located in the root directory of the installed application. The URL is [application installation URL]/admin/index.html. In this administration interface, you will be able to: Replace the XandMail logo with your own logo Change the background color of the application Change the newsfeed URL to provide your own information to your users Manage the application s license The pages available in the administration interface are also accessible to the administrator in the Web2cs main interface. When you are through with your administrator configuration, clicking on the Web2.0 Communication Solution link on the login page will get you directly to the Web2cs login page. 52
3.2. HIDE THE INSTALLATION INSTRUCTIONS PAGE Once the login works and you have added the security configuration parameters to the vhost.conf file, you can hide the installation instructions page by clicking on the When the login works correctly, click here to hide these instructions. link. Hiding the installations instructions page will display in its place the normal login page. 53
3.3. ACCESS THE MAIN INTERFACE 3.3.1. DISPLAY THE LOGIN PAGE Type the installation URL in your favorite browser. Type an email address and password that exist on your server and click on Login to use the application. 54
3.3.2. CHANGE THE APPLICATION COLORS AND LOGO In order to change the application colors and logo, you must login either to the Web2cs or its administrator interface using the administrator account ( postmaster @[the domain name] by default). In the application menu (located on the left), click on Administration. You will see the access points to the three administration pages: License Management Customization Manage RSS feed 55
Click on Customization You can in this page: Upload a logo Change the background color of the interface 56
3.3.2.1. UPLOAD A LOGO The format of the image for the logo must be in png format (.png extension) and not exceed the size of 100 KB. You can replace the logo for: the Web login page the Web interface (Web2cs and HTML) Mobile interface You have to respect the following rules: The name for the Web login page logo must be "logo_big.png" The name for the Web interface logo must be "logo_small.png" and the dimension should be less than 80x250 pixels The name for the mobile interface logo must be "logo_mobile.png" and the dimension should be less than 46x150 pixels Start by uploading the logo for the Web interface (logo_small.png) as it will immediately appear at the top of the page. 57
If the new logo does not immediately appear, finish uploading the other logo files, then logout, empty the cache of your browser and re-login. In the same way, upload then the Web login page logo and the Mobile interface logo. To see the Web login page s new logo, you will need to logout, empty your browser cache and reload the login page. To see the Mobile interface logo, you will need to connect with a Mobile phone. 58
3.3.2.2. CHANGE THE BACKGROUND COLOR In the customization administration page, you can also change the background color of the application to better match your company colors. You can either clear on the pre-defined colored squares (pink, yellow, green, blue, grey) or you can specify your own color using the standard hexadecimal color format: #RRGGBB (RR = red, GG = green, BB = blue each of the 3 colors can take hexadecimal values between 00 and FF). If you specify your own color, click on the Preview link to see the result: Once you are happy with the chosen color, do not forget to click on the Save button 59
3.3.2.3. IS THE CUSTOMIZATION VALID FOR ALL DOMAINS? Each postmaster@[domain] account has access to the customization menu and can change the logos and background colors of his own domain. Here is an example: 60
3.3.3. APPLICATION CAPABILITIES: LIMITED OR NOT? The free basic version of the application is limited to using the messaging functions together with the address book. But the Web2cs application is capable of much more which, as service administrator, you might think about providing to your users. Thus the administrator account can see the full set of modules and options in the menus. Each of these modules or options can be enabled with a specific license, without having to reinstall the application. When you browse through a disabled module in the menu, a popup will indicate it and provide at the same time links to more information and pricing on that module. 61
Of course, a regular (non-administrator) user will not see those modules in the menu as long as they are disabled. So the application capabilities are limited in the free basic pack, but can easily be augmented by purchasing an upgrade license. 62
3.3.4. INSTALL AN UPGRADE LICENSE In order to install an upgrade license, you must login either to the Web2cs or its administrator interface using the administrator account ( postmaster by default). In the application menu (located on the left), click on Administration. You will see the access points to the three administration pages: License Management Customization Manage RSS feed Click on License Management. In this page, you can see which type of license you have purchased (Free basic license by default), the numbers of users available, which products are being used and when the license will expire. 63
When you receive an upgrade license, simply come to this page, click on the Upload a license file button and choose the part00.dat file you received after your purchase. A popup will list the content of the new license, waiting for your confirmation to apply the new license file. Once you click on the Apply license file button, the new license is installed. Logout and login again to have the application use the new license. 64
3.3.5. IS THE LICENSE VALID FOR ALL DOMAINS? The license is by default only valid for one domain. That domain is indicated in the popup showing the content of the new license and, after it is installed, in the license management page. To purchase a single license valid for all the domains of a single installation, you will have to provide an installation ID which can be found in the license management page: 65
3.3.6. CHANGE THE RSS FEED In order to change the RSS feed, you must login either to the Web2cs or its administrator interface using the administrator account ( postmaster by default). In the application menu (located on the left), click on Administration. You will see the access points to the three administration pages: License Management Customization Manage RSS feed Click on Manage RSS feed. Provide a new RSS feed URL. Click Save. The RSS feed is updated. Go to the Desktop page to see the new RSS feed. 3.3.6.1. IS THE RSS FEED VALID FOR ALL DOMAINS? No. The RSS feed is valid for one domain only. 66
3.4. TROUBLESHOOTING 3.4.1. UPGRADING XANDMAILWEB2CS If you have a previously installed XandMailWeb2cs version, your users already have address book data and will want to keep their contacts in the new XandMailWeb2cs V4 for POA version. Follow these steps to upgrade your installation: 1. Backup the user data from the existing installation The user data is located in subfolders of the domains directory. Make a copy or a compressed file of the content of the domains directory. Make sure to announce to your users that their address book data will be copied at that time, so that they will not add or modify them afterwards 2. Install the new version of XandMailWeb2cs V4 for POA You should install in a new directory if you do not want to interrupt the service. This way, your users can keep working with the previous version while you prepare the new version. If you wish to install in the same directory, the service will be interrupted during the time it will take to make the installation. You must first uninstall the previous version (after making a backup of the domains directory) before installing the new version in the same location. 3. Copy the user data on the new installation Copy the content of the domains directory, taken from the previous installation, into the domains directory of the new installation. Make sure to keep the directory and file permissions as they were in the previous installation. 4. Update the Apache configuration on the new installation Include all the vhost_domain.conf files found under the domains subdirectories in the vhost.conf of the new installation 67
3.4.2. LOGIN DOES NOT WORK ON A 64 BITS SERVER 32 bits application binaries cannot execute on 64 bits servers if they are not recognized as executable files. So on 64 bits servers, it is necessary to install some system libraries used by 32 bits applications, so that they will execute correctly. You can check whether the application will work or not by going to the cgi-bin directory and asking for the binaries version. Type:./webmail -id It should display the version and copyright notices. If that succeeds, there is nothing to do. If you get an error /lib/ld-linux.so.2: bad ELF interpreter, you need to install the libgcc, glibc, and maybe also the libstdc++ and libncurses libraries. The command to see which library is missing is: ldd webmail The command to find out in which package to find the missing library is: yum whatprovides [the library name] The command to install the missing package is: yum install [the package name] After you have installed all missing packages and ldd finds all the dynamically linked libraries, ask once again for the binaries version. If that succeeds, try to login again from the login page in your browser. 68
4. UNINSTALLING WEB2CS We really do hope that you will not need to uninstall our application, except maybe to replace it with a more recent version of our products 4.1. UNINSTALLING A WEB2CS INSTANCE Connect to the Customer Control Panel Click on XandAMilWeb2cs V4 for POA. Click on Web2CS instances for domain aliases. Select all the domain aliases. Click Remove. Click on XandMail Web2CS V4. Click Uninstall. In the main Control Panel, click on Deployment Director. Click on Server Manager. Click on Hardware Nodes. Click on the Hardware Host name on which Web2cs is installed. Click on Applications. Click on Apache. Click Restart. 4.2. REMOVING WEB2CS FROM THE SERVER In the main Control Panel, click on Service Director. Click on Applications Manager. Click on Applications. Search for xand*. Click on XandMailWeb2cs V4 for POA. Click Instances. Check that there are no instances of the application. Click General. Click Delete Application. The Web2cs application is now no longer present on the server. 69