How to install a sTeam Server on Mac OS X

Installing a sTeam server Version steam-2_0 on Mac OS X

Contents

0) Introduction
1) Requirements
2) Installing the sTeam Server
3) Install the Web- Interface for the steam server
4) Troubleshooting
5) Conclusion

0) Introduction

This litte howto describes the needed steps to prepare a System running Mac OS X to work as a sTeam server. At first please notice that the author of this document is no expert in using or configuring Max OS X. Everything you do to your hard and software following the tips of this howto is at your own risk.

1) Requirements

  • First you need a System (like iBook, PowerBook or iMac) running Mac OS X.
  • Developer Tools for Mac OS X. They are on the first Install disk of your Mac OS X CD set. Just perform a doubleklick on Developertools.pkg to install them.
  • Fink Package manager for Mac OS X. Just follow the introduction on macdevcenter.com to get fink working on your machine.
  • MySQL database server. You can use the official Mac OS X version of MySQL, or install the Fink mysql packages. We currently recommend MySQL 4.1 since we haven't tested sTeam with MySQL 5.0 yet.

2) Installing the sTeam Server

  1. Install Fink packages

    At the moment, there is no package for Mac OS X available, so you have to compile and install the sTeam Server from our CVS repository.
    The steam server requires some "packages" which have the same meaning as little programs used by the system e.g. by the steam server like some text transformation helper, the mysql database and many more. some packages are needed from mysql and so on. This is what fink is needed for.
    For all the following commands, you need to open the Terminal Application (Open Finder, go to programs and open the Terminal)

    • libxml2
    • libxml2-bin
    • libxml2-shlibs
    • libxslt
    • libxslt-bin
    • libxslt-shlibs
    • flex
    • automake
    • autoconf
    • cvs
    Please install these packages using:
    fink install
    The packages will be dowloaded and installed automatically. If you run into problems installing the packages, you might try to use the FinkCommander.

  2. Start the MySQL Server

    If you are using the official MySQL release for Mac OS X, then you can use the PrefPane applet to start the server. If you are using the Fink mysql packages, then you can start the MySQL server with the following command: /sw/bin/mysqld_safe &

  3. Install Pike 7.4

    Go to the Pike Download Area for pike 7.4.44 and download the Package for Mac Os X named Pike-v7.4.44-Darwin-6.8-Power-Macintosh.
    open the Terminal:
    cd Desktop
    And make the Pike install Script Executable with:
    sudo chmod 777 Pike-v7.4.44-Darwin-6.8-Power-Macintosh
    Now you are able to run te pike installation with:
    sudo ./Pike-v7.4.44-Darwin-6.8-Power-Macintosh
    You will be asked for the installation path for pike 7.4.77, please do not modify these paths
    Note: Safari seems to mess up the download of the Pike package, appending .tar to the filename. IF you cannot get the package to install, then try to download it with another browser.

  4. Checkout the server sources from CVS

    First you need a directory to store the source data in:
    cd mkdir cvswork
    cd cvswork

    Then you need to checkout the sources from CVS:
    Login:
    cvs -d :pserver:steam@cvs.open-steam.org:/cvs login
    the password is "steam".
    Get the Sources for server version steam-2_0:
    cvs -d :pserver:steam@cvs.open-steam.org:/cvs co steam-2_0

  5. Build and install the Server:

    Install the sTeam Server:
    sudo ./install
    The sTeam Server installation path is now:
    /usr/local/lib/steam

  6. Configure the server

    make sure the database connect string in your config files match using: (be sure to set them correctly regarding to the output of ./setup)
    vi /etc/steam/config.template
    vi /etc/steam/steam.cnf

  7. Start the steam server

    make sure that the mysql server is running:
    ps -eaf | grep mysqld
    Start the mysql Server:
    sudo /sw/bin/mysqld_safe &
    Start the steam Server:
    sudo /etc/init.d/steam start &

    Note: If you are using MySQL 4.1 or newer and steam doesn't start, complaining (in /var/log/steam/errors_1.log) that it cannot connect to the database, then you might need to change the steam password for the database in the old password format:
    Login to mysql as root and use the following command:
    set password for steam@localhost = old_password('steam');

3) Install the Web- Interface for the steam server

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:
wa) install a web interface from package provided by the open steam project
wb) 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
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) because the Apache Webserver which is intagrated in Mac OS X uses port 80 by default go to the Server Configuration via:
https://localhost/scripts/admin.pike
and change the Port of the http protocoll to 8080
then press the Button restart Server on the configuration Page
wa4) You are now able to access the public sites on your steam server using:
http://localhost:8080/

wa5) Now you have installed the web- interface and can access it via https:
https://localhost/ using "root" as login and the root passord queried during the sTeam installation procedure (default is "steam").
wa6) Please refer to troubleshooting to make sure all configuration variables are set correctly

wb) Install web interface from CVS sources

wb1) checkout the server sources via CVS:
cd cd cvswork
Login:
cvs -d :pserver:steam@cvs.open-steam.org:/cvs login
the password is "steam".
Get the Sources for webinterface version web-1_8:
cvs -d :pserver:steam@cvs.open-steam.org:/cvs co web-1_8
wb2) create the web package from the CVS source files:
cd /cvswork/web-1_8
./make_spm
now theres a file named "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 via https:
https://localhost/ using "root" as login and the root passord queried during the sTeam installation procedure (default is "steam").
wb5) because the Apache Webserver which is intagrated in Mac OS X uses port 80 by default go to the Server Configuration via:
https://localhost/scripts/admin.pike
and change the Port of the http protocoll to 8080
then press the Button restart Server on the configuration Page
wb6) You are now able to access the public sites on your steam server using:
http://localhost:8080/
wb7) Please refer to troubleshooting to make sure all configuration variables are set correctly

4) Troubleshooting

Create a new database for the steam server:

maybe the steam server is not started at this point. Then you have to create a new database:
sudo /usr/local/lib/steam/bin/setup
and start the server manually:
sudo /usr/local/lib/steam/start &

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://localhost/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.

5) Conclusion

Improvements, critics, suggestions and comments are welcome, please email us.
For more information about sTeam please visit: http://www.open-steam.org.