OroMailCenter 2 Installation Guide

Transcription

1 Installation Guide Copyright OroLogic Inc. Revision 2.04

2 Contents I Contents Installation Guide 2 Introduction 2 Installing 2 Installing in stand-alone mode 2 Installing OroMailCenter in multi-user mode 3 Installing in multi-user mode with a Windows server 4 Installing OroMailCenter in multi-user mode with a Linux server or other Unix platforms 7 Installing OroMailCenter in multi-user mode with a server on other platforms 13 Migrating OroMailCenter 1 to 14 How to proceed 14 Data transfer utility 14 Important notes about the transfer 16 When to proceed? 16 Indexing messages 17 Starting 18 The service 19 Installing the service 19 Connections manager 23 Some information about connection parameters 23 Saving connection parameters in a file 24 Centralizing connection parameters in a file 24 Working with several databases 24 Creating a database identical to your current one 24 Creating an empty database 25 Licensing 26 Number of licenses required 26 Adding licenses into OroMailCenter 26 License assignation 26 Backing up the database 28 Backing up the database using the Backup option from the Tools menu 28 Backing up the database using the database utility 28 Backing up the database using the FIREBIRD GBAK utility 29 Restoring the database using the database utility 31 Restoring the database using the FIREBIRD GBAK utility 32 Technical support 34 Support via our web site : 34 Online support request: 34 Error messages: 34 Copyright 35 35

3 Installation Guide 2 Installation Guide Introduction This installation guide explains how to install OroMailCenter in stand-alone mode as well as in multi-user mode. In stand-alone mode, the OroMailCenter program as well as the OroMailCenter database are located on the same computer. This mode is perfect when used by a single user on a single computer. In multi-user mode, the OroMailCenter program is installed on several computers (client computers) while the database is installed on a remote server. So, several users can access the centralized database simultaneously. Installing The following section explains how to install OroMailCenter starting from the compressed file previously downloaded. If you do not have yet, you can download it from our web site at You must first install the software in order to use it. We recommend that you follow all steps below in order to ensure that the software will properly work on your computer. can be installed on Windows 2003, Windows XP, Windows Vista or Windows 2008 operating systems. The minimum requirement to run is a computer IBM compatible with a 1 Ghz processor with a minimum of 256Mb of RAM. Microsoft Internet Explorer 5.0 or higher is also required. OroMailCenter uses the FIREBIRD database to keep its data. FIREBIRD is a robust Open Source relational database and is completely free. Visit the official FIREBIRD web site at for more information about FIREBIRD. Note that in multi-user mode, the FIREBIRD database can be installed on a Windows platform (2003, XP, Vista or 2008) as well as on a Linux platform. FIREBIRD is also available on other platforms such as MacOs X and several Unix flavors. Visit the FIREBIRD web site for more details. OroMailCenter can be used on a single computer (in stand-alone mode) or in network mode (in multi-user mode) in order to allow several users to access the same OroMailCenter data simultaneously. Note that OroMailCenter was specifically developed to be used in multi-user mode. To install OroMailCenter on a single computer, refer to the section Installing in stand-alone mode. To install OroMailCenter in network environment, refer to the section Installing in multi-user mode. Installing in stand-alone mode If you want to install OroMailCenter and use it in stand-alone mode, follow the steps below. Note that installing OroMailCenter in stand-alone mode is perfect to evaluate the software or use it from a single computer. Note that later, if needed, you will be able to reinstall OroMailCenter in multi-user mode without any problem. Note that when installing OroMailCenter under Windows 2003, Windows XP, Windows Vista or Windows 2008, you must be connected with the Administrator user or a user that has the same rights so that the installation can run without any problem.

4 Installation Guide 3 Double-click on the file previously downloaded to start the installation. Once the installation is started, click Next. The installation program displays the license agreement of the product. You must accept the license agreement by clicking the radio button I agree with all these terms and click Next to continue with the installation. At next step, select the option Installation in stand-alone mode then click Next to continue. Then, you have to choose where OroMailCenter will be installed. We recommend you to install OroMailCenter in the suggested default installation folder C:\Program Files\OroLogic\OroMailCenter2. However, if you decide to install OroMailCenter in another folder than the suggested one, change it using the Browse button. Click Next to continue. Now, select the group of programs where icons will be installed. We recommend you to install icons in the suggested group of programs. Choose the group of programs or let the suggested one then click Next. The installation program is now ready to copy files on your computer. Answer Yes to the confirmation to start file copy. When all files are copied, the installation program asks you if you want a shortcut on your desktop. Answer to the question by clicking Yes or No. The installation program ends by displaying Installation successful. Click OK to finish. When the installation is over, you are ready to use the software. for more information. Refer to the section Starting Installing OroMailCenter in multi-user mode Note that for this part of the installation, a qualified computer/network technician is recommended.

5 Installation Guide 4 If you want that several computers access simultaneously the same OroMailCenter database, the database must be located on a computer that will act as the database server. OroMailCenter uses the FIREBIRD database engine (note that the Windows version of FIREBIRD is already included with OroMailCenter). It s not obligatory to have a dedicated server for FIREBIRD. FIREBIRD can be installed on your current server or if you do not have one, the computer of one of your users can act as the server and at the same time be used by this user. However, note that if you expect to have several users or a lot of data, installing FIREBIRD on a dedicated server is recommended for better performances. Whereas must obligatory be executed on a Windows platform (Win32), the FIREBIRD database engine can be installed on several different platforms such as Windows, Linux and several other ones. Note that FIREBIRD supports the TCP/IP protocol for all these platforms. OroMailCenter can run in a Local Area Network (LAN) as well as in Wide Area Network (WAN / INTERNET). However, note that since OroMailCenter is a client/server software, when using OroMailCenter, a lot of data can be transferred on your network between the OroMailCenter program and the FIREBIRD database. So, if you expect to use OroMailCenter on a WAN and/or INTERNET, be sure that you have a fast enough communication link so that OroMailCenter can run at an acceptable speed. Note that some solutions available on the market allow users to run client/server software (such as ) on a WAN or Internet with a low speed link. For example, you could use solutions such as Windows 2003 Terminal Service, Citrix, the Windows Remote Desktop option or other kind of software such as Symantec pcanywhere or VNC. Ask you computer equipment supplier for more information about these solutions. To install in multi-user mode with a Windows server, refer to the section Installing in multi-user mode with a Windows server. To install in multi-user mode with a Linux server or other Unix platforms, refer to the section Installing in multi-user mode with a Linux server or other Unix platforms. To install in multi-user mode with a server on other platforms such as MacOS X, refer to the section Installing in multi-user mode with a server on other platforms. Installing in multi-user mode with a Windows server Here are the main steps to follow for installing in multi-user mode with a Windows server: 1. Installation of OroMailCenter on the Windows server. 2. Installation and configuration of OroMailCenter on each client computer. 1. Installation of OroMailCenter on the Windows server. Note that when installing OroMailCenter under Windows 2003, Windows XP, Windows Vista or Windows 2008, you must be connected with the Administrator user or a user that has the same rights so that the installation can run without any problem. Double-click on the file previously downloaded to start the installation. Once the installation is started, click Next. The installation program displays the license agreement of the product. You must accept the license agreement by clicking the radio button I agree with all these terms and click Next to continue with the installation. At the next step, select the option Installation in multi-user mode, then, select the sub-option This computer will act as the server. The database will be located on this computer then click Next to continue. Then, you have to choose where OroMailCenter will be installed. We recommend you to install OroMailCenter in the suggested default

