Coral: start user configuration

From The Uniform Server Wiki
Revision as of 13:06, 6 December 2011 by BobS (talk | contribs) (Emphasis changes)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

User Configuration

The Uniform Server Coral uses a configuration file which is split into two sections: user defined configuration and server tracking. The server tracking section is automatically updated by UniController and should not be changed by a user. It tracks items such as the installation path and the current Apache and MySQL running status.

This page covers the user defined configuration section. You can disable or enable the start up splash page and optionally set a new page to display. During start up, a user is nagged to change server security items such as the MySQL password. Nagging is enabled or disabled in this section. Two user buttons, www and ssl, have been pre-configured to display the root folder index pages; these can be re-configured to display specific pages. In addition each button text is changeable by setting a language file constant.

UniServer 8-Coral
  Home
» Quick Start
  General
  Apache
  MySQL
  PHP
  MSMTP
  CRON
  DtDNS
  Db Backup
  Perl
  Main Index

Splash Page

Background

At start-up, the server displays a splash page confirming that it is working. It is only a single page mini web-site with associated image and css folders. This mini-site is in its own folder (UniServer\home\us_splash) and mapped as an alias. The folder contains an .htaccess file limiting access only to localhost.

This mini web-site may be changed to fit your own requirements. Alternatively it can be disabled in the control configuration file as explained below. After that, it can be deleted, and the alias section removed from the configuration file.

Enable/Disable splash page

A single line in the control configuration file enables or disables the splash page at start-up. Edit file:

UniServer\coral_con\config_menu\config_tracker.ini

Locate this section and change line start=true as appropriate :

[REDIRECT]
;Redirect allows you to specify a page to display either
;at startup or when www or ssl buttons pressed.
;Folders can be an Alias eg us_splash. Root folder assumed 
;If no path or file specified root is assumed first index
;page is displayed. No index page found the root folder
;content is displayed.

; Display page at start up. true display page false no page
start=true

Change Splash Page

After enabling the start-up splash page, you can set the specific page to be displayed. Locate this section in the configuration file and change the line display_page=us_splash/index.php accordingly:

; Page to display from folder alias us_splash 
; Default index.php
display_page=us_splash/index.php

For example, if you want to display the index.php page in root folder www change line to: display_page=index.php

Note 1: The default page displayed uses redirection and is constructed with the following format: http://localhost:80/display_page (display_page is the variable containing path/file to display.)

Note 2: This part of the URL http://localhost:80/ is automatically adjusted to match the server port configuration.

Top

User buttons www and ssl

Both server menus, initiated by start as program and start as service, contain two user configurable buttons:

  • B7) View www
  • B8) View ssl

These have been pre-configured to display the root folder index pages. Their corresponding button text is defined in the language file

Change www page

A single line in the control configuration file sets the page to be displayed. Edit file:

UniServer\coral_con\config_menu\config_tracker.ini

Locate this section in the configuration file and change line "www=" accordingly:

; Page to display from folder www when www button clicked
; Default any index page. Note: http:// is used
www=

For example, if you want to display the index.php page in root folder www change line to: www=index.php

Note 1: The page displayed uses redirection and is constructed with the following format: http://localhost:80/www (www is the variable containing path/file to display.)

Note 2: This part of the URL http://localhost:80/ is automatically adjusted to match server configuration.

Change ssl page

A single line in the control configuration file sets the page to be displayed. Edit file:

UniServer\coral_con\config_menu\config_tracker.ini

Locate this section in the configuration file and change line "ssl=index.php" accordingly:

; Page to display from folder ssl when ssl button clicked
; Default index.php Note: https:// is used
ssl=index.php

For example, if you want to display the fred.html page in root folder ssl change line to: ssl=fred.html

Note 1: The page displayed uses redirection and is constructed with the following format: https://localhost:443/ssl (sll is the variable containing path/file to display.)

Note 2: This part of the URL https://localhost:443/ is automatically adjusted to match server configuration.

Change button names (www or ssl)

Button names are defined in the language configuration files. The actual file used is lang.vbs, but this is just a copy of the active language. When a language is selected with the Select Language button, that language file is copied to lang.vbs and replaces it.

Currently there are two language files; other languages will be added as translations are made available.

For English, edit:

UniServer\coral_con\lang\English.vbs

Locate this section in the configuration file and change lines accordingly:

'******************************************************************************
' User Configuration
'******************************************************************************

Const lang_view_www   = "View www"   'User button text
Const lang_view_ssl   = "View ssl"   'User button text

'-------------------------------------------------- End User Configuration ---

For example, if you want to change the displayed text "View www" to "My Index" and change "View ssl" to "Information", then the block becomes:

'******************************************************************************
' User Configuration
'******************************************************************************

Const lang_view_www   = "My Index"     'User button text
Const lang_view_ssl   = "Information"  'User button text

'-------------------------------------------------- End User Configuration ---

Note:
To activate your change, you can either duplicate the change to lang.vbs or use the Select Language button, which will do the copy for you.

Top

Start-up - Nagging

I personally hate the concept of nagging users, hence the ability to turn it off when first encountered. That said, it is essential to set a new MySQL server root password, and nagging stresses the security issue.

Enable/Disable - Nagging

If you accidentally turn off nagging, it is easy to restore by editing the control configuration file.

UniServer\coral_con\config_menu\config_tracker.ini

Search for this section:

[NAG]
; Enables nagging to get user to change MYSQL password
; Default true - nag user
nag_user=false

Change the section as shown to reenable nagging:

[NAG]
; Enables nagging to get user to change MYSQL password
; Default true - nag user
nag_user=true

Top

Where to next

MySQL Change Restore password - Set new MySQL root password