View source for Coral: start user configuration

<div id="top" style="margin:0;padding: 0px 0px 0px 5px; color: #000; background-color: #FFFFEB; border: 1px solid darkslateblue;"><span id="top" style="margin:0;padding: 0px;font-size:12px">'''''Coral'' :'''&nbsp; [[Coral: start quick start|Quick Start]] | [[Coral: start quick start detail|Quick Start - More Detail]] | [[Coral: start user configuration|User Configuration]] | [[Coral: start run as program|Run as a program]] | [[Coral: start run as service|Run as a service]] | [[Coral: start server utilities|Server Utilities]] | [[Coral: start multi servers|Multi-Servers]]</span></div>

{|style="margin-top:5px;"
|-valign="top"
|
<span style="margin-bottom:5px;font-size:25px;color: #31799F;">User Configuration</span>

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.

__TOC__

|
{| cellpadding="0" cellspacing="0" style="margin-left:6px;margin-bottom:5px;padding-left:6px;padding-right:6px;font-size:11px;background-color: #FFFFEB;border: 1px solid darkslateblue;"
|-
|colspan="2" style="font-weight:bold;"| UniServer&nbsp;8-Coral
|-
|&nbsp;||[[Coral: Introduction|Home]]
|-
|<span style="font-size: 14px;">»</span>||[[Coral: start quick start|Quick Start]]
|-
|&nbsp;||[[Coral: general intro|General]]
|-
|&nbsp;||[[Coral: apache intro|Apache]]
|-
|&nbsp;||[[Coral: mysql intro|MySQL]]
|-
|&nbsp;||[[Coral: php intro|PHP]]
|-
|&nbsp;||[[Coral: msmtp intro|MSMTP]]
|-
|&nbsp;||[[Coral: cron intro|CRON]]
|-
|&nbsp;||[[Coral: dtdns intro|DtDNS]]
|-
|&nbsp;||[[Coral: dbbackup intro|Db Backup]]
|-
|&nbsp;||[[Coral: perl intro|Perl]]
|-
|&nbsp;||[[Coral: index main|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:

<span style="padding:6px;background-color:#99FFFF">UniServer\coral_con\config_menu\config_tracker.ini</span>

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

<pre>
[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
</pre>

===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:

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

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: '''<nowiki>http://localhost:80/display_page</nowiki>''' (display_page is the variable containing path/file to display.)

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

'''''[[#top | Top]]'''''
==User buttons www and ssl==
{|
|-valign="top"
|
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
|
[[Image:Coral_start_menu_options.gif]]
|}

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

<span style="padding:6px;background-color:#99FFFF"> UniServer\coral_con\config_menu\'''config_tracker.ini'''</span>

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

<pre>
; Page to display from folder www when www button clicked
; Default any index page. Note: http:// is used
www=
</pre>
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: '''<nowiki>http://localhost:80/www</nowiki>''' (www is the variable containing path/file to display.)

'''Note 2:''' This part of the URL '''<nowiki>http://localhost:80/</nowiki>''' 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:

<span style="padding:6px;background-color:#99FFFF">UniServer\coral_con\config_menu\'''config_tracker.ini'''</span>

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

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

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: '''<nowiki>https://localhost:443/ssl</nowiki>''' (sll is the variable containing path/file to display.)

'''Note 2:''' This part of the URL '''<nowiki>https://localhost:443/</nowiki>''' 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: 

<span style="padding:6px;background-color:#99FFFF">UniServer\coral_con\lang\'''English.vbs'''</span>

Locate this section in the configuration file and change lines accordingly:
<pre>
'******************************************************************************
' User Configuration
'******************************************************************************

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

'-------------------------------------------------- End User Configuration ---
</pre>

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:

<pre>
'******************************************************************************
' User Configuration
'******************************************************************************

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

'-------------------------------------------------- End User Configuration ---
</pre>

'''Note:'''<br />
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 | 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.

<span style="padding:6px;background-color:#99FFFF">UniServer\coral_con\config_menu\'''config_tracker.ini'''</span>

Search for this section:

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

Change the section as shown to reenable nagging:

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

'''''[[#top | Top]]'''''
==Where to next==

[[Coral: mysql change password|MySQL Change Restore password]] - Set new MySQL root password

----

[[Category: Uniform Server 8-Coral]]