Server Management Tool (SMT) 4.1. SMT 4.1 User s Guide (Linux Version)

Transcription

1 Page 1 of 102 Server Management Tool (SMT) 4.1 User s Guide (Linux Version) Advanced Internet Technologies, Inc. AIT Center November 3, 2005 Revision History: This is version 4.1 of the SMT User s Guide for Linux. All updates to this document will be noted below. Version 4.1 Updated Graphical User Interface. Revised functions for POP and aliasing, including mail lists, virtual host , and auto responders. Updated navigation from version 4.0 to include Add functions rather than Provision functions. Updated interfaces for FrontPage installation Updated interfaces for Virtual Host Control Panel (vpanel) installation. Updated interface for Anti-Spam Service, when ordered. Updated for installation of Blog application. Version 4.0 Updated Graphical User Interface. Ability for I-MHIP plans to add and remove domains by the SMT functions. Integration of Billing Director into the SMT Interface. Preface: This document is the user s manual for the Server Management Tool 4.1 offered by AIT to all Linux web hosting customers. Target Audience: AIT Customers

2 Page 2 of 102 Table of Contents To view a section, click on the link. This will take you directly to the area of your choice. 1.0 Introduction 2.0 Help 3.0 Bandwidth 3.1 Bandwidth for the previous day 3.2 Bandwidth by month 3.3 Bandwidth calendar 4.0 Server Info 4.1 Installed Perl Modules 4.2 Disk Utilization 4.3 Viewing Disk Usage by Day 5.0 Customer Care Center 6.0 Customer Console 6.1 Add (default view) Virtual and Dedicated Servers Create a Virtual Host Control Panel 6.2 Manage 7.0 Web Services 7.1 Add (default view) Add Virtual Host Enable Virtual Host Logs Password Protected Directories Add Web Stats Analyzer Install Shopping Cart (MCart) Install Webmail for Virtual Host Install Bloggin for Virtual Host Install cgi-bin for Virtual Host Install Web Stats for Virtual Host Install Chat for Virtual Host Install msql Install mysql Install Support Queue/CRM Install FrontPage for a Virtual Host Install File Manager for a Virtual Host Install Guestbook 7.2 Manage Manage Virtual Hosts Add Mirror Search for Virtual Host Disable Virtual Host Rename Virtual Host Delete a Virtual Host Change Your Main Server Password Manage msql Server Manage mysql Server Check Perl Scripts for Common Errors Reset WWW Log Files Untar a File Set All CGI to Execute Enable/Disable Telnet

3 Page 3 of Mail Services 8.1 Add (default view) Add Accounts Add Mail List Add Addresses to a Mail List Display List of Addresses in a Mail List Remove Address to a Mail List Setup Forwarding Configure Responder 8.2 Manage (Mail Services) Manage Accounts Clear Mail Modify User Delete User Manage Mail Lists Delete Mail Lists Manage Forwarding Configure Default Mail Drop View Aliases Reset Anti-Relay Data File Remove Auto Responders Spam Prevention Tool 9.0 FTP Services 9.1 Add (default view) Create FTP Account(s) Setup Anonymous FTP 9.2 Manage 9.3 Manage FTP Accounts 9.4 Edit FTP Login Message 10.0 Additional Services 10.1 Order 10.2 Manage Anti-Spam Service Billing Director Etools Manage Payment Gateway Premium Tech Support Program Director Utilize DB Manager Web Stats Analyzer Webmail

4 Page 4 of 102 Introduction The Introduction screen can be seen by users going in a web browser to or The login for the SMT 4.1 is always cpanel without the quotes, and the password is always the main server password. If this has not been changed by the user, then it is the same password that AIT provided the user after the setup of the account. Once logged in, the user will see the SMT Introduction screen, which should look something like what is displayed below in Figure 1-1. Figure 1-1 If you are a first time user of the SMT 4.1, please review the instructions indicated in the middle of the screen.

5 Page 5 of 102 Help Throughout the SMT 4.1 interface, you will see the following icon (Figure 2-1). This icon is a short help section and is displayed on almost all of the interfaces a user will use in the SMT 4.1. Figure 2-1 Also, the Help link at the top of the screen provides the user with simple links to areas that provide additional help. These areas include AIT101 for Beginners, Frequently Asked Questions (FAQ s), and other support systems. Figure 2-2 below shows an example of this screen. As an added benefit of this User s Guide, we have added in sections named Why would I need to know this? which are placed in specific areas in the User s Guide to show the value of particular features. Figure 2-2

6 Page 6 of 102 Bandwidth The Bandwidth link is located under Home in the navigation menu, and is also located on the top of the screen. Once the page loads, the user will see something like what is in Figure 3-1 below. This interface shows the data transfer that the user s account has used during a specific period of time. This graphically displays the amount of data transferred for HTTP, SMTP, POP and FTP services, as well as other Internet services that are less common. Also, this interface displays the raw data that can be viewed in several different formats. Figure 3-1 Bandwidth for the previous day On the upper right hand corner of the interface, the user will see the data transferred, by service, for the past 24 hours. Figure 3-2 below shows an example. Figure 3-2 Bandwidth by month Figure 3-3 below shows the total data transferred for the month. The bandwidth total is listed on the far right hand side, and each service common to web hosting is listed to the left of the total.

