306 lines
31 KiB
Plaintext
306 lines
31 KiB
Plaintext
<%@ Control Language="C#" Inherits="BaseContentUserControls"%>
|
||
<%@ Register Namespace="TeamLab.Controls" Assembly="__Code" TagPrefix="cc" %>
|
||
|
||
<script runat="server">
|
||
protected override void Init()
|
||
{
|
||
PageTitle = PageCaption = "Installing ONLYOFFICE Enterprise Edition using AMI";
|
||
MetaKeyWords = "";
|
||
MetaDescription = "";
|
||
var guides = new GuidesModel();
|
||
guides.TitleVideo = "Installing ONLYOFFICE Enterprise Edition using AMI";
|
||
(Page as BasePage).Guides = guides;
|
||
}
|
||
|
||
</script>
|
||
<div class="MainHelpCenter">
|
||
<h1 class="subHeaderFeaturesCaption Guides_Video_Captions">Installing ONLYOFFICE Enterprise Edition using AMI</h1>
|
||
<cc:localizecontent runat="Server" controlname="~/Controls/Help/VariousControls/Versions/DocumentServer/DocumentServer_Current.ascx" />
|
||
<div class="keyword_block">
|
||
<ul>
|
||
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/local-server/local-server.ascx" /></li>
|
||
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/document-server/document-server.ascx" /></li>
|
||
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/docker-version/docker-version.ascx" /></li>
|
||
</ul>
|
||
</div>
|
||
<div class="video_ground video_trips">
|
||
<h2 id="introduction">Introduction</h2>
|
||
<div class="video_ground video_trips">
|
||
<div class="video_text">
|
||
<p>Now you can easily launch the <b>ONLYOFFICE Enterprise Edition</b> instance in the <b>Amazon Web Services</b> cloud infrastructure using the <b>ONLYOFFICE Amazon Machine Image</b> available on the <b>AWS Marketplace</b>.</p>
|
||
<p><a target="_blank" class="links" href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html"><b>The Amazon Machine Image (AMI)</b></a> is a pre-configured template that allows to easily launch an instance, which is a virtual server in the <b>AWS</b> private cloud.</p>
|
||
<p>The <b>ONLYOFFICE Enterprise Edition AMI</b> includes all the necessary components - both the operating system and the software itself, as well as a storage volume - to deploy your web office on a virtual server running under Linux (CentOS).</p>
|
||
<p>Once your <b>ONLYOFFICE Enterprise Edition</b> instance is launched, you can integrate <b>ONLYOFFICE Document Server</b> with one of the file sync and share platforms, such as Alfresco, Confluence, Liferay, Nextcloud, ownCloud, SharePoint, HumHub etc.</p>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
<h2 id="step1"><span class="style_step">Step 1. </span> Choose the necessary ONLYOFFICE AMI and subscribe for the solution</h2>
|
||
<div class="block_of_step">
|
||
<div class="screen_text">
|
||
<p>Log in to your existing <a target="_blank" class="links" href="https://aws.amazon.com/">AWS account</a> or sign up for a new one and go to the <a target="_blank" class="links" href="https://aws.amazon.com/marketplace">AWS Marketplace</a>.</p>
|
||
<p>Find the <a target="_blank" class="links" href="https://aws.amazon.com/marketplace/seller-profile?id=b2557f65-4b3a-4b0e-a96a-d9a9d3b45b60&ref=dtl_B07ZQHPPWN">ONLYOFFICE solution</a> and choose the necessary instance type – for 50, 100, 200 or 400 connections. Connections mean the maximum number of documents that can be edited at the same time. When the maximum value is reached, each next document will open in read-only mode.</p>
|
||
<div class="screen_block">
|
||
<img alt="Choose the necessary ONLYOFFICE AMI" target="img1_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/small/guide118/step1.png")%>" />
|
||
<img alt="Choose the necessary ONLYOFFICE AMI" id="img1_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide118/step1.png")%>" />
|
||
<div target="img1_eventcom_guides" class="screenphoto magnifier"></div>
|
||
</div>
|
||
<p>At the <b>Product Overview</b> page, you can read the description of the software functions.</p>
|
||
<div class="screen_block">
|
||
<img alt="Choose the necessary ONLYOFFICE AMI" target="img2_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/small/guide118/step2.png")%>" />
|
||
<img alt="Choose the necessary ONLYOFFICE AMI" id="img2_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide118/step2.png")%>" />
|
||
<div target="img2_eventcom_guides" class="screenphoto magnifier"></div>
|
||
</div>
|
||
<p>Switch to the <b>Pricing</b> tab to estimate pricing details that depend on some instance parameters:</p>
|
||
<ul>
|
||
<li>Change the <b>Region</b> where the instance will be launched, if necessary. It’s recommended to select a region with a closest location. <b>US East (N. Virginia)</b> is selected by default.</li>
|
||
<li>In the <b>Fulfillment option</b> menu, the 64-bit (x86) Amazon Machine Image (AMI) option is only available.</li>
|
||
<li>In the <b>Software Pricing Details</b> section, choose the Hourly or Annual subscription type.
|
||
<p>The total price includes charges for the ONLYOFFICE software and for the AWS infrastructure services used to deploy this software solution.</p>
|
||
<div class="notehelp">
|
||
<b>Note</b>: to learn more about subscribing to paid AMIs and other pricing details, please refer to the <a target="_blank" class="links" href="https://docs.aws.amazon.com/en_us/AWSEC2/latest/UserGuide/paid-amis.html"><b>AWS documentation</b></a>.
|
||
</div>
|
||
</li>
|
||
</ul>
|
||
<div class="screen_block">
|
||
<img alt="Subscribe for ONLYOFFICE AMI" target="img3_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/small/guide118/step3.png")%>" />
|
||
<img alt="Subscribe for ONLYOFFICE AMI" id="img3_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide118/step3.png")%>" />
|
||
<div target="img3_eventcom_guides" class="screenphoto magnifier"></div>
|
||
</div>
|
||
<p>If you click on the <b>EC2 Instance type</b> displayed in the table (e.g., <code>t3.large</code>), you can see the instance details. The EC2 instance type determines the hardware of the virtual server used to deploy the <b>ONLYOFFICE</b> solution. </p>
|
||
<div class="screen_block">
|
||
<img alt="Subscribe for ONLYOFFICE AMI" target="img4_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/small/guide118/step3-1.png")%>" />
|
||
<img alt="Subscribe for ONLYOFFICE AMI" id="img4_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide118/step3-1.png")%>" />
|
||
<div target="img4_eventcom_guides" class="screenphoto magnifier"></div>
|
||
</div>
|
||
<p>Available instance types differ depending on the selected variant of the <b>ONLYOFFICE Enterprise Edition</b> solution, i.e. on the number of allowed connections.</p>
|
||
<p>The <b>t3.small</b> EC2 Instance type is used for <b>ONLYOFFICE Enterprise Edition (50 connections)</b>. It has the following parameters:</p>
|
||
<ul>
|
||
<li><b>Memory</b>: 2 GB</li>
|
||
<li><b>CPU</b>: 2 virtual cores</li>
|
||
<li><b>Storage</b>: EBS Only</li>
|
||
<li><b>Network</b>: Up to 5 Gigabit Ethernet</li>
|
||
</ul>
|
||
<p>The <b>t3.medium</b> EC2 Instance type is used for <b>ONLYOFFICE Enterprise Edition (100 connections)</b>. It has the following parameters:</p>
|
||
<ul>
|
||
<li><b>Memory</b>: 4 GB</li>
|
||
<li><b>CPU</b>: 2 virtual cores</li>
|
||
<li><b>Storage</b>: EBS Only</li>
|
||
<li><b>Network</b>: Up to 5 Gigabit Ethernet</li>
|
||
</ul>
|
||
<p>The <b>t3.xlarge</b> EC2 Instance type is used for <b>ONLYOFFICE Enterprise Edition (200 connections)</b>. It has the following parameters:</p>
|
||
<ul>
|
||
<li><b>Memory</b>: 16 GB</li>
|
||
<li><b>CPU</b>: 4 virtual cores</li>
|
||
<li><b>Storage</b>: EBS Only</li>
|
||
<li><b>Network</b>: Up to 5 Gigabit Ethernet</li>
|
||
</ul>
|
||
<p>The <b>t3.2xlarge</b> EC2 Instance type is used for <b>ONLYOFFICE Enterprise Edition (400 connections)</b>. It has the following parameters:</p>
|
||
<ul>
|
||
<li><b>Memory</b>: 32 GB</li>
|
||
<li><b>CPU</b>: 8 virtual cores</li>
|
||
<li><b>Storage</b>: EBS Only</li>
|
||
<li><b>Network</b>: Up to 5 Gigabit Ethernet</li>
|
||
</ul>
|
||
<p>Switch to the <b>Usage</b> tab where you can find the following information:</p>
|
||
<ul>
|
||
<li>The <b>Fulfillment Options</b> section displays the AMI characteristics. The ONLYOFFICE AMI has the 64-bit (x86) architecture.</li>
|
||
<li>The <b>Template components</b> section displays the <b>AWS</b> services which are used for this product.
|
||
<ul>
|
||
<li>The <a target="_blank" class="links" href="https://docs.aws.amazon.com/en_us/AWSEC2/latest/UserGuide/AmazonEBS.html"><b>EBS</b></a> service is used to store your ONLYOFFICE data.</li>
|
||
<li>The <a target="_blank" class="links" href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/concepts.html"><b>EC2</b></a> service provides the environment necessary to deploy a virtual server running under CentOS and install the ONLYOFFICE software solution on it.</li>
|
||
</ul>
|
||
</li>
|
||
<li><b>Usage Instructions</b> contain brief recommendations on how to perform initial <b>ONLYOFFICE</b> configuration after launching the instance.</li>
|
||
<li><b>End User License Agreement</b> regulates the terms and conditions upon which the <b>ONLYOFFICE Enterprise Edition</b> solution is provided. </li>
|
||
</ul>
|
||
<div class="screen_block">
|
||
<img alt="Subscribe for ONLYOFFICE AMI" target="img5_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/small/guide118/step4.png")%>" />
|
||
<img alt="Subscribe for ONLYOFFICE AMI" id="img5_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide118/step4.png")%>" />
|
||
<div target="img5_eventcom_guides" class="screenphoto magnifier"></div>
|
||
</div>
|
||
<p>Click the <b>Continue to Subscribe</b> button in the upper right corner. The <b>Subscribe to this software</b> page opens:</p>
|
||
<div class="screen_block">
|
||
<img alt="Subscribe for ONLYOFFICE AMI" target="img6_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/small/guide118/step4-1.png")%>" />
|
||
<img alt="Subscribe for ONLYOFFICE AMI" id="img6_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide118/step4-1.png")%>" />
|
||
<div target="img6_eventcom_guides" class="screenphoto magnifier"></div>
|
||
</div>
|
||
<p>Read the <b>AWS Customer Agreement</b> and click the <b>Accept Terms</b> button. Wait while the subscription is being processed.</p>
|
||
<div class="screen_block">
|
||
<img alt="Subscribe for ONLYOFFICE AMI" target="img7_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/small/guide118/step4-3.png")%>" />
|
||
<img alt="Subscribe for ONLYOFFICE AMI" id="img7_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide118/step4-3.png")%>" />
|
||
<div target="img7_eventcom_guides" class="screenphoto magnifier"></div>
|
||
</div>
|
||
<p>When the current date is displayed in the <b>Effective date</b> field instead of 'Pending', click the <b>Continue to Configuration</b> button in the upper right corner.</p>
|
||
</div>
|
||
</div>
|
||
|
||
<h2 id="step2"><span class="style_step">Step 2. </span> Launch your ONLYOFFICE instance in the AWS cloud</h2>
|
||
<div class="block_of_step">
|
||
<div class="screen_text">
|
||
<p>At the <b>Configure this software</b> page, click the <b>Continue to Launch</b> button in the upper right corner.</p>
|
||
<div class="screen_block">
|
||
<img alt="Launch your ONLYOFFICE instance" target="img9_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/small/guide118/step5.png")%>" />
|
||
<img alt="Launch your ONLYOFFICE instance" id="img9_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide118/step5.png")%>" />
|
||
<div target="img9_eventcom_guides" class="screenphoto magnifier"></div>
|
||
</div>
|
||
<p>The <b>Launch this software</b> page opens. At this page, you can review the <b>Configuration Details</b> once again.</p>
|
||
<p>The <b>Choose Action</b> section allows to select the method you want to use to launch the instance. The <b>Launch from Website</b> option is selected by default. Leave it unchanged to deploy the instance using the <b>Launch Instance Wizard</b> provided at this web page.</p>
|
||
<div class="notehelp"><b>Note</b>: you can also launch your instance through the <b>Amazon EC2 console</b>. To do that, select the <b>Launch through EC2</b> option from the menu and click the <b>Launch</b> button. You will be redirected to the <b>Launch Instance Wizard</b> in your <a target="_blank" class="links" href="https://console.aws.amazon.com/"><b>AWS Management Console</b></a> where you can select an instance type, configure the instance details, add a storage, tags and configure a security group. This guide does not describe such a method of launching the instance.</div>
|
||
<div class="screen_block">
|
||
<img alt="Launch your ONLYOFFICE instance" target="img10_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/small/guide118/step5-1.png")%>" />
|
||
<img alt="Launch your ONLYOFFICE instance" id="img10_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide118/step5-1.png")%>" />
|
||
<div target="img10_eventcom_guides" class="screenphoto magnifier"></div>
|
||
</div>
|
||
<p>In the <b>EC2 Instance Type</b> section, the only option is available (it depends on the previously selected <b>ONLYOFFICE Enterprise Edition</b> instance type with a certain number of allowed connections).</p>
|
||
<p>In the <b>VPC Settings</b> and <b>Subnet Settings</b> sections, leave default settings.</p>
|
||
<p>Now you need to create a new <b>Security group</b> and generate a <b>Key pair</b>.</p>
|
||
<h3>Create a new security group</h3>
|
||
<p>A security group allows to limit access to your instance so that only known IP addresses can access it.</p>
|
||
<p>In the <b>Security Group Settings</b> section, click the <b>Create New Based on Seller Settings</b> button.</p>
|
||
<div class="screen_block">
|
||
<img alt="Launch your ONLYOFFICE instance" target="img11_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/small/guide118/step5-6.png")%>" />
|
||
<img alt="Launch your ONLYOFFICE instance" id="img11_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide118/step5-6.png")%>" />
|
||
<div target="img11_eventcom_guides" class="screenphoto magnifier"></div>
|
||
</div>
|
||
<p>Enter the name of the security group (for example, ONLYOFFICE) and add its description. </p>
|
||
<p>Use the <b>Source (IP or Group)</b> list, to set the necessary rules. You can specify a single IP address, or an IP address range, e.g. <code>10.040.196.230/32</code>.</p>
|
||
<div class="screen_block">
|
||
<img alt="Launch your ONLYOFFICE instance" target="img12_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/small/guide118/security_group.png")%>" />
|
||
<img alt="Launch your ONLYOFFICE instance" id="img12_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide118/security_group.png")%>" />
|
||
<div target="img12_eventcom_guides" class="screenphoto magnifier"></div>
|
||
</div>
|
||
<p>The rules are specified for the following ports:</p>
|
||
<ul>
|
||
<li><b>SSH</b> - port 22 is used to access your server using an SSH client over the SSH protocol.</li>
|
||
<li><b>HTTP</b> - port 80 is used to access your web office via a web browser over the HTTP protocol.</li>
|
||
<li><b>HTTPS</b> - port 443 is used to access your web office via a web browser over the secure HTTPS protocol.</li>
|
||
</ul>
|
||
<p>When ready, click the <b>Save</b> button.</p>
|
||
<h3>Generate a key pair</h3>
|
||
<p>A key pair is required to securely connect to your instance via the SSH protocol using an SSH client like <b>PuTTY</b> or <b>OpenSSH</b>.</p>
|
||
<div class="screen_block">
|
||
<img alt="Launch your ONLYOFFICE instance" target="img13_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/small/guide118/step5-6.png")%>" />
|
||
<img alt="Launch your ONLYOFFICE instance" id="img13_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide118/step5-6.png")%>" />
|
||
<div target="img13_eventcom_guides" class="screenphoto magnifier"></div>
|
||
</div>
|
||
<p>In the <b>Key Pair Settings</b> section, click the <b>Create a key pair in EC2</b> link.</p>
|
||
<p>The <b>AWS Management Console</b> will open in a new browser tab.</p>
|
||
<div class="screen_block">
|
||
<img alt="Launch your ONLYOFFICE instance" target="img15_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/small/guide118/key_pair1.png")%>" />
|
||
<img alt="Launch your ONLYOFFICE instance" id="img15_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide118/key_pair1.png")%>" />
|
||
<div target="img15_eventcom_guides" class="screenphoto magnifier"></div>
|
||
</div>
|
||
<div class="notehelp">verify that the <b>AWS Region</b> displayed at the top toolbar is the same that the one where you want to launch the instance.</div>
|
||
<p>Click the <b>Create key pair</b> button in the upper right corner. Enter the key pair name (e.g. ONLYOFFICE) in the corresponding field and select the file format depending on which software you want to use to connect to your instance remotely:</p>
|
||
<ul>
|
||
<li><code>pem</code> is used for <b>OpenSSH</b></li>
|
||
<li><code>ppk</code> is used for <b>PuTTY</b></li>
|
||
</ul>
|
||
<p>Click the <b>Create key pair</b> button below.</p>
|
||
<p>Your public key will be stored in the <b>AWS EC2</b>. The <code>.pem/.ppk</code> file that contains your private key will be downloaded to your local machine and stored in the default <b>Downloads</b> folder. Please copy it and store in a safe place.</p>
|
||
<div class="screen_block">
|
||
<img alt="Launch your ONLYOFFICE instance" target="img16_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/small/guide118/key_pair2.png")%>" />
|
||
<img alt="Launch your ONLYOFFICE instance" id="img16_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide118/key_pair2.png")%>" />
|
||
<div target="img16_eventcom_guides" class="screenphoto magnifier"></div>
|
||
</div>
|
||
<p>Return to the <b>AWS Marketplace</b>, refresh the key pair field using the icon to the right of it and select the created key pair from the list. </p>
|
||
<div class="screen_block">
|
||
<img alt="Launch your ONLYOFFICE instance" target="img17_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/small/guide118/step9.png")%>" />
|
||
<img alt="Launch your ONLYOFFICE instance" id="img17_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide118/step9.png")%>" />
|
||
<div target="img17_eventcom_guides" class="screenphoto magnifier"></div>
|
||
</div>
|
||
<p>After that, the <b>Launch</b> button becomes unlocked. Click the <b>Launch</b> button and wait while the instance is being deployed. When ready, the message about the successful deployment appears.</p>
|
||
<div class="screen_block">
|
||
<img alt="Launch your ONLYOFFICE instance" target="img18_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/small/guide118/step10.png")%>" />
|
||
<img alt="Launch your ONLYOFFICE instance" id="img18_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide118/step10.png")%>" />
|
||
<div target="img18_eventcom_guides" class="screenphoto magnifier"></div>
|
||
</div>
|
||
<p>Click the <b>EC2 Console</b> link in this message to open the instance details in the <b>AWS Management Console</b>.</p>
|
||
<div class="screen_block">
|
||
<img alt="Launch your ONLYOFFICE instance" target="img19_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/small/guide118/step11.png")%>" />
|
||
<img alt="Launch your ONLYOFFICE instance" id="img19_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide118/step11.png")%>" />
|
||
<div target="img19_eventcom_guides" class="screenphoto magnifier"></div>
|
||
</div>
|
||
<p>It can take some time for the instance to become completely functional after you launched it. Make sure that the instance status has changed from <code>'pending'</code> to <code>'running'</code> in the <b>Instance State</b> column and verify that the instance has passed all status checks. This information is displayed in the <b>Status Checks</b> column.</p>
|
||
<p>Then you can connect to your instance via SSH to enable test examples and check the solution functionality via a web browser.</p>
|
||
</div>
|
||
</div>
|
||
|
||
<h2 id="step3"><span class="style_step">Step 3. </span>Connect to your server via SSH</h2>
|
||
<div class="block_of_step">
|
||
<div class="screen_text">
|
||
<p>Once the instance is running, you can access it via SSH using the username <code>centos</code> and your SSH private key.</p>
|
||
<p>To connect to your virtual server via SSH you’ll also need to use the <b>Public DNS</b> or <b>IP address</b> of the instance. </p>
|
||
<p>They can be found in the <b>AWS Management Console</b>. Switch to the <b>Instances</b> section in the left menu, choose your region (<b>US East (N. Virginia)</b> by default) and select your <b>ONLYOFFICE</b> instance in the list to open the instance details. </p>
|
||
<p>If you move the mouse cursor over the <b>Public DNS (IPv4)</b> or <b>IPv4 Public IP</b> at the <b>Description</b> tab, the <b>Copy to clipboard</b> option appears. Click it to copy the necessary value.</p>
|
||
<div class="screen_block">
|
||
<img alt="Access your portal via a web browser" target="img20_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/small/guide118/step12.png")%>" />
|
||
<img alt="Access your portal via a web browser" id="img20_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide118/step12.png")%>" />
|
||
<div target="img20_eventcom_guides" class="screenphoto magnifier"></div>
|
||
</div>
|
||
<p>On Windows, you can use the <b>PuTTY</b> utility.</p>
|
||
<p>The <b>AWS</b> private key file generated while deploying the instance is used for authentication instead of a password.</p>
|
||
<p>Launch <b>PuTTY</b>. On the left-side navigation panel, open the <b>Connection</b> -> <b>SSH</b> -> <b>Auth</b> section. Go to the <b>Authentication parameters</b> -> <b>Private key file for authentication</b> section, click the <b>Browse</b> button and find the path to the <code>.ppk</code> file stored on your local machine.</p>
|
||
<div class="screen_block">
|
||
<img alt="Connect to your server via SSH" target="img24_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/small/guide118/putty1.png")%>" />
|
||
<img alt="Connect to your server via SSH" id="img24_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide118/putty1.png")%>" />
|
||
<div target="img24_eventcom_guides" class="screenphoto magnifier"></div>
|
||
</div>
|
||
<p>Return to the <b>Session</b> section in the left-side navigation panel. Enter the instance <b>Public DNS</b> or <b>IP address</b> into the <b>Host Name or IP address</b> field, make sure that port 22 is specified and the SSH connection type is selected and click the <b>Open</b> button.</p>
|
||
<div class="screen_block">
|
||
<img alt="Connect to your server via SSH" target="img25_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/small/guide118/putty2.png")%>" />
|
||
<img alt="Connect to your server via SSH" id="img25_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide118/putty2.png")%>" />
|
||
<div target="img25_eventcom_guides" class="screenphoto magnifier"></div>
|
||
</div>
|
||
<p>Then click <b>Yes</b> in the <b>PuTTY Security Alert</b> window. Type in the username <code>centos</code> and press <b>Enter</b>.</p>
|
||
<div class="screen_block">
|
||
<img alt="Connect to your server via SSH" target="img26_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/small/guide118/putty3.png")%>" />
|
||
<img alt="Connect to your server via SSH" id="img26_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide118/putty3.png")%>" />
|
||
<div target="img26_eventcom_guides" class="screenphoto magnifier"></div>
|
||
</div>
|
||
<p>On Linux, you can use an SSH client like <b>OpenSSH</b>. </p>
|
||
<p>You’ll need to specify a path to the <code>.pem</code> file with your private key stored on your local machine, the <code>centos</code> username and your instance <code>IP address</code> or <code>Public DNS</code>.</p>
|
||
<p>Enter the following command in your terminal specifying the actual values for the <code>.pem</code> file path and the <b>IP Address</b>:</p>
|
||
<pre><code>ssh -i /path/onlyoffice.pem centos@your_instance_ip</code></pre>
|
||
<p>Type <code>yes</code> to continue connecting to the server. For more information, you can refer to the <a target="_blank" class="links" href="https://docs.aws.amazon.com/en_us/AWSEC2/latest/UserGuide/AccessingInstancesLinux.html">AWS documentation</a>.</p>
|
||
<p>To explore the solution functionality, enable our test example which will allow you to upload your local files for testing. To do that, execute the following command:</p>
|
||
<pre><code>
|
||
sudo docker exec $(sudo docker ps -q) sudo supervisorctl start ds:example
|
||
</code></pre>
|
||
<p>Add the example to the autostart:</p>
|
||
<pre><code>
|
||
sudo docker exec $(sudo docker ps -q) sudo sed 's,autostart=false,autostart=true,' -i /etc/supervisor/conf.d/ds-example.conf
|
||
</code></pre>
|
||
<div class="screen_block">
|
||
<img alt="Enable test examples" target="img27_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/small/guide118/putty4.png")%>" />
|
||
<img alt="Enable test examples" id="img27_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide118/putty4.png")%>" />
|
||
<div target="img27_eventcom_guides" class="screenphoto magnifier"></div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
<h2 id="step4"><span class="style_step">Step 4. </span>Access your Enterprise Edition via a web browser</h2>
|
||
<div class="block_of_step">
|
||
<div class="screen_text">
|
||
<p>Once the example is started, enter <code>http://<public IP address>/example/</code> into a web browser address bar replacing <code><public IP address></code> with the public IP address or public DNS provided by Amazon.</p>
|
||
<div class="screen_block">
|
||
<img alt="Access Enterprise Edition via a web browser" target="img21_eventcom_guides" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/small/guide118/integration_edition_example.png")%>" />
|
||
<img alt="Access Enterprise Edition via a web browser" id="img21_eventcom_guides" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/Guides/big/guide118/integration_edition_example.png")%>" />
|
||
<div target="img21_eventcom_guides" class="screenphoto magnifier"></div>
|
||
</div>
|
||
<p>The <b>Enterprise Edition</b> example page opens. Here you can:</p>
|
||
<ol>
|
||
<li>Upload a file stored on your PC using the <b>Upload File</b> option.</li>
|
||
<li>Create a new blank text document, spreadsheet or presentation using the <b>Create Document</b>, <b>Create Spreadsheet</b>, or <b>Create Presentation</b> options. If you want to create a file with a sample content, first check the <b>Create a file filled with sample content</b> box.</li>
|
||
</ol>
|
||
<p>The uploaded or created file will open in a new browser tab with the corresponding <b>ONLYOFFICE Online Editor</b> so that you can test editing capabilities.</p>
|
||
<p>The file will also appear in the <b>Your documents</b> list at the <b>Enterprise Edition</b> example page.</p>
|
||
<p>If you want to check co-editing capabilities, select another test user from the <b>Username</b> list and then click on the same document in the <b>Your documents</b> list to open it in a new browser tab.</p>
|
||
<p>To easily integrate <b>ONLYOFFICE Document Server</b> with one of the business platforms like Alfresco, Confluence, Liferay, Nextcloud, ownCloud, SharePoint, HumHub etc., you can use integration connectors for these solutions as it is described here: <a target="_blank" class="links" href="https://api.onlyoffice.com/editors/plugins">https://api.onlyoffice.com/editors/plugins</a> Use the public IP address or public DNS to specify the <b>Document Server</b> address in your web application settings, e.g. <code>http://<public IP address>/</code></p>
|
||
<p>To integrate <b>ONLYOFFICE Document Server</b> with your own web application, you can refer to the API Documentation <a target="_blank" class="links" href="https://api.onlyoffice.com/editors/basic">https://api.onlyoffice.com/editors/basic</a></p>
|
||
</div>
|
||
</div>
|
||
|
||
|
||
</div> |