onlyoffice windows

HOW TO DEPLOY ONLINE OFFICE SUITE ON YOUR SERVER?

INTRODUCTION

Did you try and decide to deploy ONLYOFFICE on your corporate server? So first of all you need to download the latest version of ONLYOFFICE Server available at Github and SourceForge and select one of the following files:

• ONLYOFFICE-Server.src.zip - a source code that you need to compile. It can be customized and improved under the GNU AGPL v.3 license.
• ONLYOFFICE_CommonServer_Win-install.v8.1.0.exe - the express installation file that allows to skip compilation stage and install ONLYOFFICE Server onto your server. You just need to run the appropriate .exe file and ONLYOFFICE will be installed.

General system requirements and recommendations are:

• Supported Operating System: Microsoft Windows Vista SP2, Microsoft Windows 7, Microsoft Windows 8, Microsoft Windows 8.1, Microsoft Windows Server 2008(R2), Microsoft Windows Server 2012(R2);
• MySQL Server 5.1 or later;
• Processor: 1.7 GHz Pentium or equivalent
• RAM: 1 GB
• Hard Disk: not less than 100 MB
• Web Browser: Microsoft Internet Explorer 9 or later, last versions of Mozilla Firefox, Opera, Safari, Google Chrome.

This guide will show you how to deploy and install ONLYOFFICE Server without efforts using the express installation file.

• inShare
• 

STEP 1. DOWNLOAD ONLYOFFICE

To download the ONLYOFFICE express installation file just go to SourceForge and click theONLYOFFICE_CommonServer_Win-install.v8.1.0.exe link.

In the opened pop-up window click the Save button to save the ONLYOFFICE_CommonServer_Win-install.v8.1.0.exefile to your computer, select a directory to which you would like to save it and wait till the download is completed.

[Back to the Top]

STEP 2. INSTALL THE PREREQUISITES

Before starting the installation process, please check if your computer meets the necessary system requirements. The whole list of the system requirements can be found here.

Find the ONLYOFFICE_CommonServer_Win-install.v8.1.0.exe file you have just downloaded (it will be located in the directory specified at Step 1) and double-click it to start the installation process.

The Prerequisites Wizard will be launched. It will help you to install some prerequisites required to run ONLYOFFICE:

• .NET Framework 4.5 or higher,
• Visual C++2005 SP1 Redistributable,
• Visual C++2010 Redistributable,
• MySQL Connector/ODBC 5.3. or higher,
• MySQL Server 5.5

The Prerequisites Wizard automatically checks if the required components are installed on your PC:

The components that are missing on your PC will be checked. Click the Next button to install the missing components. This process may take some minutes.

[Back to the Top]

STEP 3. INSTALL ONLYOFFICE

As soon as all the components are installed, you can proceed to the main program installation. The ONLYOFFICE Setup Wizard will be launched automatically. Click the Next > button to start the installation process.

Read the GNU AFFERO GENERAL PUBLIC LICENSE carefully and check the I accept the terms in the License Agreement option if you agree with them. Then click the Next > button.

By default ONLYOFFICE Server will be installed to the following folder: C:\Program Files\Ascensio System SIA\ONLYOFFICE\. If needed you can change it clicking the Browse button and selecting the necessary folder on your computer. Then click the Next > button.

Configure the MySQL connection settings. Leave the default parameters for Server, Port and Username (these are the parameters you set during the MySQL database installation). And enter your MySQL password (the password you used while installing the MySQL database).

Please note that you will be not able to change these parameters at this step in case you opt to install MySQL Server during the prerequisites installation as they will be set to default.

The name displayed in the Database field - onlyoffice - is used to identify this database when it is opened by any third party application. So you can change it and enter any other name you like. Then click the Next > button.

If the password you enter is incorrect, the pop-up window with the following error message will be displayed:

Return to the previous step, verify the MySQL connection settings.

Here you can view instructions on how to configure MySQL if it is already installed on your computer for proper operation with ONLYOFFICE

We'll explain the configuration process by the example of MySQL v. 5.1.

Configuration Procedure

1. In the MySQL Server Instance Configuration Wizard, leave the Detailed configuration option checked and click Next.
2. On the next screen, check the Server Machine option and click Next.
3. Check the Transactional Database Only option and click Next.
4. View the default drive where the InnoDB datafile should be placed. You can choose another drive and specify a directory on it. If the database was previously installed on this computer, the path can be disabled. Click Next.
5. Check the Online Transaction Processing (OLTP) option and click Next.
6. Leave the default networking options (i.e. the Enable TCP/IP Networking and Enable Strict Mode options should be checked and the Port Number value should be set to 3306). Click Next.
7. Check the Manual Selected Default Character Set / Collation option and choose the UTF8 character set from the list. Click Next.
8. Leave the default Windows options (the Install as Windows Service and Launch the MySQL Server automatically options should be checked). Click Next.
9. In the Modify Security Settings section:
   • enter and confirm your root password. If the password has been previously set, three entry fields will appear. Type in your current password, a new password and the new password confirmation.
   • check the Enable root access from remote machines box in case the MySQL Server and ONLYOFFICE are installed on different computers.
   Click Next.
10. On the next screen, click the Execute button, wait while the MySQL Server instance is being configured and pressFinish.

As soon as the connection is established, click the Install button to start the installation process. It may take several minutes.

Once the instalation process is completed, click the Finish button to launch ONLYOFFICE.

You will be redirected to the welcome page of your portal.

[Back to the Top]

STEP 4. RUN ONLYOFFICE

For the security reasons the password setup procedure MUST be performed.

Enter a Password you will use to access your ONLYOFFICE portal the next time and confirm it. Your password must be at least 6 characters long.

Specify your email address. The Email Activation message will be sent to the specified email. Follow the link provided in this email to complete your email activation procedure.

On this page you can also:

• view the domain your portal is registered to,
  You can always set an alternative URL for your portal on the portal Settings page. For more information, refer to the Configuration section.
• drop-down the Language list and select an appropriate language to display all portal pages and notification,
  At present ONLYOFFICE is available in 20 languages: English, German, French, Spanish, Russian, Italian, Latvian, Portuguese (Brazilian), Turkish, Greek, Polish, Czech, simplified Chinese, Ukrainian, Vietnamese, Finnish, Portuguese, Azeri, Korean and Japanese. If your language is not yet present in the list of the available ones or the translation to your language is not complete, you may contribute to the translation sending your request atdocumentation@onlyoffice.com.
• set the time zone that corresponds to your location from the Time Zone drop-down list.

When all the parameters are set, click the Save button.

That's all! Your portal is created. Choose one of the available modules to start exploring ONLYOFFICE.

[Back to the Top]

STEP 5. CONNECT ONLYOFFICE EDITORS

ONLYOFFICE Online Editors are not included into the installation but you can connect them to your portal if you have them installed. The installation can be downloaded here.

Once ONLYOFFICE Common Server is installed, you will need to edit the WebStudio\web.appsettings.config file the following way:

• change the default value of the conversion service address:
  <add key="files.docservice.url.converter" value="http://<editors-dns-name>/ConvertService.ashx"/>
• change the default value of the editing service address:
  <add key="files.docservice.url.api" value="http://<editors-dns-name>/OfficeWeb/apps/api/documents/api.js"/>
• change the default value of the storage service address:
  <add key="files.docservice.url.storage" value="http://<editors-dns-name>/FileUploader.ashx"/>

altering the <editors-dns-name> value for the actual service address