7 Page 7 of 102 Figure 3-3 Bandwidth calendar On the upper left hand side, a user will notice a calendar. If the user selects a date by clicking on a day of the month, the right hand side of the interface will update with the data transfer information for the date selected. The user can select the year and month options as well by clicking the drop down menus or by clicking the arrow buttons to the left and right of the month/date drop down menus. Figure 3-4 below shows an example of the calendar and how it displays. Figure 3-4 Why would I need to know this? This information is good for analyzing site traffic, and overall bandwidth usage. This tool will prevent your account with AIT from going over its allotted data transfer limit without you knowing ahead of time.

8 Page 8 of 102 Server Info The Server Info link, located on the top of the screen or under Home in the sidebar navigation, can be used to determine the operating system, and the versions of software and applications installed on the user s account. Also, this area has separate links to show the installed Perl modules, and the Detailed Disk Utilization. Figure 4-1 below shows the default screen for Server Info. Figure 4-1 Installed Perl Modules Figure 4-2 below shows the results of clicking the Click to View link beside the Installed Perl Modules. This list shows the Perl modules, by name, which are installed on the server. If the user does not see modules that need to be installed on the account, the user should download or obtain a copy of the module, and put it on

9 Page 9 of 102 the server in a directory in the root of the server. Then, proceed to the Online Customer Care Center and order the Perl Module installation. Why would I need to know this? AIT charges to install additional Perl modules, so before requesting extra modules and paying to have the installed, the user should know what Perl modules come with the account by default. Figure 4-2

10 Page 10 of 102 Disk Utilization Also, the bar at the bottom of the Server Info page is a link for Click to View for disk utilization. This provides the user with a breakdown, directory by directory on the server, of how much disk usage is being used and in what directory. When run, the report will look something like Figure 4-3 below. Figure 4-3 Why would I need to know this? Much like the Traffic Monitor that is listed in the beginning of the User s Guide, this tool shows users what their disk utilization is at any time, along with a history (see below) of disk usage for the past 30 to 60 days. This will ensure the user stays within the allotment that comes with their AIT hosting package.

11 Page 11 of 102 Viewing Disk Usage by Day When on the screen displayed in Figure 4-3 above, a user will notice two links at the top of the page. These links are for the current month disk usage by day, and for the previous month s disk usage by day. When these links are clicked, they will display something like what is displayed in Figure 4-4 below. This is the total in MB per day. Each day is listed on a separate line; disk usage for each day is to the left of the date. Figure 4-4

12 Page 12 of 102 Customer Care Center The AIT Online Customer Care center is used to order new products and services. To login, use your customer number and your billing password. If a user has forgotten their password, they can click the link below the login section (See Figure 5-1 below) and provide their customer number. The password will be ed to the account owner. If a user has forgotten their Customer number, the AIT Sales team can provide it after verifying that the person claiming to be the account owner really is. In addition, the Care Center allows users to view their most recent invoices and statements. For the best view of all transactions, use the View Statement option available after login. Figure 5-1

13 Page 13 of 102 Customer Console The Customer Console link on the left navigation will display the Add section by default. In this section, a user can add Virtual and Dedicated Server SMT interfaces inside the SMT interface that the user is logged into, or a user can create a Virtual Host Control Panel for a domain name hosted on the user s account. Virtual and Dedicated Servers In this section, a user can add additional domains that are not virtual hosts, into the management interface of the SMT 4.1. For example, if a user has another account hosted with AIT (another Dedicated server, for instance), adding the domain name in the filed provided will provide a fast and easy link from the SMT that the user is currently in to the SMT of the Dedicated server. Create a Virtual Host Control Panel To create a Virtual Host Control panel, otherwise referred to as a vpanel, click the Display list button under the directory name (See Figure 6-1 below). This will display a list of directory names inside of the user s /www/htdocs directory, along with a list of domain names hosted on that account. Enter the password and confirm it before clicking the Create vpanel button to install the vpanel.

14 Page 14 of 102 Figure 6-1 IMPORTANT NOTE: The username of the vpanel is the where the domain name is the domain you installed the vpanel for. For example, if a user installs a vpanel for a domain name called test.com, this is how the user would access the vpanel for test.com: URL: Username: webadmin@test.com Password: <password input on the web form in Figure 6-1> This is different than in previous versions of the SMT, so please take note of the change.

15 Page 15 of 102 Manage (Customer Console) The section labeled Manage under Customer Console allows users to click links directly to the SMT interfaces of other domains (see Virtual and Dedicated Servers or Create a Virtual Host Control Panel for how to add them into the interface). The links inside of this section directly link to the Customer Console for either a virtual host (vpanel) or another Virtual or Dedicated server (SMT) as Figure 6-2 below shows. Not shown in Figure 6-2 are the links for other Virtual and Dedicated Servers. Figure 6-2

