web2cs installation guide for parallels / poa

Transcription

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
1.1.
1.2.
1.3.
1.4.
1.5.
1.6.
1.7.
1.8.
1.9.
1.10.
1.11.
1.12.
1.13.
IMPORT THE APPLICATION PACKAGE
CREATE THE XANDMAILWEB2CS RESOURCE TYPE
CREATE THE XANDMAILWEB2CS V4 SITE RESOURCE TYPE
CREATE A SERVICE TEMPLATE
CREATE THE CUSTOMER WHO WILL MANAGE THE WEB2CS INSTALLATION
SUBSCRIBE THE CUSTOMER TO THE WEB2CS SERVICE TEMPLATE
ADD A NEW DOMAIN FOR CUSTOMER XANDMAIL, USING SUBSCRIPTION WEB2CS
CONNECT TO XANDMAIL STAFF USER CONTROL PANEL
ADD A SUBDOMAIN TO HOST THE APPLICATION
PROVISION XANDMAILWEB2CS V4 FOR POA
CREATE A NEW SERVICE USER [email protected]
CHECK THE POSTMASTER WEBMAIL ACCOUNT
CONFIGURE THE APACHE SERVER
4
4
6
11
14
18
20
22
24
25
26
29
32
34
2. MANAGING MULTIPLE DOMAINS ON THE SAME INSTALLATION
38
2.1. PRESENTATION
2.1.1. ONE INSTALLATION FOR SEVERAL DOMAINS, EACH WITH ITS OWN LEVEL OF FEATURES
2.1.2. ONE INSTALLATION FOR SEVERAL DOMAINS, ALL WITH THE SAME LEVEL OF FEATURES
2.2. ADD A NEW DOMAIN FOR CUSTOMER XANDMAIL, USING SUBSCRIPTION WEB2CS
2.3. CONNECT TO XANDMAIL STAFF CUSTOMER CONTROL PANEL
2.4. ADD A SUBDOMAIN TO HOST THE APPLICATION
2.5. LINK THIS SUBDOMAIN TO THE WEB2CS INSTALLATION
2.6. RESTART THE APACHE SERVER
2.7. ACCESS THE WEB2CS LOGIN PAGE FOR DOMAIN1.NET
2.8. CREATE THE MAILBOXES FOR DOMAIN1.NET
2.9. LOGIN TO XMAIL.DOMAIN1.NET AS POSTMASTER
2.10. REMOVING A DOMAIN ALIAS FROM THE INSTALLATION
2.11. MAKING A BACKUP OF THE DOMAIN SPECIFIC DATA
38
38
39
40
42
42
44
45
46
47
50
51
51
3. USING THE WEB2CS APPLICATION
52
3.1. ACCESS THE ADMINISTRATION INTERFACE
3.2. HIDE THE INSTALLATION INSTRUCTIONS PAGE
52
53
Web2cs Installation Guide – for Parallels / POA - April 11, 2012
Document confidentiel – toute reproduction doit faire l’objet d’une autorisation préalable
2
3.3. ACCESS THE MAIN INTERFACE
3.3.1. DISPLAY THE LOGIN PAGE
3.3.2. CHANGE THE APPLICATION COLORS AND LOGO
3.3.2.1. Upload a logo
3.3.2.2. Change the background color
3.3.2.3. Is the customization valid for all domains?
3.3.3. APPLICATION CAPABILITIES: LIMITED OR NOT?
3.3.4. INSTALL AN UPGRADE LICENSE
3.3.5. IS THE LICENSE VALID FOR ALL DOMAINS?
3.3.6. CHANGE THE RSS FEED
3.3.6.1. Is the RSS feed valid for all domains?
3.4. TROUBLESHOOTING
3.4.1. UPGRADING XANDMAILWEB2CS
3.4.2. LOGIN DOES NOT WORK ON A 64 BITS SERVER
54
54
55
57
59
60
61
63
65
66
66
67
67
68
4. UNINSTALLING WEB2CS
69
4.1. UNINSTALLING A WEB2CS INSTANCE
4.2. REMOVING WEB2CS FROM THE SERVER
69
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.
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
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”.
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
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
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
21
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.
23
1.8. CONNECT TO XANDMAIL STAFF USER CONTROL PANEL
Click on its name.
Click on General.
Click on Staff members.
Click on Login as Customer.
24
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.
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
28
1.11.
CREATE A NEW SERVICE USER [email protected]
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: [email protected].
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
31
1.12.
CHECK THE POSTMASTER WEBMAIL ACCOUNT
Click on Webmail Accounts.
The [email protected] address should be listed.
Click on the Open Entry Point link.
The login page is displayed in a new tab.
Login to the [email protected] 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 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 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
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.
41
2.3. CONNECT TO XANDMAIL STAFF CUSTOMER CONTROL PANEL
Click on its name.
Click on General.
Click on Staff members.
Click on Login as Customer.
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.
43
2.5. LINK THIS SUBDOMAIN TO THE WEB2CS INSTALLATION
Click on Web2CS instances for domain aliases.
Click New.
Input xmail.domain1.net as the domain alias.
Click Next.
44
2.6. RESTART THE APACHE SERVER
In the main Control Panel, click on Deployment Director.
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: [email protected].
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
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 [email protected] 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.
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).
•
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).
•
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.
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 Apache.
Click Restart.
4.2. REMOVING WEB2CS FROM THE SERVER
In the main Control Panel, click on Service Director.
Click on Applications Manager.
Search for “xand*”.
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

web2cs installation guide for parallels / poa

Transcription

Documents pareils

Show Notes ()

Le gérondif

Je voudrais: manger faire du shopping acheter un t

WEB2CS INSTALLATION GUIDE - Web2.0 Communication Suite

Les vêtements/La Mode un collant un gilet un haut un jean un

Guide D`installation pour la TOSCANE

Vocabulaire anglais lié aux vêtements

Assurance voyage collective .:ViatorMC .:ViatorTM Group Travel

Chapitre_1_files/C1 - lessons_1

EMILIE Before He Cheats Blame it on your lying Entre Matane et

UE52 L3 EM anglais 2014