Install the Web- Interface for the steam server

Due to changes of the webinterface installation method, these installation guide is splitted into two sections:
Section A describes how to install a webinterface version >= 2.2
Section B describes how to install a webinterface version < 2.2

Section A - Version >= 2.2

Please make sure you are running server version 2.2.15 or higher. (you are able to check the version number of the steam server logging in as root and click on configure server in the steam header), and having the following packages installed on your server: server_base >= 1.0, spm_support >= 1.2 and icons_doctypes >= 1.0 (you are able to check for these spm packages going to /packages on your server where all installed packages are listed)

There are different methods to install the webinterface package withversion >= 2.2:
a) Just follow the general Installation Instructions for SPM Packages
b) Being root on the host system of the steam Server:
use the spm tool installed with your steam server to install the webinterface packages from the command line:
- Download the web-2_2x.spm file from this website to the server
- install it from the command line being "root" user:
e.g. /usr/local/lib/steam/bin/spm -i web-2_20.spm
c) Copy the web-2_2x.spm into the "spms" folder of the installation directory of your steam server and restart the server. At startup the spm service triggers the installation of the webinterface package automatically.



Section B - Version < 2.2

Now we need a Web- Interface for the steam server in order to access the system via a web browser. To install a web interface there are two ways:
wb) install a web interface from package provided by the open steam project
wa) install a web interface using the actual CVS source code

wa) Install web interface from package

wa1) List all available web- interface provided by the steam project versions using :
# /usr/local/lib/steam/bin/spm -l
wa2) Now Install the web- interface with:
/usr/local/lib/steam/bin/spm "name of listed package"
where must be the latest Wi Version matching your server version. the Package will be downloaded automatically from our demo server steam.upb.de an will be installed on your steam Server.

wa3) Now you have installed the web- interface and can access it e.g. via http or https:
http:/// changed from the "welcome to steam" page to a default page offering login and forgot password- mechanisms. https:/// using "root" as login and the root passord queried during the sTeam installation procedure (default is "steam").
wa4) Please refer to troubleshooting to make sure all configuration variables are set correctly

wb) Install web interface from CVS


Please note to make sure you are using the actual stable version. If you have questions which one is best for your server version feel free to contact us
Actual stable is web-2_0, actual development version is web-2_1. Please substitute "packagename" below with the version you want to get vie CVS.
sources wb1) checkout the webinterface sources via CVS:
# cd /root/cvswork
Login:
# cvs -d :pserver:steam@cvs.open-steam.org:/cvs login
the password is "steam".
Get the sources of the webinterface:
# cvs -d :pserver:steam@cvs.open-steam.org:/cvs co "packagename"
wb2) create the web package from the CVS source files:
# cd /root/cvswork/"packagename"
# ./make_spm
now theres a file "web.spm.gz".
wb3) Now Install the web- interface with:
# /usr/local/lib/steam/bin/spm -i web.spm.gz
wb4) Now you have installed the web- interface and can access it e.g. via http or https:
http://"yourserverip"/ changed from the "welcome to steam" page to a default page offering login and forgot password- mechanisms. https://"yourserverip"/ using "root" as login and the root passord queried during the sTeam installation procedure (default is "steam").
wb5) Please refer to troubleshooting to make sure all configuration variables are set correctly

5) Troubleshooting

Check Configuration of the Webinterface:

Please check the configuration variables of the webinterface (Especially in the case if you are installing a steam server by your own just for a test you are not able to specify a server name and domain which can be found using DNS):
Open a browser and view:
https://"yourserverip"/scripts/admin.pike?mode=showconfigurationdetails
(Please make sure to enter the correct ip, not the name of the server)
There you have all the data. Most important is to check:
domain if your server is not reachable per DNS using his name and domain. be sure to leave this field empty. if there is a 0, remove the 0 from the input field
machine if your server is not reachable per DNS using his name and domain. You have to enter the ip here.
web_server if your server is not reachable per DNS using his name. You have to enter the ip here.
now save the configuration.