How To Use Ensim Pro 3.7.017 with Fedora Core 2

How to use Ensim Pro 3.7.0-17

With Fedora Core 2By Joseph Charnin

Introduction

What is Ensim Pro 3.7.0-17

Ensim Pro 3.7.0-17 is a graphic interface that allows ender users to maintain their servers without having to use any code. This easy to use interface allows the end user to connect to their dedicated server and manage their sites and services with an Internet browser. Ensim makes it so that SSH does not have to be used to add or remove services.

The scope of this manual is to help guide individuals through setting up a new web server with Ensim on it. These instructions explain how to use Ensim on a server equipped with Fedora Core 2 and MySQL 3.23. After completion of these instructions the end user should know how to:

Add a Domain Name o Add an IP-Based Site o Add a Name Based Site

Add MySQL to Websites Use FTP with Ensim Be able to rest Ensim Admin password for a Linux Server

Warning: Using SSH to update services will break Ensim, site(s), and services.

Before Getting started

It is assumed that the end user is already familiar with Zencart and how to use its’ web interface. Ensim Pro 3.7.0-17 is fully compatible with Zencart and has the same dependencies on MySQL and PHP. The benefit of this dependency is that Ensim will apply regular security patches, but will not update these services.

It is also assumed that the reader has previous experience with PHPmyAdmin, MySQL, and FTP. The use of the listed tools will not be covered; this text will help a web-designer or Webmaster to setup Ensim so that websites can be implemented.

What you need to get started

Internet Connection Dedicated Server running Fedora Core 2 Ensim Pro 3.7.0-17 license Server IP and domain names Server username and password Web Browser FTP Client

Getting started

Logging into EnsimTo log into the Ensim control panel you must:

1. Open a web browser. 2. Enter https://base_ip:19638/webhost into the address bar.

Wait for the page to load, this may take up to 30 seconds.

3. Provide the username and password in the given fields. In order to login you must have the administrator account information.

Note: You can only log into Ensim as an Administrator, on a Linux server ‘Root’ does not have an account in Ensim. After you have logged into your web appliance you’ll see a screen that looks like this first one:

On your left hand side is the system menu, which contains useful links to control the server. These links will be explained throughout this manual.

Adding a Domain Name

Adding an IP-Based Site If you are using a personal SSL you will need to add the site as an IP-Based site in order for the SSL to work.

These IP’s can be requested and added to the server for an additional monthly

charge.

Please contact me at 954-682-0260 or by email [email protected] for this service.

Note: The Base IP can only be used for Name-Based hosting. To host an IP-based site you’re going to need additional IP’s. Once the IP addresses have been acquired they will be added into Ensim for you.

1. On the home screen in the right pane under ‘Sites’ click on ‘Add IP-Based Site’ You will be directed to the page below:

This form must be filled out in order to be able to add the IP-Based site.

2. For the site name do not use www or http, only the domain name is needed. Site: domain_name.com

3. The IP address was provided with the server information or in an additional email sent from [email protected].

IP address: 192.168.0.100

4. Administrator Username needs to be in this format:

user_name

The Username can be any name, but it must be unique because it will be used as your ftp login ID for this domain name.

Adding a Name Based Site Adding a name-based site is simple; the only requirements are the Base IP, user_name and password.

No additional IP’s are required for this to work. Once you decided which domain name needs to be added to the server, do the following:

1. Log into Ensim 2. Click on the home screen under ‘sites’ 3. Click on ‘Add Name-Based Site’

You will be directed to the page below:

Here the only information that is needed is: 4. For the site name do not use www or http, only the domain name is needed.

Site: domain_name.com

5. Administrator Username needs to be in this format: user_name

6. Click on ‘Add Site’ once you have filled out this information.

Note: Even if the domain name has not propagated you can still view the domain by going to http://base_ip/site_name/.

Adding MySQL to sitesThe server administrator is responsible for allotting the number of databases and the space to be

provided. Only a ‘site administrator’ can configure the MySQL database.