16 Page 16 of 102 Web Services The default view when selecting Web Services is the Add view. Under this section, users can manage services used to view web sites, including addition and management of domain names, mirror domains, logs, password protected directories, etc. Figure 7-1 below shows the default screen when clicking on Web Services. Figure 7-1 Add a Virtual Host To add a virtual host domain name to the account, while at the screen displayed in Figure 7-1 above, click the Add Virtual Host link. Figure 7-2 (see below) will then be displayed. To complete the form, the user must enter the following information: Fully qualified domain name (ex. domain.com). Ensure the user does not include www in front of the domain name. Home directory (not path) for the files for the virtual host domain name (ex. domaincom or domain). This directory will be located in the /www/htdocs directory by default. This directory can be viewed by telnet or FTP. To add the domain name, just click the Add Virtual Host button.

17 Page 17 of 102 Figure 7-2 After the domain name has been added, the user will see the screen below (Figure 7-3) that displays the success message, along with the links to the Virtual Host Manager (VH Manager).

18 Page 18 of 102 Figure 7-3 NOTE: Please be aware that if you have a legacy account (i.e. Server 2, Server 2 Plus, etc), the feature to add a domain will be disabled, and you can only add a domain name through the Customer Care Center link. Enable Virtual Host Logs From the Add menu under Web Services, a user can add web logs to a domain that is hosted on that account. To enable or disable both Error and Access (traffic) logs for a specific domain, select the domain name from the drop down menu and then click the appropriate radio button for either the Error or Access log. Note that if the user selects Enable, visits to the website from that point forward will accumulate in the logs. Each virtual host log file is located in the /www/logs directory of the server by default, and can be found in FTP or telnet at that path. Figure 7-4 below shows an example of what the SMT would look like prior to the enabling of logs for a domain name called testdomain.com.

19 Page 19 of 102 Figure 7-4 Why would I need to know this? Web logs validate traffic to a website, and provide information about visitors, including but not limited to the date and time they visited the web site, the files and directories they visited, the operating system and browser type of the visitor, the web site they can from, and many other features. For AIT Resellers, this is a valuable feature to sell your customers because it means their logs can be analyzed by the most commonly used programs available, like Webalizer, Analog, Urchin, and Web Trends. AIT only supports Webalizer on its hosting platform; however, logs can be downloaded and analyzed by any application. Once enabled, there will be a result at the bottom of the screen stating success or failure (Figure 7-5). Please note that Access logs are also sometimes called Transfer logs.

20 Page 20 of 102 Figure 7-5 Password Protect a Directory There are 3 key steps to password protecting a directory; they re listed in order in the SMT 4.1. Step 1 is to make sure that the Apache or Web server settings are correct. To verify the settings for your account, click the link under Step 1 (See Figure 7-6).

21 Page 21 of 102 Figure 7-6 Once the link has been clicked, you will either receive a success message or a failure message (Figure 7-7 below). Usually a failure is not a problem, as your account can be setup to accept the changes that we are about to make. The configuration change that this first step provides is the ability to create an.htaccess file in any directory that you wish and have the Web server (Apache) understand that this.htaccess file is the authority for password protection.

22 Page 22 of 102 Figure 7-7 If the message is failure but it states that.htaccess files are already allowed on your server, then you can proceed to Step 2. If not, contact AIT Customer Service for a review of your Apache configurations. In step 2, input the following required fields (Figure 7-8 below): Path This should be the full path (not URL) to the directory that requires password protection. Reviewing the full path in an FTP program or via Telnet is advised here. (ex. /www/htdocs/protected) User Name This is the first username you will give access to this password protected area. You can add other usernames later; however, there is a requirement that one user must have access when creating a password protected directory. (ex. testuser) Description Heading This section is just a simple phrase that will be included in the username/password field when someone is prompted to input a username and password. In this case, we used PPD Test.

23 Page 23 of 102 Figure 7-8 Upon submission of the form available in Step 2, you may receive a success or error message. A somewhat common message that will appear after the submission of this step is the error displayed in Figure 7-9 below. If a directory has been configured for MS FrontPage, then the.htaccess file will require manual editing. For this, please consult (carefully) documentation on the Internet regarding.htaccess files and FrontPage configurations, or contact AIT s Customer Service Department and we can assist with the editing of these files.

24 Page 24 of 102 Figure 7-9 If the user does not receive an error, they most likely will receive the message in Figure 7-10, which shows the contents of the.htaccess file and a success message for the creation of the.htaccess file in the proper directory.

25 Page 25 of 102 Figure 7-10 Step 3 of the process requires the addition of the username and password to a file back in the directory structure called an htpasswd file. This file contains the encrypted passwords for the users who have access to the password-protected directory. To add users to the htpasswd file, complete the form for Step 3 (Figure 7-11). Included in this form are the required fields, which are: Path to htpasswd file The default of /usr/local/etc/htpasswd is a good place to store your file as this is not web accessible. Username The username can be between 3 and 8 characters long. Password As in any web service, the password MUST be between 6 and 8 characters, and SHOULD contain letters and numbers. For security reasons, it should not be set to anything simple such as love, password, or

