01. Installation - ihofmann/open-websoccer GitHub Wiki

How to install the OpenWebSoccer-Sim

First, get ready

In order to install the software, following is required:

  • Microsoft Windows users: You have an application for extracting ZIP files, e.g. 7zip.
  • A web server with FTP access. A comparison of various web host providers can be found at, for instance, whoishostingthis.com.
  • You know the credentials of your FTP access and MySQL database (server name, database name, user, password).

Note: Migration from H&H WebSoccer 2

If you are using the original version of H&H WebSoccer 2, revision 2.91, you can upgrade as follows:

  1. Create a backup of your current database.
  2. Switch to offline mode.
  3. Install the new software according to this manual.
  4. Make sure that you enter the exact same database table prefix that you are already using for the old version. The installer will update all existing tables.

Important: The installation of the new version will make all existing passwords unusable. Your users will need to request a new password.

Upload the software to your server

  1. Extract all files of the ZIP archive, e.g. to C:\mywebsites.
  2. Log on to your server with an FTP client.
  3. Upload the contents of the extracted folder websoccer.

Set write permissions

Some files and folders require write permission on the server. When using a Unix operating system (most of the web host providers use a Unix system), it means that you need to apply the command CHMOD 666 to files and CHMOD 777 to folders. This is how you basically set write permissions with a common FTP client:

  1. Log on to the server.
  2. Righclick on the file or folder.
  3. Choose "Properties" or "Permissions".
  4. Enable the check box "Others" = W ("Write").

Following folders require write permissions:

  • uploads/club
  • uploads/cup
  • uploads/player
  • uploads/sponsor
  • uploads/stadiumbuilder
  • uploads/users
  • cache
  • admin/config/adminlog.php
  • admin/config/config.inc.php
  • admin/config/entitylog.php
  • admin/config/imprint.php
  • admin/config/jobs.xml
  • admin/config/lockfile.txt
  • admin/config/termsandconditions.xml

Execute installation script

One you uploaded the application files completely, you can start the installation script by calling the site:

http://www.websoccer-sim.com/websoccer/install/

(replace www.websoccer-sim.com with your own domain.)

Just follow the instructions on your screen.

Delete the installation folder

After successful installation, please delete the folder install on your server.

  1. Log on to your server with an FTP client.
  2. Navigate to your websoccer folder.
  3. Right click on sub folder install, then click "Delete" (or "Remove").

The installation is completed and you are ready to go!

Advanced content protection

It is not provided by all web hosters, but it increases privacy: We recommend to setuo a password protection for following folders:

  • admin/config
  • modules

Many web hosters provide a special user interface for setting up a folder password protection, but you can also follow these instructions.

⚠️ **GitHub.com Fallback** ⚠️