×
Community Blog How to Install CouchCMS on Ubuntu 16.04 – Part 1 LAMP Stack Setup

How to Install CouchCMS on Ubuntu 16.04 – Part 1 LAMP Stack Setup

In this tutorial, we will be setting up CouchCMS on an Alibaba Cloud Elastic Compute Service (ECS) instance with Ubuntu 16.04.

By Arslan Ud Din Shafiq, Alibaba Cloud Tech Share Author. Tech Share is Alibaba Cloud's incentive program to encourage the sharing of technical knowledge and best practices within the cloud community.

CouchCMS is an open source content management system (CMS) that is available under Common Public Attribution License Version 1.0 (CPAL-1.0). CouchCMS is for designers; no knowledge or prior experience with PHP is required. It is also secure and have been used to make thousands of websites.

CouchCMS does not restrict its installation to any specific operating system (OS). You can use any operating system (OS) of your choice; however, the installation steps would vary according to the choice of operating system.

In this tutorial, we will be using an Alibaba Cloud Elastic Compute Service (ECS) insatnce with Ubuntu 16.04 installed on it.

This tutorial is divided into 2 sub-tutorials.

  1. In the first part, we will add super user, setup firewalls, setup Apache Server, MySQL Server, install PHP 7 and its various modules, and install various other necessary packages.
  2. In the second part, we will learn to configure your domain, creating virtual host and installing Let's Encrypt SSL to your website. We will also be installing CouchCMS and configuring it.

Prerequisites:

  1. You must have Alibaba Cloud Elastic Compute Service (ECS) activated and verified your valid payment method. If you are a new user, you can get free $300 credits in your Alibaba Cloud account. If you don't know about how to setup your ECS instance, you can refer to this tutorial.
  2. A domain name registered from Alibaba Cloud. If you have already registered a domain from Alibaba Cloud or any other host, you can update its domain nameserver records.
  3. You should setup your server's hostname.
  4. Access to VNC console in your Alibaba Cloud or SSH client installed in your PC.

Add a User with Root Privileges