26 Page 26 of 102 Figure 7-11 Why would I need to know this? From time to time, some of a user s customers may want to have a members or protected area. This allows AIT account holders to quickly setup password protected areas of a website, limiting access to specific users. Please note that this is NOT providing someone with FTP access only to their directory. This is for web browsing only, not for FTP services. Add Web Stats Analyzer Instructions on this section can be found in the Install Web Stats for Virtual Host section. The only difference is that the form will automatically fill in the top level domain name. Install Shopping Cart (MCart) * Please see the User s Guide for MCart located at If you are unfamiliar with this product, please review the User s Guide first. This will you install Mcart, AIT s customizable shopping cart. This function will install Mcart for the main account, as well as all virtual hosts. Figure 7-12 below shows the installation form. The steps below outline what should appear in the form.

27 Page 27 of 102 Mcart Version to install/upgrade The user must select the option that best describes how the payment process will be handled. Directory to install/upgrade shop in The user will specify the directory path for the MCart. The MCart should be installed in a directory within /www/htdocs. If the MCart is to be installed for a virtual host, the path should be specified as being for a virtual host. AIT recommends that you use /www/htdocs/vhdir where vhdir is the directory name for the virtual host domain name. Username for Shop Administrator This field can remain as shopkeeper, unless the user wants to specify a preferred username for access to the administrative section of the MCart. Password for Shop Administrator The user will enter the preferred password for access to the administrative section of the MCart. As in any web service, the password MUST be between 6 and 8 characters, and SHOULD contain letters and numbers. For security reasons, please avoid passwords such as love, password, or Re-enter Password The user will need to re-enter the password to confirm that it is correct. Select Setup Shop and the MCart will be installed in the specified directory. Figure 7-12 Install Webmail for Virtual Host This feature enables the user to access from a web browser. To use this function, the POP account must currently exist on the server. See Add

28 Page 28 of 102 Accounts to add the account if it does not exist. To install this feature, complete the form displayed in Figure 7-13 below: Domain Name This is the domain name that will send . ex. vhdir.com if the address is Directory - The directory location to install the webmail application. The directory name that is input will be the name of the directory created after the document root of the domain. For instance, if the domain name is domain.com and domain.com is a virtual host pointed to the directory /www/htdocs/domaincom, then the webmail directory will be created after domaincom. The name to give the directory is not a path, just a directory name. Figure 7-13 Once webmail is installed successfully, the user can login to the webmail application to make additional changes to the look and feel. Figure 7-14 below shows the interface after the installation is successful and the administrator login has been used.

29 Page 29 of 102 Figure 7-14 Install Bloggin for Virtual Host The Blog application that is in the SMT 4.1 can be installed on your top level domain, or any virtual host. To install the blogging application, simple select the domain name that you wish to add the blog to, and then add a directory name. Figure 7-15 below shows an example of what can be used. Domain Name This is the domain name that will have the blog installed. Directory - The directory location to install the blog application. The directory name that is input will be the name of the directory created after the document root of the domain. For instance, if the domain name is domain.com and domain.com is a virtual host pointed to the directory /www/htdocs/domaincom, then the blog directory will be created after domaincom. The name to give the directory is not a path, just a directory name.

30 Page 30 of 102 Figure 7-15 After the blog software is installed, it can be configured by the Blog administrator. Upon installation, an administrative username/password will be given to the user for use. Below in Figure 7-16 is an example of the default screen once the Blogging application is installed.

31 Page 31 of 102 Figure 7-16 To finalize any configurations, you can edit the files of the blog via your favorite web editor, or you can customize the interface by logging in as the Blog administrator using the Set Colors feature. Install cgi-bin for Virtual Host This feature installs the cgi-bin, or a directory where CGI and Perl scripts can be executed from for a virtual host. The cgi-bin will be installed in the document root for the virtual host. (ex. /www/htdocs/vhdir/cgi-bin where the virtual hosts document root is /www/htdocs/vhdir). To install the cgi-bin, complete the form field as displayed in Figure 7-17 below: Virtual Host Domain Domain name of the virtual host for whom the cgibin is being installed.

32 Page 32 of 102 Figure 7-17 Successful installation of the cgi-bin will produce the Success message. Any errors should be reported to the Customer Service/Technical Support Department. Install Web Stats for Virtual Host This option installs the Webalizer software for virtual host accounts. This software provides the user with statistics such as the number of hits and views a website has generated, and referring URL s. Before a virtual host can have or utilize Webalizer, logs must be enabled for the virtual host domain name. To enable logs, please review the Enable Virtual Host Logs section of this User s Guide. Once the logs are installed, the user can install Webalizer. To install the software, complete the form as illustrated in Figure All of the form fields under Top Table Keywords have explanations; therefore, none are included here. Domain Name The user will input or select, from the list, the virtual host domain name for which Webalizer will gather statistical data. This field will be left blank if the user is installing Webalizer for the main account. User Name The username to enter to access Webalizer for the specified domain. Access to this data requires authentication. Password The password to enter to access Webalizer for the specified domain. As in any web service, the password MUST be between 6 and 8 characters, and SHOULD contain letters and numbers. For security reasons, do no use passwords such as love, password, Verify Password Re-enter the password to confirm it was entered correctly. Once the user has completed all fields, the form can be submitted.