6 Installation Guide 5 installation folder C:\Program Files\OroLogic\OroMailCenter2. However, if you decide to install OroMailCenter in another folder than the suggested one, change it using the Browse button. Click Next to continue. Now, select the group of programs where icons will be installed. We recommend you to install icons in the suggested group of programs. Choose the group of programs or let the suggested one then click Next. The installation program is now ready to copy files on your computer. Answer Yes to the confirmation to start file copy. When all files are copied, the installation program asks you if you want a shortcut on your desktop. Answer to the question by clicking Yes or No. After it, the installation program automatically starts the installation of FIREBIRD server (since the Windows version of FIREBIRD is already included with OroMailCenter). After the installation of FIREBIRD server, the installation program displays important information that you will have to enter when you will configure OroMailCenter on each client computer. We strongly recommend you to print these information. The installation program ends by displaying Installation successful. Click OK to finish. You can now install and configure OroMailCenter on each client computer. Follow instructions at the next step to do that. 2. Installing and configuring OroMailCenter on each client computer Note that when installing OroMailCenter under Windows 2003, Windows XP, Windows Vista or Windows 2008, you must be connected with the Administrator user or a user that has the same rights so that the installation can run without any problem. Before using OroMailCenter in multi-user mode you must install OroMailCenter on each client computer that will need it. To do that, from the client computer on which you want to install OroMailCenter, double-click on the file previously downloaded to start the installation. Once the installation is started, click Next. The installation program displays the license agreement of the product. You must accept the license

7 Installation Guide 6 agreement by clicking the radio button I agree with all these terms and click Next to continue with the installation. At the next step, select the option Installation in multi-user mode, then, select the sub-option This computer will access the database that is located on a remote server then click Next to continue. Then, you have to choose where OroMailCenter will be installed. We recommend you to install OroMailCenter in the suggested default installation folder C:\Program Files\OroLogic\OroMailCenter2. However, if you decide to install OroMailCenter in another folder than the suggested one, change it using the Browse button. Click Next to continue. Now, select the group of programs where icons will be installed. We recommend you to install icons in the suggested group of programs. Choose the group of programs or let the suggested one then click Next. The installation program is now ready to copy files on your computer. Answer Yes to the confirmation to start file copy. When all files are copied, the installation program asks you if you want a shortcut on your desktop. Answer to the question by clicking Yes or No. After it, the installation program automatically starts the installation of FIREBIRD client (the client part of FIREBIRD is used to communicate with your server on which FIREBIRD server is installed). After the installation of FIREBIRD client, the installation program asks you if you want to configure the connection to the database now. Answer Yes to the question. You must enter parameters in different fields to indicate to OroMailCenter where is located the database. To enter these parameters, just use information that you printed when you installed OroMailCenter on your Windows server.

8 Installation Guide 7 After having entered connection parameters, click OK to continue. Then the installation program tests the connection to the OroMailCenter database using parameters you entered. If the test is successful, the installation program ends by displaying Installation successful. Click OK to finish. When the installation is over, you are ready to use the software. Refer to the section Starting for more information. If the connection test fails, the installation program displays an error message then you can verify parameters that you entered. Note that if for any reason, you are not able to configure OroMailCenter properly (because the connection test always fails), just continue and finish the installation. Later, you will just have to run the connections manager then configure your connection to the database. You will not have to reinstall OroMailCenter. For more information about the connections manager, refer to the section Connections manager. Installing OroMailCenter in multi-user mode with a Linux server or other Unix platforms Note: Two different versions of FIREBIRD can be installed on a Linux or Unix server. The Classic Server version and the Super Server version. We recommend you to install the Super Server version because this version offers more functionalities. Visit the FIREBIRD web site for more information about differences between these two versions. Note also that on some Linux or Unix platforms, only one version or the other is available.

9 Installation Guide 8 Before installing FIREBIRD on your Linux or Unix server, we recommend you to take a look at the Quick Start Guide for Firebird guide that contains useful information about installing FIREBIRD. This guide is available for download on the FIREBIRD web site at Here are the main steps to follow for installing OroMailCenter in multi-user mode and the FIREBIRD database on a Linux or Unix server: 1. Download of FIREBIRD for Linux or Unix from the FIREBIRD web site. 2. Installation of FIREBIRD server on the Linux or Unix server. 3. Transfer of the file omcbtf.fbk on the Linux or Unix server. 4. Creation of the database file omc.fdb on the Linux or Unix server. 5. Installation and configuration of OroMailCenter on each client computer. 1. Download of FIREBIRD for Linux or Unix from the FIREBIRD web site Only the Windows version of FIREBIRD is included with OroMailCenter. So, it s for this reason that you must first, download the FIREBIRD version for Linux or Unix according to your platform. To download FIREBIRD for free, visit the FIREBIRD web site at then, access the Downloads section and download the version of FIREBIRD according to your platform. Note that you can also download FIREBIRD from the web site of IBPhoenix at Important notes: At the time this documentation was written, OroMailCenter was tested with the version of FIREBIRD. We recommend you to download and install a version 1.5.x of FIREBIRD (version or higher such as 1.5.x). Once you downloaded FIREBIRD, continue to the next step to install it on your server. 2. Installation of FIREBIRD server on the Linux or Unix server Since the FIREBIRD installation can differ according to your platform, refer to the documentation included with FIREBIRD to install it on your specific platform. Also, the help of a qualified person about Linux or Unix is indispensable for this part of the installation. Before continuing at the step 3, after the installation of FIREBIRD on Linux or Unix, be sure that FIRBIRD is running properly. When installing FIREBIRD on Linux or Unix, example databases are also installed. Connect to one of these databases to check if FIREBIRD is running properly. Example of a connection test to FIREBIRD: Suppose that FIREBIRD is installed in the /opt/firebird folder on Linux or Unix and you want to access the employee.fdb database that is located in the examples folder of FIREBIRD, type the following command line under Linux or Unix (in one line) to connect to the database: /opt/firebird/bin/isql user sysdba password masterkey /opt/firebird/examples/employee.fdb Once you are connected, you can run a query on the employee table to display the employee list of this database by typing the following command: select * from employee; Type the following command to quit the ISQL utility: quit;