After completing the prerequisites, login as root user with your root username & password via SSH client (e.g. Putty – You can get Putty from https://www.putty.org ) or VNC console available in your Alibaba Cloud account dashboard.

In the first step, you will add a new user and give it sudo privileges. Sudo privileges will allow this username to make administrative changes on system when required. This user will be used to login from via SSH for everyday use. Once you have added this user, to keep your server secure from various attacks, you will disable the remote root access to root user.

  1. To create a new user account, use the following command:

    # adduser aareez

    where "aareez" can be any username of your choice.

    Now set your desired password and retype your desired password. Then, enter your full name, room number, work phone, home phone, and other. After entering the information, hit Enter key. To confirm the data is correct, type 'Y' and hit Enter key.


  2. Now assign username to sudo user's group to give administrative privileges. For this, we will check /etc/sudoers file and see whether sudoers group is enabled or not. For this purpose, we will execute the following command.

    # visudo


  3. After executing the above command, a file will be opened, find the following lines in the opened file.

    1

    Sometimes by default the second line %sudo ALL=(ALL:ALL) ALL is commented (starting with hash #), due to which even after adding username to sudoers, it gives error on using sudo. To prevent this issue, if this line starts with '#' sign, remove this symbol and save the changes by typing :x and then hit Enter key to save.


  4. Now you will add your username "aareez" to the "sudo" group by executing the following command:

    # adduser aareez sudo

    After execution of the above command, you can verify the membership of for that group by executing the following command:

    # groups aareez

    Your username has been successfully added to sudoers group and it is able to execute any root command.


  5. Now, log in by using your new username and password. OR Use the following command to switch user:

    # su – aareez

    You can see that you have been logged in from your new account now. If you want to verify this, you can use the command below:

    # whoami

Update Your Ubuntu 16.04 System

Before proceeding with installation of any kind of package, use the following command to update your Ubuntu system. To execute this command, remember to login from non-root user with sudo privileges.

# sudo apt-get update

You will be prompted to enter your password. Now type your password and hit Enter key and wait for updating.

Now execute the following command to upgrade packages:

# sudo apt-get -y upgrade

You will be prompted to configurations below. Select the option to install the package maintainer's version

Install Apache Web Server

  1. To install the apache web-server, you will need to execute the following command:

    # sudo apt-get -y install apache2


  2. After installation, you will need to enable apache server to run automatically when you boot your ECS. For that, execute the commands below:

    # sudo systemctl enable apache2


  3. To start your apache server, execute the following command:

    # sudo systemctl start apache2


  4. To ensure that your DocumentRoot directive is pointing to correct directory, check your Apache configuration file by using the following command:

    # sudo nano /etc/apache2/sites-enabled/000-default.conf

    Note: The configuration for DocumentRoot should look as DocumentRoot /var/www/html

    Press Ctrl + X, to exit from editor.


  5. Now execute the following command to enable mod_rewrite module in apache.

    # sudo a2enmod rewrite


  6. To make the changes work correctly, we will need to restart apache. To do so, execute the command below:

    # sudo systemctl restart apache2


  7. To verify, you have successfully installed Apache Web Server. Open http://47.254.28.97 in your web browser where 47.254.28.97 is my ECS IP address. Remember to replace it with your ECS IP address. You will see the following page.

    2

Setup Firewalls for HTTP and HTTPS

  1. If you have activated firewalls, you will have to define a rule in Alibaba Cloud security group for your cloud server to add exception for port 80/tcp, 443/tcp. You can enable these ports while creating ECS instance, but in case, if you have forgotten to unblock these ports, you can follow the procedure below. By default, these ports are blocked by the firewalls.

    To do this, go to your Elastic Compute Service section. Click on More for the ECS you are using for ImpressPages CMS and click Security Group Configuration.

    Click on Configure Rules and then click on Quickly Create Rules.

    Add the configurations as shown in screenshot below & click OK.

    3

Install PHP 7.0

  1. To install PHP 7.0 on Debian 9 along with its modules required for ProcessWire CMS, you will need to execute the following command.

    # sudo apt-get -y install php php-gd php-mbstring php-common php-MariaDB php-imagick php-xml libapache2-mod-php php-curl php-zip

Let's install MySQL Server

  1. Ubuntu 16.04 uses MySQL by default. To install MySQL, use the following command:

    # sudo apt-get -y install mysql-server


  2. After executing the above command, you will be prompted to type new password. This password will be used to access MySQL server. Type your new password that you want to set and hit Enter key.
  3. You will be prompted to repeat the same password. Type same password that you typed in previous screen and hit Enter key.
  4. After successful installation of MySQL, you will see the following screen.

    You can also use Alibaba Cloud Aspara DB for RDS as an alternative. Alibaba Cloud AsparaDB for RDS frees you from managing a database and you can focus on your business. It also provides protection against SQL injections, network attacks, brute force attacks and many other types of database attacks. It is highly scalable, highly available, and easy to use.


  5. After successful installation, enable MySQL server to start automatically when system reboot. To do so, use the following commands:

    # sudo systemctl enable mysql


  6. To start MySQL server, execute the command below:

    # sudo systemctl start mysql


  7. Now to secure your MySQL server, execute the command:

    # sudo mysql_secure_installation

    The root password will be blank by default, just hit enter button to proceed and select 'Y' and choose your password.

    You have successfully secured your MariaDB server.

Install Unzip

  1. To unzip any zip folder, you will require an unzipping tool. To do so, use the following command:

    # sudo yum -y install unzip

Conclusion

We have successfully installed LAMP Stack & other necessary packages to continue with second part of How to install CouchCMS on Ubuntu 16.04 tutorial. In the next part, we will learn how configure your domain in Alibaba Cloud DNS, how to create virtual host to point your domain name to your ECS IP address and how to finally install CouchCMS on our ECS instance.

1 1 0
Share on

Alibaba Clouder

2,605 posts | 747 followers

You may also like

Comments

Arslan ud Din Shafiq October 26, 2018 at 5:10 am

Couch CMS Thumbs up!