33 Page 33 of 102 Figure 7-18 Once installed, Webalizer must be checked at least every 30 days. If this is not done, then data (logs) could be missing from the Webalizer interface. 1. Administrative user must login to the appropriate URL for Webalizer for the domain name (traditionally its domain.com/webalizer/) 2. Administrative user must click the Run stats button so that logs are read into the Webalizer configuration files. 3. Administrative user can then click the View Stats button to review the most up-to-date stats for the account. 4. The Administrative user can then reset the log files for this virtual host domain by removing them from the /www/logs directory on the server to conserve disk space. Install Chat for Virtual Host

34 Page 34 of 102 This feature will install the files necessary to run Chat on the account. The user must first install the chat server before installing the client. To use this feature, complete the form fields displayed in the screen shown in Figure 7-19 below. First, select the button labeled Install Chat Server. This will install the files necessary to run the chat server. Figure 7-19 Next, complete the form fields under Chat Client Installation section. Installation Directory - The user will specify the directory path for the chat client. The client should be installed in a directory within /www/htdocs. If the chat client is to be installed for a virtual host, the path should be specified as that of the virtual hosts. It is recommended to use /www/htdocs/vhdir where vhdir is the directory name for the virtual host domain name. Virtual Domain - Domain name of the virtual host for which the user wishes to install the chat client. Upon installation, the user can begin chatting by going to the directory specified in the form field that was completed at the time of installation. Install msql This feature is used to install the msql software on the server. MSQL (or mini SQL) is database management software that provides fast access to stored information. Once the option has been selected, the software will be installed at /usr/local/msql2.0/ at the root of the user s server. Install mysql MySQL is a relational database management system, which means it stores data in separate tables rather than putting all the data in one big area. This adds flexibility, as well as speed. The SQL part of MySQL stands for "Structured Query Language,"

35 Page 35 of 102 which is the most common language used to access databases. The MySQL database server is the most popular open source database in the world. It is extremely fast and easy to customize, due to its architecture. Extensive reuse of code within the software, along with a minimalist approach to producing features with lots of functionality, gives MySQL unmatched speed, compactness, stability, and ease of deployment. Their unique separation of the core server from the storage engine makes it possible to run with very strict control, or with ultra fast disk access, whichever is more appropriate for the situation. Once the installation option is selected, MySQL is installed to the /usr/local/mysql directory. Install Support Queue/CRM This feature enables the user/reseller to create an -based support system to assist customers with issues. It is normally used for customer service functions like billing, technical, or website related issue, but the user can deploy it for other reasons if need be. The installation of this software will enable the user to post a support page for their customers. All support requests will be sent to the addresses specified in the form fields. The user may add up to four guest accounts for the support queue application. To install the software, complete the form as illustrated in Figure 7-20 below. Support System Name This is the name that will appear at the top of the support page Alias - The address that the user wants support messages delivered to. Billing Issue The address the user specifies for receiving billing inquiries. Webmaster Issue The address the user specifies for receiving webmaster inquiries. For Each Username added to the CRM/Support Queue, up to 5 users, the user will add the following: User Name - The username to enter to access the administrative section of the support queue. Password - The password to enter to access the administrative section of the support queue. Address: The address the user specifies as the address to which all s are delivered.

36 Page 36 of 102 Figure 7-20 Once installed, any of the servers used to create the Virtual Support Queue will login to it. They will see something like what is displayed in Figure 7-21 below.

37 Page 37 of 102 Figure 7-21 Button functionality after call is selected: View Views a call at the bottom of the screen. Does not send the user . Take Sends the user and marks the call as taken by that user. Billing Sends the call to the billing address and removes the call from the Queue. Webmaster - Sends the call to the webmaster address and removes the call from the Queue. Release Removes a user s hold on a call. This can only be done by the user who owns the call. Remove Removes the call from the Queue. Log Shows the log of the last 200 or so calls that were removed from the queue and by what user. Grab Does both the Take and Remove function at the same time. Install FrontPage for a Virtual Host This feature is used to install the Microsoft FrontPage extensions for virtual hosts. While the MS FrontPage software is not supplied by AIT (it must be purchased by the client), AIT does install the FrontPage server side extensions, which are required to utilize many of the features of MS FrontPage. To install the software, complete the form as illustrated in Figure below.

38 Page 38 of 102 Enter a Virtual Host The user will select from the list the virtual host domain name for which FrontPage should be installed. Enter User Name The username to enter in FrontPage to access the specified domain. Enter Password The password to enter in FrontPage to access the specified domain. As in any web service, the password MUST be between 6 and 8 characters, and SHOULD contain letters and numbers. For security reasons, do not use passwords such as love, password, or Figure 7-22 Once the user has completed all fields in the form, the form must be submitted. The figure below displays the results when MS FrontPage extensions have been installed successfully.