10 Installation Guide 9 As indicated above, you can also take a look at the Quick Start Guide for Firebird guide that contains useful information about how to verify if the server is properly running. For more information on FIREBIRD configuration and management utilities, refer to the FIREBIRD documentation. Important notes: Since FIREBIRD is derived from INTERBASE 6, if you already have INTERBASE installed on your Linux or Unix server, in that case, you will have to configure FIREBIRD so that it uses another port. In fact, both databases FIREBIRD and INTERBASE use the same port number to communicate (port TCP/3050) that can cause conflicts if both database engines are running simultaneously on the server. For example, to configure FIREBIRD so that it uses the port number 3051 instead of the port number 3050, from the FIREBIRD folder (for example /opt/firebird, edit the file firebird.conf then remove the # character before the line #RemoteServicePort = 3050 then change the port number from 3050 to Then, stop and restart FIREBIRD on the server. Original line : #RemoteServicePort = 3050 Modified line : RemoteServicePort = 3051 Note that if you change the port on which FIREBIRD communicate, do not forget to specify this new port number when you will configure the OroMailCenter connection on each client computer. For more information about FIREBIRD configuration, take a look at the documentation included with FIREBIRD. Once the installation of FIREBIRD is completed on Linux or Unix server, continue to the next step to transfer the OroMailCenter database on your server. 3. Transfer of the file omcbtf.fbk on the Linux or Unix server The OroMailCenter database file is named omc.fdb and is included with OroMailCenter. However, since the FIREBIRD database format differ from a Windows platform vs. a Linux or Unix platform, and the file omc.fdb that is included by default with OroMailCenter is in the format of FIREBIRD for Windows, you cannot just copy this file on your Linux or Unix server. Instead, you must create your database file using the file omcbtf.fbk (FIREBIRD transportable backup file format also included with OroMailCenter) as explained at the next step (Creation of the database file omc.fdb on the Linux or Unix server). However, before doing that, you must first transfer the file omcbtf.fbk on your Linux or Unix server as indicated below. The following procedure explains how to transfer the file omcbtf.fbk on your Linux or Unix server. However, if it is not already done, you must first install OroMailCenter on at least one computer to be able to access the file omcbtf.fbk. So, install OroMailCenter on one of your computer and just select the option Installation in stand-alone mode. The file needed (omcbtf.fbk) will be automatically copied in the installation folder. Later, you will just have to reinstall OroMailCenter on this computer then select the option Installation in multi-user mode as indicated at step 5. For more information about installing OroMailCenter in stand-alone mode, refer to the section Installing in stand-alone mode. From the computer where you installed OroMailCenter, transfer the file omcbtf.fbk using an FTP utility (Transfer method Binary) or any other transfer utility. The file omcbtf.fbk is uncompressed by the installation program and located in the C:\Program Files\OroLogic\OroMailCenter2 folder. Before transferring your file, create a new folder on your Linux or Unix server where your file will be transferred and where the database file will also be created. For example, you can create a folder named oromailcenter2 in the /home folder of your server. Then transfer your file omcbtf.fbk in the /home/oromailcenter2 folder on your Linux or Unix server.

11 Installation Guide Creation of the database omc.fdb on the Linux or Unix server To create the database file on your Linux or Unix server, from this one, connect with the root user or any other user that have enough rights. Type the following command line (in one line) to create the database file (by supposing that FIREBIRD was installed in the /opt/firebird folder and the file omcbtf.fbk was transferred in the /home/oromailcenter2 folder) : /opt/firebird/bin/gbak r user sysdba password masterkey /home/oromailcenter2/omcbtf.fbk /home/oromailcenter2/omc.fdb masterkey is the default password of the FIREBIRD SYSDBA user. If you changed the password of the FIREBIRD SYSDBA user, just replace masterkey by this new password. Once this command has been executed, if no message is displayed, is it because the database was successfully created. Verify that the created file omc.fdb exists in the /home/oromailcenter2 folder using the ls command. If you receive an error message, verify that you correctly entered the command line. The database creation is now completed. 5. Installation and configuration of OroMailCenter on each client computer Note that when installing OroMailCenter under Windows 2003, Windows XP, Windows Vista or Windows 2008, you must be connected with the Administrator user or a user that has the same rights so that the installation can run without any problem. Before using OroMailCenter in multi-user mode you must install OroMailCenter on each client computer that will need it. To do that, from the client computer on which you want to install OroMailCenter, double-click. on the file previously downloaded to start the installation. Once the installation is started, click Next. The installation program displays the license agreement of the product. You must accept the license agreement by clicking the radio button I agree with all these terms and click Next to continue with the installation. At the next step, select the option Installation in multi-user mode, then, select the sub-option This computer will access the database that is located on a remote server then click Next to continue. Then, you have to choose where OroMailCenter will be installed. We recommend you to install OroMailCenter in the suggested default installation folder C:\Program Files\OroLogic\OroMailCenter2. However, if you decide to install OroMailCenter in another folder than the suggested one, change it using the Browse button. Click Next to continue. Now, select the group of programs where icons will be installed. We recommend you to install icons in the suggested group of programs. Choose the group of programs or let the suggested one then click Next. The installation program is now ready to copy files on your computer. Answer Yes to the confirmation to start file copy.

12 Installation Guide 11 When all files are copied, the installation program ask you if you want a shortcut on your desktop. Answer to the question by clicking Yes or No. After it, the installation program automatically starts the installation of FIREBIRD client (the client part of FIREBIRD is used to communicate with your server on which FIREBIRD server is installed). After the installation of FIREBIRD client, the installation program ask you if you want to configure the connection to the database now. Answer Yes to the question. You must enter parameters in different fields to indicate to OroMailCenter where is located the database. Enter the name of your Linux or Unix server (or its IP address) in the first field. Note: To verify that the server name you entered is valid, you can open a command shell and type the following command line: ping myserver substituting myserver by the name that you entered in the first field. If you get a timeout message, this indicates that the server name is not valid or that the name resolution (resolution of the name into an IP address) does not work. In that case, ask your network administrator to fix it. After it, leave TCP/IP in the Protocol drop-down list. Note that TCP/IP is the only protocol available with. Be sure that your Linux or Unix server as well as all your client computers that will use OroMailCenter are properly configured with the TCP/IP protocol. Do not change the port number (usually 3050) unless you configured FIREBIRD on your server to use another port number to communicate. After it, enter the full path where is located the OroMailCenter database file such as /home/oromailcenter2/omc.fdb (refer to step 4 above for more information). Warning: You must enter the LOCAL path (for example /home/oromailcenter2/omc.fdb ) as if you were sat in front of the server console and not a network path such as Z:\OMC\OMC.FDB or \\MYSERVER\OMC\OMC.FDB else the connection will not work. A FIREBIRD database file is not a simple file (such as an MS Access file) that you share in a folder and users just have to access it. FIREBIRD is a

13 Installation Guide 12 real relational database engine and it is only through the FIREBIRD Server process that run on the server that clients can access the database. Note that under Linux or Unix, file and folder names are case-sensitive. If the file or folder name contains capital letters, then you will have to enter the path and database file name the same way. Finally, if you have changed the password of the FIREBIRD SYSDBA user on your server, enter the new password else let the default one (the default password is masterkey in lowercase). After having entered connection parameters, click OK to continue. Then the installation program tests the connection to the OroMailCenter database using parameters you entered. If the test is successful, the installation program ends by displaying Installation successful. Click OK to finish. When the installation is over, you are ready to use the software. Refer to the section Starting for more information. If the connection test fails, the installation program displays an error message then you can verify parameters you entered. Note that if for any reason, you are not able to configure OroMailCenter properly (because the connection test always fails), just continue and finish the installation. Later, you will just have to run the connections manager then configure your connection to the database. You will not have to reinstall OroMailCenter. For more information about the connections manager, refer to the section Connections manager.

14 Installation Guide 13 Installing OroMailCenter in multi-user mode with a server on other platforms In addition to be able to install FIREBIRD on Windows platforms as well as on different flavors of Linux or Unix, FIREBIRD can also be installed on other platforms such as MacOS X. Visit the FIREBIRD web site at to get the complete platform list compatible with FIREBIRD. Note: According to the platform chosen, two different versions of FIREBIRD can be installed on your server. The Classic Server version and the Super Server version. We recommend you to install the Super Server version because this version offers more functionalities. Visit the FIREBIRD web site for more information about differences between these two versions. Note also that on some platforms, only one or the other is available. Before installing FIREBIRD on your server, we recommend you to take a look at the Quick Start Guide for Firebird guide that contains useful information about installing FIREBIRD. This guide is available for download on the FIREBIRD web site at To install OroMailCenter in multi-user mode and the FIDEBIRD database on another platform, we recommend you to follow same steps as the installation of OroMailCenter in multi-user mode with a Linux server or other Unix platforms. The only differences are mainly the way you specify a path and/or a file name. Here are some recommendations: - At step 1, download the version of FIREBIRD according to your platform. - At step 2, refer to the documentation included with the FIREBIRD to install it on the platform chosen. - At step 3, transfer the file omcbtf.fbk on your server. - At step 4, create the database file using the gbak utility included with the FIREBIRD version you downloaded and installed on your server. - At step 5, just configure the connection and enter exactly the path where is located the database file on your server.

15 Installation Guide 14 Migrating OroMailCenter 1 to This section explains how to proceed when you are using the version 1.0 of OroMailCenter and you want to migrate to version 2. OroMailCenter 1.0 and.0 are two completely independent software versions. Unlike other software, you could use both versions simultaneously. OroMailCenter 1.0 could access an OroMailCenter 1.0 database while.0 could access an.0 database. OroMailCenter 1.0 and.0 are installed in two different folders. Usually, OroMailCenter 1.0 is installed in the C:\Program Files\OroLogic\OroMailCenter folder while.0 is usually installed in the C:\Program Files\OroLogic\OroMailCenter2 folder. When you install.0, no file in the OroMailCenter 1.0 folder is altered. How to proceed Just begin by installing according to the procedure in the Installing OroMailCenter 2 section above. Then, when everything is properly configured and working, it only remains to transfer your data from the OroMailCenter 1.0 database to the.0 database using the data transfer utility already included with. Please note that using this utility, data in the OroMailCenter 1.0 database are not altered. OroMailCenter 1.0 data are simply read then copied in the database. So, even after a transfer, the OroMailCenter 1.0 database will be still working for all OroMailCenter 1.0 users. Data transfer utility To transfer data from an OroMailCenter 1.0 database to an database, you must run the data transfer utility included with. To run this utility, from the Windows Start button, select Programs Data transfer v1 to v2. Please note that before being able to transfer data, OroMailCenter 1.0 as well as must be installed and properly working on the computer from which you want to run the transfer. In the main data transfer utility window, from the section Connection OroMailCenter version 1, click on the button then select the connection to the OroMailCenter 1.0 database you want. Then, from the section Connection OroMailCenter version 2, click on the button then select the connection to the database you want. Then, click the button Transfer data to start the transfer process and answer to the confirmation message. WARNING: The data transfer utility will automatically erase all data of the database before transferring OroMailCenter 1.0 data. Before running the transfer, if there is some information in the database that you want to keep, we suggest you to print it or to keep a copy of the database. Please also note that you cannot make a partial transfer of data. Indeed, when transferring data, all OroMailCenter 1.0 data are transferred in the database.

16 Installation Guide 15 When the transfer process starts, to continue, you must enter the agent code as well as its corresponding password of an agent that has administrator rights in the OroMailCenter 1.0 database. Then, you must also enter the agent code as well as its corresponding password of an agent that has administrator rights in the database. Note that it is strongly recommended that nobody access the database while transferring data. When the transfer is over, just quit the data transfer utility then run to verify that all data were correctly transferred.

17 Installation Guide 16 Important notes about the transfer Passwords Once the transfer is done, all passwords agents of the database become automatically identical to the passwords of agents of the OroMailCenter 1.0 database. Sending and receiving s Once the transfer is done, as a precaution, all message centers of the database become disabled to prevent that you receive messages in the database in the case that if you are still using OroMailCenter 1.0. Before enabling message centers in the database, we suggest you to stop and uninstall the OroMailCenter 1.0 service. To stop the OroMailCenter 1.0 service, directly from the console of the server where the service is running, go in the installation folder of OroMailCenter 1.0 (usually C:\Program Files\OroLogic\OroMailCenter) then run the SRVMAN.EXE program. From the drop down list, select OroMailCenter then click the button Uninstall service to stop and uninstall the service. So, since the service will be uninstalled, you will be sure that no message will be received into OroMailCenter 1.0 anymore. To activate message centers into, from, right-click on the message center to activate then select the option Message center properties. Then, check the box Active then click OK to save changes. After it, if not already done, install the service. Refer to the section The OroMailCenter 2 Service for more information. Indexing messages Into, all messages are now indexed. It allows to search for messages more quickly. By default, all messages received or created into are automatically indexed. However, messages that were transferred from OroMailCenter 1 to are not automatically indexed. Indeed, the transfer process could take too many time to run. So, it is for this reason that transferred messages must be indexed in a separate task. Refer to the section Indexing messages below to know how to index messages transferred from OroMailCenter 1.0 When to proceed? After having tested and you are ready that your users start using version 2 instead of version 1, no matter if you already made a data transfer in the past (for example, for tests purpose), you must run a last transfer again so that the database contains all data that was entered in the OroMailCenter 1 database. Please note that all users must obligatory start using version 2 at the same time. You cannot just migrate a part of the users. This is because the data transfer utility cannot just transfer a part of the database. The whole database must be transferred. As indicated above, since OroMailCenter 1 and are two completely independent versions, can be installed in advance on each computer without interfering with OroMailCenter 1. Once the transfer is done, your users will be able to use version 2 of OroMailCenter instead of version 1. All data will be in the database. From this moment, your users must not use version 1 of OroMailCenter anymore. They must all use version 2. Else, if some users still use version 1 and other use version 2, you will have new data in two different databases. In a such case, you will not be able to transfer data again since the data transfer utility cannot just transfer a part of the database. If you run the transfer again, you will loose new data entered in version 2.

18 Installation Guide 17 Indexing messages As indicated above, into, all messages are now automatically indexed. It allows to search for messages more quickly. By default, all messages received or created into are indexed. However, messages that are transferred from OroMailCenter 1 to are not automatically indexed. To index messages that were transferred from OroMailCenter 1, you must run the Data transfer utility included with. To run this utility, from the Windows Start button, select Programs Data transfer v1 to v2. In the main data transfer utility window, from the section Connection OroMailCenter version 2, click on the button then select the connection to the database you want. Then, select the tab Index messages then click the button Index messages to start indexing messages. Before indexing process start, you must enter the agent code as well as its corresponding password of an agent that has administrator rights in the database. Once entered, the indexing process starts. Note that the indexing process duration depends on the amount of messages contained into the database. So, if you want, you can stop the indexing process anytime by clicking the button Stop index so that you can continue indexing messages later. Messages that are already indexed will not have to be indexed again.

19 Installation Guide 18 Starting Before being able to start OroMailCenter, you must first install it if it is not already done. For more information about installing OroMailCenter, refer to the section Installing. To start OroMailCenter, from the Windows Start button, select Programs. After a few seconds, you will be in the program ready to use it. If you cannot start OroMailCenter and/or an error message is displayed, refer to the section Technical support. When you start OroMailCenter for the first time, you must obligatory create a first message center. You just have to enter information as requested by the wizard. For detailed information about parameters of a message center, refer to the guide Implementation Guide.

20 Installation Guide 19 The service By default, when using OroMailCenter, you must click the Send/Receive button to send and/or receive e- mails. This is perfect when you are using OroMailCenter in stand-alone mode. However, when you are using OroMailCenter in multi-user mode, this way to send and receive s is not appropriate. So, a program named Service (Windows service) was specifically developed to automate this task. This service take care of sending and receiving s, even when no agent are connected to OroMailCenter. Also, if you want that an acknowledgment be automatically sent to your customer when you receive a new request by , you must obligatory use the service to do that. Note that the service can be installed even if the OroMailCenter service of version 1.0 is already installed and running on the same computer or server. Indeed, both services can cohabit without any problem. The service is already included with OroMailCenter. However, the install program does not install it systematically on each computer since this service needs to be executed on one computer only (usually on your server). Warning: Do not execute the service on more than one computer unless to be sure that each service access different databases else you could get problems when using OroMailCenter if more than one service access the same database. Note also that only one service can take care of sending and receiving s in several different database. As indicated above, the service is a Windows service. So, this one can only be executed on a Windows XP, Windows 2003, Windows Vista or Windows 2008 platform. The service cannot be executed on older Windows versions or on other platforms such as Linux or Unix. If your server is a Windows XP, Windows 2003, Windows Vista or Windows 2008 platform, we recommend you to simply install the service on your server. If your server is on another platform, then just install the service on another server or a Windows XP, Windows 2003, Windows Vista or Windows 2008 client computer. No matter that you install the service on a server or one of your client computers, what is important here is that the computer where the service is installed be always running else you will not be able to send and receive your s anymore. Installing the service Here are the main steps to follow to install the service: 1. Be sure that is properly installed and configured on the computer where you want to install the service. 2. Install and start the service. 3. Indicate which database the service must access. 4. Configure the database to indicate that sending and receiving s will now be performed by the service. 1. Be sure that is properly installed and configured on the computer where you want to install the service. If it is not already done, install OroMailCenter on the computer on which you want to install the service. You must install OroMailCenter in multi-user mode. Refer to the section Installing in multi-user mode above for more information. Then, run OroMailCenter on this computer to be sure that you can connect to the database without any problem. After it, just quit OroMailCenter then continue to next step.

21 Installation Guide 20 Warning: The service will not work if OroMailCenter is installed in stand-alone mode. The OroMailCenter service works only in multi-user mode. 2. Install and start the service. From the server or computer where you want to install the service, using the Windows File Explorer, go to the installation folder (usually C:\Program Files\OroLogic\OroMailCenter2), then, double-click on the file srvman.exe to start the Service manager for utility. Then select the service named from the Service dropdown list and click on the Install service button to install the service. Installing the service takes approximately one second. Once installed, the status on screen should change from Not installed to Started. If not, click the button Refresh to refresh the status of the service on screen. To verify that the service was correctly installed and started, go to the Windows control panel, double-click on the Administrative tools icon then double-click on the Services icon. Verify that the service named is in the list of services and that the status is Started. Also, verify that the startup type is Automatic so that the service start automatically each time Windows is started. The service is now installed. You can continue to the next step. 3. Indicate which database the service must access. Even if the service is started, by default, the service does not access any database. It just runs without really doing anything. You must indicate which database the service must access to send and receive s. To indicate to the service which database it must access, you must check an option in the connection parameters to the database using the Connections manager utility. From the server or computer where you installed the service, run the connections manager (from the Windows Start button, select Programs Connections manager) to access the connection list. By default (and in most cases), there should be only one connection in the list. However, if you configured several databases, you will probably have several connections in the list. Double-click the connection that correspond to the database which you want that the service take care of sending and receiving s. Then, check the box This connection is also used by the service then click OK to validate changes. Finally, quit the connections manager to save changes in the connections file.

22 Installation Guide 21 Note that you can indicate to the service to take care of sending and receiving s in several databases by checking the option This connection is also used by the service in each connection to different databases. The service that is running will automatically start to access the database you specified using the connections manager. However, the service will do nothing until you configure the database itself to indicate that sending and receiving s will now be performed by the service. Continue to the next step to activate this last option. 4. Configure the database to indicate that sending and receiving s will now be performed by the service. To indicate to the database that sending and receiving s will be performed by the service, just run OroMailCenter then connect to the database using the agent code ADMIN or any other agent that has administrative rights. Note that by default the Administrator agent does not have any password. Go to the menu Configuration System parameters, select the tab Sending/Receiving messages then check the option Sending and receiving s is performed by the service. Click OK to save changes.

23 Installation Guide 22 Starting from now, the Send/Receive button on the toolbar will become disabled since sending and receiving s is now taken care of by the service. If after you configured the service, s don t seem to arrive (or leave in the case you are sending s), verify all your parameters. The service generate a log file named OMCSRV.LOG that is located in the installation folder (usually C:\Program Files\OroLogic\OroMailCenter2). Consult this file that contains error messages when (for any reason), the service is not able to access the database. If the service can access the database, in that case, errors will be logged into the database itself and available through the menu Options Error log of OroMailCenter.

24 Installation Guide 23 Connections manager The connections manager utility allows you to manage the list of database connections. When installing OroMailCenter in multi-user mode, the installation program ask you for some connection parameters then automatically create a connection for you. Usually, you only have to work with one database so you will only have one connection in the list. However, if for a specific reason, you have to work with several OroMailCenter databases, in that case, you will probably have several connections in the list, usually one connection for each different database. Refer to the section Working with several databases below for more information. By default, when you run OroMailCenter, the program uses the default connection then connect to the database specified in this connection. If you are working with several databases, you could indicate in the connections manager to always display the list of connections at startup so that you could choose each time which database you want to connect to. To indicate to OroMailCenter to always display the list of connections at startup, you just have to check the option Always display the list of connections at startup in the main screen. Note that to tag a connection as the default connection, on the left side of the connection, click the radio button Default. Some information about connection parameters When configuring a connection, the username as well as the password are always a FIREBIRD username and password. Do not confuse with agent codes and passwords of OroMailCenter. Since OroMailCenter has its own security, just enter SYSDBA as the user name and masterkey (in lowercase) as the password. If you changed the password of the FIREBIRD SYSDBA user, enter the new password instead of masterkey. When you enter the full path to the database, always enter the local path as you were sat in front of the server. For example, if your database is located on a Windows server, the full path should usually be C:\Program Files\OroLogic\OroMailCenter2\omc.fdb. If your database is located on a Linux server, the full path should usually be /home/oromailcenter2/omc.fdb. Never enter a network path such as Z:\MyFolder\omc.fdb or \\MyServer\MyFolder\omc.fdb, else it will not work.

25 Installation Guide 24 Please, also note that you never have to share the folder where is located the OroMailCenter database. The OroMailCenter database is of FIREBIRD type. A FIREBIRD database file is not a simple file (such as an MS Access file) that you share in a folder and users just have to access it. FIREBIRD is a real relational database and it is only through the FIREBIRD process that runs on the server that clients can access the database. Using the TCP/IP protocol, you can enter the server name or its IP address where is located the FIREBIRD database. Saving connection parameters in a file Parameters of a connection can be saved in a file. To save a connection to a file, right-click on the connection then select Save to file. Enter the name of the file then click Save. This file can be retrieved from the connections manager on another computer. This allows you to configure other computers without having to reenter connection parameters each time. Do not forget to test your connection using the Test button on other computers also to be sure that communication is working fine between this other computer and your database server. Centralizing connection parameters in a file It is also possible to indicate for a connection to always retrieve its parameters from a file previously saved (see above). To do that, select the option This connection always uses parameters from the following file then select the file that contains connection parameters using the button. This can be very useful when you want to centralize connection parameters of all OroMailCenter users in a single location on your network. Working with several databases In some cases, it could happen that you need more than one OroMailCenter database. For example, if you have two different departments or workgroups in your organization that must use OroMailCenter but for a specific reason, cannot share the same database. You could create a new database from the existing one (you would have an identical copy of the database that contains same data) or you could create a new empty database. Please note that since you can have several message centers in a same database, we recommend you to create two message centers into your database instead of two different databases. In fact, since OroMailCenter customers are common to all message centers, this way offers you more flexibility. However, if for a specific reason, you need to use more than one database, please note that you must buy or rent different licenses of for each different database that you will use. Refer to the section Licensing for more information. Creating a database identical to your current one To create a new database starting from your current one, using the database utility, make a backup copy if your current database. Then, using the backup file, restore the database on a different name such as OMC-B.FDB. Refer to the section Backing up the database for more information about how to backup or restore databases. After the creation of the new database, you must create a new connection to access it. To do that, run the connections manager, then add a new connection that point on the new database instead of the default one. For example, if you named your new database OMC-B.FDB and it is located in the C:\Program Files\OroLogic\OroMailCenter2 folder, then you should enter C:\Program Files\OroLogic\OroMailCenter2\omc-b.fdb in the field Full path to the database. Under Linux, if you named you new database omc-b.fdb and it is located in the /home/oromailcenter2 folder, then you should enter /home/oromailcenter2/omc-b.fdb.

26 Installation Guide 25 After creating your new connection, test it to be sure that it works using the Test button. Then, check the box Always display the list of connections at startup. So, when you will run OroMailCenter, you will be able to choose which database to access. Finally, quit the connections manager, run OroMailCenter then select a connections to access one or the other of your databases. Creating an empty database An empty database in FIREBIRD backup format is included with OroMailCenter. When installing OroMailCenter, this file named OMCBTF.FBK is automatically copied in the installation folder (usually C:\Program Files\OroLogic\OroMailCenter2). You must use this file to create a new empty database. To create a new empty database, using the database utility, restore the file OMCBTF.FBK on a different name such as OMC-B.FDB. Refer to the section Backing up the database for more information about how to backup or restore databases. After the creation of the new database, you must create a new connection to access it. To do that, run the connections manager, then add a new connection that point on the new database instead of the default one. For example, if you named your new database OMC-B.FDB and it is located in the C:\Program Files\OroLogic\OroMailCenter2 folder, then you should enter C:\Program Files\OroLogic\OroMailCenter2\omc-b.fdb in the field Full path to the database. Under Linux, if you named you new database omc-b.fdb and it is located in the /home/oromailcenter2 folder, then you should enter /home/oromailcenter2/omc-b.fdb. After creating your new connection, test it to be sure that it works using the Test button. Then, check the box Always display the list of connections at startup. So, when you will run OroMailCenter, you will be able to choose which database to access. Finally, quit the connections manager, run OroMailCenter then select a connections to access one or the other of your databases.

27 Installation Guide 26 Licensing You can use for a free 45-day trial period. During this period, each time you start OroMailCenter and no valid license numbers are detected, a dialog box is displayed indicating the number of days remaining to your trial period. There is no software limitation when you are in trial mode. So, you can use OroMailCenter in stand-alone mode as well as in multi-user mode without any problem. After having evaluated OroMailCenter, if you decide to buy or rent it, you will have nothing to reinstall or reconfigure. Your data will also be preserved in the database even if the trial period is over. You will only have to enter license numbers that you will receive by to automatically unlock OroMailCenter and continue to use it. Number of licenses required To continue to use after the 45-day trial period, you must buy or rent licenses. You need at least one license for each agent that must use. In fact, you can install on any number of computers you want since licenses are managed per agent instead of per computer. For example, if you have 5 agents that must use OroMailCenter (no matter if they are using OroMailCenter simultaneously or not), you will need 5 licenses. Please note that licenses are not concurrent. So, even if there is never more than 3 agents that are using at the same time, you will even need 5 licenses. Note about using OroMailCenter with more than one database : In most cases, when using OroMailCenter you will only need one database. If you want that more than one department or workgroup of your organization use OroMailCenter, we suggest you to add message centers in your database instead of creating different databases. In fact, since customers into OroMailCenter are common to all message centers, this way offers you more flexibility. However, if for a specific reason, you must use more than one database, please note that you must buy or rent different licenses for each different database that you will use. Ask the OroLogic sales team for more information. Adding licenses into OroMailCenter When you buy or rent OroMailCenter licenses, you will receive your licenses by (in a file in attachment). Once received, you must add it into OroMailCenter. To do that, double-click on the file that contains license numbers to open it. Select all text (including <BEGIN-LIC-OMC> and <END-LIC-OMC> tags) then copy all the text in the clipboard. After it, click on the button Add my licenses to from the dialog box that displays the number of days remaining to your trial period, or click the Add button from the option Licenses manager available in the Configuration Licenses manager menu of OroMailCenter. Paste all the text in the edit box and click OK. License numbers will be automatically decrypted and OroMailCenter will be automatically unlocked for the number of agents that corresponds to the number of licenses decrypted. Note that license numbers are kept directly into the database. So, you only need to add licenses once from any computer. License assignation By default, when adding new licenses into OroMailCenter, these licenses are not assigned to any agent. As agents access OroMailCenter, a license is automatically assigned to them forever. So, even if the agent quit OroMailCenter, the license remains assigned to him any time. If a new agent try to access OroMailCenter and all licenses are already assigned, this new agent will receive a message indicating that no more licenses are available. OroMailCenter never unassign a license already assigned to an agent.

28 Installation Guide 27 When an agent does not need to use OroMailCenter anymore (for example, because this agent does not work for your organization anymore), you can assign his license to another agent. To do that, from the Licenses manager option available from the menu Configuration Licenses manager select the license you want to assign to another agent then click the Assign button. Then, select Assign to then select the name of the new agent. It can happen that for a license, OroMailCenter indicates that the agent is connected to OroMailCenter but in fact, the agent is not into OroMailCenter anymore (for example if the computer of this agent had a problem and the agent was not able to quit OroMailCenter by the correct way). In that case, if the agent try to run back OroMailCenter, he could receive a message indicating that he is already connected on another computer if there is no more licenses available (non assigned). In a such case, if the agent wait 15 minutes before running back OroMailCenter, OroMailCenter will detect the problem and will allow back the agent to use OroMailCenter. However, if the agent wants that the license be available immediately (because he cannot wait), then, you could manually unassign the license that this agent is using. To do that, from the option Licenses manager available in the menu Configuration Licenses manager select the license you want to unassign then click the Assign button. Then, select Unassign agent from the menu. Warning: never unassign a license that is really in use by an agent else OroMailCenter will stop working for this agent. This agent will have to restart OroMailCenter. Please also note that usually, you never have to use the option Unassign agent.

29 Installation Guide 28 Backing up the database We strongly recommend that you backup your OroMailCenter data on a regular basis. Backing up your data protects you from losing your data by a hardware failure (computer, hard disk, etc.) or a software failure (operating system, virus, electricity lost, etc.). OroMailCenter works with the FIREBIRD database. To make a backup copy of your database, you can use the option Backup available from the menu Tools directly into OroMailCenter, the utility named database utility or the GBAK utility of FIREBIRD. No matter the way used when making a backup copy of your database, a copy of the database is created in a new file of type FIREBIRD backup format and this new file usually has the extension.fbk. Once that the backup file is created, we strongly recommend you to save this file on a cd-rom, a tape or any other media. For more information on different archive method or archive media, ask your computer supplier. Important note: If you are using a backup software, configure the software so that the software does not backup the database file. You must instead backup the backup file created using one of the methods indicated above. Indeed, if your backup software try to backup a database file that is in use, in some cases, this could damage the database. If later, you get a problem and you have to restore your database, and a backup file was created using any method indicated above, you will be able to restore your database using the utility named OroMailCenter 2 database utility or the GBAK utility of FIREBIRD. Note that you cannot just only rename a backup file from the extension.fbk to the extension.fdb. It will not work. A backup file must obligatory be restored using the utility named database utility or the GBAK utility of FIREBIRD. Refer to the sections Restoring a database using the database utility or Restoring a database using the GBAK FIREBIRD utility below for more information. Backing up the database using the Backup option from the Tools menu This option is the simpler way to make a backup copy of your database. You just have to run the option Backup available from the menu Tools and click on the button Start backup. No parameter is required. You can run this option even when agents are accessing the database. In fact, this option was specifically developed for this purpose. This option creates a copy of the database file (in FIREBIRD backup format) in the same folder where is located the database you are currently accessing. Usually, the name of the file will be the name of the database with the date and hour and the extension will be.fbk instead of.fdb. Backing up the database using the database utility You can make a backup using this utility even when agents are accessing the database. In fact this option was specifically developed for this purpose. To make a backup using this utility, from the Windows Start button, select Programs Database utility. Then select the Backup tab. Click the button Connection list located on the right side of the Connection mode section then select the connection of the database you want to backup. Click OK so that information be automatically entered in different fields. In the

30 Installation Guide 29 Password field, enter the password of the FIREBIRD SYSDBA user. By default the password of the FIREBIRD SYSDBA user is masterkey (in lowercase). By default, the utility suggest you to create a backup file in the same folder where is located the database. The suggested filename is the same than the database name except that the extension will be.fbk instead of.fdb. You can change the folder or the name of the backup file suggested if you want. Then, check the box Display log file after backup then click the button Start backup. After the backup process, you will receive a message telling you that if the backup was successfully made and after it the log describing all backup steps will be displayed on screen. Backing up the database using the FIREBIRD GBAK utility GBAK is a backup and restore utility that is included with FIREBIRD. GBAK is a command line utility and works the same way no matter if your database is located on a Windows, Linux or Unix server or on any other platform. One of the benefits of using GBAK is to be able to backup your database using script files (batch files on Windows). So, using any scheduling software, you could run script files, for example, to automatically

31 Installation Guide 30 backup your database each night. Also, since the GBAK utility was specifically developed for FIREBIRD databases, you can even backup your database while users are using OroMailCenter and are accessing the database. For more information about the FIREBIRD GBAK utility, refer to the documentation included with FIREBIRD. For more information about script files, refer to the documentation of the operating system where FIREBIRD server is installed. Example of backup using GBAK under Windows For our example here, the database is named omc.fdb and is located in the C:\Program Files\OroLogic\OroMailCenter2 folder. FIREBIRD is installed in the C:\Program Files\Firebird\Firebird_1_5 folder. From the Windows server where the database is located, start a command shell session and type the following command line (in one line and including double quotes): "C:\Program Files\Firebird\Firebird_1_5\bin\gbak" -B -USER SYSDBA -PASSWORD masterkey "C:\Program Files\OroLogic\OroMailCenter2\omc.fdb" "C:\Program Files\OroLogic\OroMailCenter2\omc.fbk" The parameter -B indicates to the GBAK utility to make a backup. The parameter -USER indicates the FIREBIRD user name to use. In this case, the SYSDBA FIREBIRD user is used (Do not confuse with agents of OroMailCenter). The parameter -PASSWORD indicates the FIREBIRD user password (in this case SYSDBA). By default the password of the FIREBIRD SYSDBA user is masterkey (in lowercase). This command performs a backup of the omc.fdb database. The backup file will be named omc.fbk. Important notice: The command above will work only if it is run directly from the server console. This command will not work if you run it through a client terminal server session or for example if the command is run in background from a task scheduler software. In such case, you must specify the server name as well as the port number on which Firebird is running (TCP/IP syntax). Usually, the default port number used is Verify your OroMailCenter connection parameters to see which port number to use in the command. Here is the same example as above, except that the server name and port number are specified: "C:\Program Files\Firebird\Firebird_1_5\bin\gbak" -B -USER SYSDBA -PASSWORD masterkey "localhost/3050:c:\program Files\OroLogic\OroMailCenter2\omc.fdb" "C:\Program Files\OroLogic\OroMailCenter2\omc.fbk" In this example, the server is named localhost and the port number on which Firebird is running is Note that you must add the character / between the server name and the port number and add the character : after the port number. Please, also note that you could enter the IP address of the server instead of its name. Example of backup using GBAK under Linux or Unix For our example here, the database is named omc.fdb and is located in the /home/oromailcenter2 folder. FIREBIRD is installed in the /opt/firebird folder. From the Linux or Unix server where the database is located, start a command shell session and type the following command line (in one line):

32 Installation Guide 31 /opt/firebird/bin/gbak -b -user SYSDBA -password masterkey /home/oromailcenter2/omc.fdb /home/oromailcenter2/omc.fbk The parameter -b indicates to the GBAK utility to make a backup. The parameter -user indicates the FIREBIRD user name to use. In this case, the SYSDBA FIREBIRD user is used (Do not confuse with agents of OroMailCenter). The parameter -password indicates the FIREBIRD user password (in this case SYSDBA). By default the password of the FIREBIRD SYSDBA user is masterkey (in lowercase). This command performs a backup of the omc.fdb database. The backup file will be named omc.fbk. Restoring the database using the database utility First, be sure that nobody is accessing the database you want to restore. Then copy the backup file in the same folder where is located the database to restore. From the Windows Start button, select Programs Database utility. Then select the Restore tab. Click the button Connection list located on the right side of the Connection mode section then select the connection of the database you want to restore. Click OK so that information be automatically entered in different fields. In the Password field, enter the password of the FIREBIRD SYSDBA user. By default the password of the FIREBIRD SYSDBA user is masterkey (in lowercase). Be sure that the name entered in the field Backup file name is valid and corresponds to the file you want to restore. Then, check the box Display log file after restore then click the button Start restore. After the restore process, you will receive a message telling you that if the restore was successfully made and after it the log describing all restore steps will be displayed on screen. When the restore is complete, you can run back and access your database.

33 Installation Guide 32 Restoring the database using the FIREBIRD GBAK utility First, be sure that nobody is accessing the database you want to restore. Then copy the backup file in the same folder where is located the database to restore. Example of Restore using GBAK under Windows For our example here, our backup file is named omc.fbk and is located in the C:\Program Files\OroLogic\OroMailCenter2 folder. FIREBIRD is installed in the C:\Program Files\Firebird\Firebird_1_5 folder. From the Windows server where the database is located, start a command shell session and type the following command line (in one line and including double quotes): "C:\Program Files\Firebird\Firebird_1_5\bin\gbak" -R -USER SYSDBA -PASSWORD masterkey "C:\Program Files\OroLogic\OroMailCenter2\omc.fbk" "C:\Program Files\OroLogic\OroMailCenter2\omc.fdb" The parameter -R indicates to the GBAK utility to make a restore.

34 Installation Guide 33 The parameter -USER indicates the FIREBIRD user name to use. In this case, the SYSDBA FIREBIRD user is used (Do not confuse with agents of OroMailCenter). The parameter -PASSWORD indicates the FIREBIRD user password (in this case SYSDBA). By default the password of the FIREBIRD SYSDBA user is masterkey (in lowercase). This command restore the file omc.fbk over the file omc.fdb. Important notice: The command above will work only if it is run directly from the server console. This command will not work if you run it through a client terminal server session or for example if the command is run in background from a task scheduler software. In such case, you must specify the server name as well as the port number on which Firebird is running (TCP/IP syntax). Usually, the default port number used is Verify your OroMailCenter connection parameters to see which port number to use in the command. Here is the same example as above, except that the server name and port number is specified: "C:\Program Files\Firebird\Firebird_1_5\bin\gbak" -R -USER SYSDBA -PASSWORD masterkey "C:\Program Files\OroLogic\OroMailCenter2\omc.fbk" "localhost/3050:c:\program Files\OroLogic\OroMailCenter2\omc.fdb" In this example, the server is named localhost and the port number on which Firebird is running is Note that you must add the character / between the server name and the port number and add the character : after the port number. Please, also note that you could enter the IP address of the server instead of its name. Example of Restore using GBAK under Linux or Unix For our example here, our backup file is named omc.fbk and is located in the /home/oromailcenter2 folder. FIREBIRD is installed in the /opt/firebird folder. From the Linux or Unix server where the database is located, start a command shell session and type the following command line (in one line): /opt/firebird/bin/gbak -r -user SYSDBA -password masterkey /home/oromailcenter2/omc.fbk /home/oromailcenter2/omc.fdb The parameter -r indicates to the GBAK utility to make a restore. The parameter -user indicates the FIREBIRD user name to use. In this case, the SYSDBA FIREBIRD user is used (Do not confuse with agents of OroMailCenter). The parameter -password indicates the FIREBIRD user password (in this case SYSDBA). By default the password of the FIREBIRD SYSDBA user is masterkey (in lowercase). This command restore the file omc.fbk over the file omc.fdb.

35 Installation Guide 34 Technical support To get technical support on installation and/or use of here are the different sources of information available: Support via our web site : You can, 24 hours a day, 7 days a week, access the Support section of our web site, at The Support section of our web site is updated on a regular basis and you can consult the list of frequent problems and their suggested solutions. This service is free for all users of. Online support request: From the menu Help Online services Fill an online support request of OroMailCenter, you can fill an online support request. This option automatically open your browser and access the Online support request form in the Support section of our web site at Support requests made directly from this form are usually faster to answer and process since most information we need are automatically filled. This service is free for all users. Note that support requests from users that already bought or rented will be processed in priority. If for any reason, you cannot run OroMailCenter and you do not have access to the OroMailCenter Help menu, you can access to the online support request form by accessing the Support section of our web site at Error messages: If you fill a support request, according to an error or problem you get when you are using OroMailCenter, please add this error message in the description of your support request. When an error message is displayed on screen, just click the More info button then click Copy to clipboard. After it, just paste it in your support request description.