1. As the server administrator go, to Sites => lists sites 2. Click Edit on the site that needs the database

This is listed below actions.

3. Scroll down till you see the MySQL section which is shown below:

4. Fill out the three boxes listed. 5. Check the box next to MySQL

This needs to be checked in order for the ‘site administrator’ to be able to create a database.

Note: If a site requires more then one database here is where that extra database can be added.

6. Next you must become the site administrator. To do this you need to go to Sites => list sites and click on the domain name. This will log you into the site, from here

7. Click on Services from the System Menu. Once under services you can 8. Click on edit next to MySQL and you will be brought to the screen below:

This is where databases are maintained. Note: If they click on MySQL Administration Tool you will be prompted for a username and password. This should be the Database Administrator name that was created by the server admin; the password is the same as for the site administrators’ login. Once you login you will be directed to PHPmyAdmin.

Setting up FTP Note: Once a domain name has been created in Ensim an FTP directory and user ID will automatically be generated.

If the domain name has already propagated then you can ftp directly to the domain name if not you will have to use the IP address.

1. Open an FTP client2. The login ID will be the administrator name for that domain name @ the domain name.

[email protected]

3. The URL is just the domain name.

Once logged in you only need to browse to the ‘html’ folder and upload files. Below is the direct path to where all files should be uploaded.

/home/virtual/domain.xxx/var/www/html

Troubleshooting

How to Rest Ensim Admin password for a Linux server If you have lost or forgotten the login ID and password for Ensim on a Linux server then you will need to reset it. You will need to SSH into the server as root and then issue the command below. ‘$’ /usr/sbin/passwd_appl_amin admin Here is a screenshot of this command being used.

Notice that the word “admin” appears twice, this is because the last one represents the username, which by default is “admin”. It then will prompt for the new password and then again to confirm it, because you are root it will not ask for the old password.

GlossaryDomain Name - The name of a company, organization or person's Internet connection, which then becomes part of their Web address. For instance, in [email protected], "abc" is the domain name.

FTP - FTP stands for File Transfer Protocol, and is a method to transfer files between two computers and a method to gain access to files stored in a remote computer. For web hosting, you use FTP over the Internet to transfer files from your computer hard drive to a remote web server or download website files from a remote web server to your computer.

IP - Internet Protocol. The transport layer protocol used as a basis of the Internet. IP enables information to be routed from one network to another in packets, which are then reassembled when they reach their destination.

IP Based – A website that requires an IP address that is not shared.

Name Based – A website that utilizes the server’s IP and a directory structure to host a website.

Propagation - The process of disseminating information throughout a system. Example 1 - After you register a new Internet domain name, the information is propagated across the Internet when local DNS servers update their databases from a central file. Note: Not all local DNS databases are updated with the same frequency (hourly, daily, every other day, etc.). Example 2 - Password changes often must be made on several different servers and will not complete propagation until all affected servers update their databases. Updating (rehashing) a given server's database is usually an automated process that is performed at specific intervals.

Services – Programs that run on the server such as apache, MySQL, PERL, PHP, cron jobs, etc…

SSH – Secure Shell is a terminal program that will utilize a current Internet connection to connect to a server located on the web by IP and port location.

SSL - Secure Sockets Layer. A protocol from Netscape Communications Corp. designed to provide secure communications on the Internet.

Task AnalysisIntroduction

Understanding Ensim Pro 3.7.0-17Learn what is needed and expected of the user

Before you get started

What you need to get startedInternet connectionA dedicated Fedora Core 2 serverDedicated Server running Fedora Core 2Ensim Pro 3.7.0-17 license

What you need to understandBasic understanding of web hostingZenCartMySQLFTP

Getting startedLogging into Ensim

Learn to log into the interfaceAdding a Domain Name

Adding an IP-Based Site Adding a Name Based Site

MySQL on Ensim Learn to add databases

Ensim FTP Learn basic FTP connection information

Troubleshooting Rest Ensim Admin password for a Linux server

Learn to reset Admin passwordGlossary