39 Page 39 of 102 Install File Manager for a Virtual Host Figure 7-23 This feature enables the user to install an application that will manage the amount of data that a client can install to a specified directory. The user will be able to utilize a web interface to upload, download, modify, and delete files. The file manager will be installed in the directory specified by the user and will only work for the specified directory. The user may install the file manager for multiple directories. To install the software, complete the form as illustrated in Figure User Name The username to access the file manager for the specified domain. Password The password to access the file manager for the specified domain. As in any web service, the password MUST be between 6 and 8 characters, and SHOULD contain letters and numbers. For security reasons, do not use passwords such as love, password, or Verify Password Re-enter the password to confirm it was entered correctly. Domain Name - The user will enter the virtual host domain name for which the file manager is being installed. Disk Usage Quota Input the maximum number of data in megabytes (MB) allowed to be installed to this directory. The user needs to ensure this number will not exceed the disk usage allotment for their server.

40 Page 40 of 102 Installation Directory - The user will specify the directory path for the installation of the file manager. AIT recommends using /www/htdocs/vhdir where vhdir is the directory name for the virtual host domain name when installing this application for virtual hosts. Figure 7-24 Once the user has completed all fields in the form, submit the form. Upon submission, the user can log into the File Manager. Install Guestbook This section creates a web-based Guestbook using a popular script. The installation is a simple form with the form fields listed below and shown in Figure Domain Name This field specifies the domain name for the Guestbook. The option to display the domain name for all domains on the server is also listed. Receive from Guestbook If this is set to Yes, then the site administrator address below will receive s when postings are submitted to the Guestbook. Address This is the address used for the Guestbook additions. If the above entry is set to No, then this address field can be left empty. File Name This file name is not used, so leave it empty.

41 Page 41 of 102 Figure 7-25 Upon completion, Figure 7-26 below shows what the guestbook pages will look like by default. These pages can be changed; however, please be careful not to remove any specific code used by the application.

42 Page 42 of 102 Figure 7-26

43 Page 43 of 102 Manage (Web Services) Under the Manage Web Services options is a group of good management tools for web site owners. In this section, you will see a quick link menu (Figure 7-27 below shows the screen with some commonly used features). Figure 7-27

44 Page 44 of 102 Manage Virtual Hosts The Manage Virtual Hosts option is the area where users can add, delete, rename and disable additional domains (virtual hosts) on an account. The top menu will allow the addition of Virtual Hosts and Mirrors, as well as the Search feature that is useful for accounts with more than 15 domains. The default display on this page (Figure 7-28 below) is 15 domains at a time, listed alphabetically. Figure 7-28

45 Page 45 of 102 Add Mirror A Mirror or Mirror Domain is a domain name that mirrors another site currently hosted. This is treated as a virtual host, and counts towards the quota of additional domains allowed on your account. Why would I need to know this? The ability to add and remove Mirror domains is best used for search engine placement. An example of this would be mydomain.com, and mydomain.net. If the user already has the domain mydomain.com as an existing website, the domain mydomain.net can be added as a mirror of the site mydomain.com. To create a Mirror, the user will always need the existing site, and the new domain that should mirror the existing site. To add the mirror, enter the new domain name in the Domain Name section and then select the pre-existing domain name to mirror the new domain to. Figure 7-29 below shows an example of what the user will see. Figure 7-29 Search for Virtual Host The Search feature will allow users to quickly find domain names on the account. Domains may be found by simply entering the domain name in the search box (Figure 7-30). The search is sensitive, so if you search for domain when looking for domain.com, the search will find it. The results (Figure 7-31) will still allow for the basic features of deactivation, renaming and deleting.

46 Page 46 of 102 Figure 7-30 Figure 7-31

47 Page 47 of 102 Disable Virtual Host The ability to disable a virtual host is done directly from the Manage Virtual Hosts area. Simple clicking the link will update the web server configuration files, and the site will become disabled. Figure 7-32 below shows an example of the site testing14.com being disabled. Note that only Web Services (HTTP) are disabled; FTP, SMTP and POP services are not. It is recommended that any FTP user account be removed during a disabled action. Figure 7-32 Why would I need to know this? The ability to disable a domain is very important to those that provide paid-for web services. At times, users will not pay

48 Page 48 of 102 for services rendered. This disable feature allows web services resellers to suspend accounts until payment is received. Rename Virtual Host The screen below shows how a user can rename a domain name. The purpose behind this feature is to change the domain name that is pointed to a directory on the user s virtual server. Once the Rename link is clicked on the list of all virtual host domains, the screen below (Figure 7-33) will appear. Please note that this feature does not register or renew a domain name. It will only rename the domain configuration on the virtual server for HTTP, FTP, SMTP and POP traffic. Figure 7-33 Delete a Virtual Host From the main list of domains, there is an option to Delete a virtual host domain. When clicking the link to Delete for a specific domain, you will receive a pop up display asking if you wish to delete the domain (Figure 7-34). Once a user selects Yes, the domain will be deleted from the user s virtual server. This will remove all configurations for that domain name; however, it will NOT remove the data inside of the directory or document root for the domain. This is something that will need to be done by hand using FTP, telnet or another scripting method. Once a domain is deleted, the quota for allowed domains on the virtual server will increase by one.

