Lyris

Modifying lyris.plc

The file "lyris.plc" contains the configuration information for the Lyris Web Interface. Here is a typical configuration:

site=
server_ip_address=207.105.7.133
server_ip_port=2020
socket_retries=2
temp=c:\net\netserv\cgi-bin\temp
lyris_url=http://207.105.7.133/lyris
debug=no
password=LCPPasswd
#admin_ip=207.105.6
#user_ip=207.105.7

This table explains each of the different parameters:

key description
site On a server with only one site defined, this parameter serves no purpose. When there is more than one site defined, this parameter defines the default site to display if the URL the user goes to doesn't specify a site.
For instance, if the user specifies the URL: "/cgi-bin/lyris.pl?site=shelby", then the site named "shelby" will be displayed. If no site is given on the URL, as in "/cgi-bin/lyris.pl", then the site named in this parameter will be displayed.
If you leave the site= setting blank, then the Lyris web interface will display the first site (alphabetically) that it can find.
server_ip_address This defines the TCP/IP address of your Lyris server. If the Lyris Web Interface is running on the same machine as Lyris, then this setting should be the TCP/IP address of your machine.
However, there is no requirement that the Lyris Web Interface be in the same computer as the Lyris Server. If this is the case, then this parameter should point to the TCP/IP address of the Lyris Server you want to display.
The parameter, when combined with a "virtual host" capable web server, allows you to "virtual host" your Lyris server as well.
server_ip_port In this version of Lyris, the Lyris Command Protocol always uses port 2020.
socket_retries If you have an extremely busy network, it is possible that the Lyris Web Interface will have trouble connecting to the Lyris Server. If this happens, the Web Interface will try a number of times to reconnect. This setting defines the number of retries.
temp Defines the directory the Lyris Web Interface uses for its temporary files.
lyris_url Defines the URL where the Lyris graphics are located. These are the graphics which the Lyris Web Interface HTML pages require.
debug If you are experiencing problems with the Lyris Web Interface, you can change this to "debug=yes" and extra debugging information will be displayed at the bottom of each Web Interface page.
password This is the Lyris Command Protocol login password. This defaults to "LCPPasswd" but can be changed from the Server Admin menu, in the Server Configuration form.
This password must be set to the Lyris Server's setting in order for the Lyris Web Interface to function. This is a security precaution, so that unauthorized users cannot access the Lyris Command Protocol.
admin_ip This parameter specifies the TCP/IP address mask of computers which are allowed to login as administrators.
Administrators always have to give a name and password to login, and this provides a reasonable level of security. If the admin_ip parameter is undefined, then any user can get the "Administrator Login" screen and try to login. However, without a valid username and password, they will not be able to access administrator functions.
The admin_ip parameter provides additional security, by displaying the "Administrator Login" menu only to approved TCP/IP addresses. Other users will not even see the "admin" menu choice.
This parameter is a mask, meaning that it specifies a pattern to look for. For example, if you specify "207.105.6", then any user with a TCP/IP addresses beginning with "207.105.6" will see the admin menu.
This parameter allows you to restrict administrator access to TCP/IP addresses within your company.
user_ip If specified, this defines a mask for TCP/IP addresses which are allowed to access the user menu. If undefined, all users are allowed to see the user menu.
For example, if you have a Lyris Server which is internal to your company, and outsides should not be able to access it, then you can set user_ip to be a mask for the TCP/IP addresses in your company. See the "admin_ip" parameter for more information about masks.
If a TCP/IP address matches the "admin_ip" parameter, it automatically has access to the user menus as well.

ContentsNext