49 Page 49 of 102 Figure 7-34 Change Your Main Server Password Changing the main server password is a very simple procedure; however for security reasons we always recommend that users change their password every 30 to 60 days. The user should ensure the password is between 6 and 8 characters, and should include both letters (upper and lower case) and numbers. This password is used for both SMT/cpanel access, as well as FTP access. Figure 7-35 shows an example of a cryptic password. Figure 7-35 Manage msql Server This section is used to manage msql. msql or Mini SQL, is a database application used by web developers to make websites with dynamic content. The features shown below in Figure 7-36 are the only management functions needed in the

50 Page 50 of 102 SMT/cpanel. This provides the ability to start, stop and restart the msql daemon or service. Please note that this is not a utility for MySQL. Figure 7-36 To start the daemon or service, simply click the Start/Restart msql Server link. The output (See Figure 7-37) will show that the service started successfully.

51 Page 51 of 102 Figure 7-37 Manage mysql Server This section is used to manage MySQL. MySQL, is a database application used by web developers to make websites with dynamic content. The features shown below in Figure 7-38 are the only management functions needed in the SMT/cpanel. This provides the ability to start, stop and restart the MySQL daemon or service. Please note that this is not a utility for msql.

52 Page 52 of 102 Figure 7-38 To start the daemon or service, simply click the Start/Restart MySQL Server link. The output (See Figure 7-39) will show that the service started successfully.

53 Page 53 of 102 Figure 7-39 Check Perl Scripts for Common Errors This feature helps check perl scripts for simple errors. The error checking is done by a program in the SMT/cpanel. See Figure 7-40 for an example. This program will test 4 areas: TEST 1: script and permissions This test ensures that the file exists in the location specified on the virtual server, and that the permissions and ownership are properly set. For example, if the perl script that a user is checking is found to be 644, or not executable, it will correct the permissions and change the script to 755, which is executable permissions. TEST 2: script file format This test ensures that the file was uploaded in ASCII (pronounced asky ) mode and not binary mode. It will strip out any unwanted characters that sometimes can t be seen on a Windows operating system. TEST 3: check perl path This test checks the path at the top of the perl script and ensures that it is set to the location where the perl binary is located on the virtual server. The path to perl, or the first line in any perl script should always be one of the following two lines. #!/usr/bin/perl #!/bin/perl TEST 4: perl syntax

54 Page 54 of 102 This test reviews the basic syntax of the perl script. It may find simple errors, and correct them or point them out; however, this is a cursory review of the syntax, and will not evaluate logic errors. Scripts that are found freely on the Internet should work out of the box with some simple configuration changes. This test should inform the user whether the syntax for those changes is correct. If the script passes all the tests but still won t run, it could be one of the following areas. Make sure it can find any files or external programs it needs Make sure any included perl programs also check out Make sure you are writing a "Content-type:" line at the beginning of the script s output Figure 7-40 Reset WWW Log Files This feature will reset or zero out all web server logs in the logs directory for the top level domain name. The files that are reset are as follows: /www/logs/access_log /www/logs/error_log To reset the log files, simply click on the button as shown in Figure 7-41.

55 Page 55 of 102 NOTE: This feature does NOT reset log files for virtual host domains on the server. Log files for each virtual host will need to be zero ed out by FTP, telnet or other scripting means. Figure 7-41 Untar a File The ability to untar or decompress a file using the SMT/cpanel means that a user does not need to have or use telnet access. If a user wishes to put software or files that are in a tar format on the server, they can use this SMT feature to upload a small, compressed file, and expand the files on the server. This saves on upload time and also on data transfer. To untar a file, complete all 3 input sections. See Figure 7-42 below as an example. Path to the tar file This is the complete directory path, from the root of the virtual server to the file that has been uploaded via FTP. Path to untar the file in - The directory you are untarring to will need to exist. You can create this via FTP. Type of operation Select Uncompress, Untar or Gunzip. These are the most commonly used compression algorithms. If a user is unsure of what operation to choose, the user can simply review the file extension of the compressed file and compare it to what is on the interface. The file extensions match the action to execute.

56 Page 56 of 102 NOTE: Files in the /www/logs directory will not be untarred by this page. You will need to contact AIT to do so. Also, files will not be able to untarred to /bin, /usr/bin, /lib, or /usr/lib. This is because files in these directories are unavailable to users. Figure 7-42 Set All CGI to Execute This feature will set all programs in the /www/cgi-bin directory to 755, or executable. The file permissions of executable tell the browser or user if they can access and execute the file. CGI or perl programs need to be executable to be viewed. Typically, after uploading a CGI or perl script, a user will need to change mode or chmod the file to 755 permissions. The numerical value of the permissions can be understood by using the chart below. In FTP, or telnet, users can see the file permissions by doing a directory listing. Here is an example of what can be seen in FTP or telnet. -rwxr-xr-x Jul 2 17:01 fmail.pl Note the permissions column on the left hand side. The r means that the file is readable. The w means that the file is writable and the x means that the file is executable. These permissions are duplicated for 3 groups. They are the super user

57 Page 57 of 102 first, the user, then the group permissions. Here is a visual sample. Green is the super user, blue is the user, and red is the group = 777 r w x r w x r w x The chmod or change mode to the correct permissions can be done one file at a time via FTP or Telnet, or the tool in the SMT can be used to conduct this chmod to 755. In Figure 7-43 below, you can see that the user can do all this with the simple click of a button. Figure 7-43 Enable/Disable Telnet This feature allows you to enable and disable telnet access. Telnet is the Internet standard protocol for remote login (terminal connection) service. TELNET allows a user at one site to interact with a remote timesharing system at another site as if the user's terminal were connected directly to the remote computer. In Figure 7-44, you can see the simplicity in performing this task.

58 Page 58 of 102 Figure 7-44

59 Page 59 of 102 Mail Services The Mail Services link on the left navigation will display the Add section by default. In this section, users can add, modify or delete settings and configurations. Figure 8-1 below shows the default view, and the links that will be displayed at this main Mail Services menu. Figure 8-1 Add Accounts This feature will allow users to add boxes or POP accounts. This means that the user will have a mailbox on the server where will be stored. User s can use web based , or use clients such as Outlook or Outlook Express to download the they receive. Figure 8-2 below shows the user inputs. They are as follows: Username This is the name of the user that is to be created. This should be between 3 and 8 characters. Spaces are not acceptable. Domain Name This field is used to attach a specific domain name with the user name. All domain names on the virtual server are listed in the drop down menu. If a user does not see a domain name listed in the drop down menu, they should consult the Add Virtual Host section of this user s guide, and confirm it has been added. Real Name This is the user s real name. This is an optional field.

60 Page 60 of 102 Password The user should ensure the password is between 6 and 8 characters, and should include both letters (upper and lower case) and numbers. Confirm Password This is used to confirm that the password is correct and the same as the above password. FTP enabled? This is a yes or no selection to allow this user to also have FTP access to the server. FTP Home Directory This should be the path from the root of the virtual server, down to the directory that the user should have access to. Note that the FTP user will not have access to anything above the directory a user inputs here. An example of a proper home directory would be /www/htdocs/test where the user would only have FTP access to the test directory. Figure 8-2 Figure 8-3 below shows an error message that can often be displayed. The user name selected ( test ) has already been created. The error states that it was created as an alias, and because of this, the user can t create an alias and an account (POP account) with the same name. The SMT will provide the user with the ability to remove the alias, and add the POP account or choose another POP account username.

61 Page 61 of 102 Figure 8-3 Figure 8-4 below shows the success message for the addition of a POP account.

62 Page 62 of 102 Figure 8-4

63 Page 63 of 102 Add Mail List This feature gives users the ability to add an alias, which s a group of individuals. For instance, the example in figure 8-5 below is set to show an example of the address OfficeWide @domain.com to go to all the individuals that work in an office. Figure 8-5 Why would I need to know this? This is beneficial because employees who work in the same department or for a small company can easily share information with one address.

64 Page 64 of 102 Add Addresses to a Mail List Once the Mail List has been created (using OfficeWide in this case), the user can add addresses to the list. Each user added to the list will have to have an address and a Real Name. Figure 8-6 below shows the form used to add addresses to the existing Mail List. Figure 8-7 shows what the form looks like after the first user has been added. Figure 8-6

65 Page 65 of 102 Figure 8-7 Display List of Addresses in a Mail List The Display List button that appears above in Figure 8-7 will display the address and name of each individual on the Mail List, as witnessed in Figure 8-8 below.

66 Page 66 of 102 Figure 8-8 Remove Address to a Mail List To remove an address, simply select if from the Current Addresses list in the drop down menu. Click the Remove Address button and the address will be removed. Figure 8-9 and 8-10 below show the procedure for removing the user Bob from the OfficeWide Mail List.

67 Page 67 of 102 Figure 8-9

68 Page 68 of 102 Figure 8-10

69 Page 69 of 102 Setup Forwarding In this section, users will have the ability to create forwarding accounts. An forward, or alias is in essence a fake name or address that points to a real address, either on or off the server. There are two types of forwards, which are outlined below. Example 1: webmaster@domain.com is forwarded to bob@domain.com, where bob is a POP account. POP accounts are the same as the Accounts talked about in a previous section of this User s Guide. Example 2: webmaster@domain.com is forwarded to bob@aol.com, and this address is outside of AIT s network. To add an Forward of either type listed above, complete the form as displayed in Figure 8-11 below. In this example, the Forward is for webmaster. The domain name the Forward is for is selected from the drop down menu. The Alias Type tells the SMT whether to setup the alias like the Example 1 above, or to set it up like Example 2. Figure 8-11 If POP3 mail account is selected, then the user will select the POP3 account in the Alias To input box, as Figure 8-12 shows.