Installation

Da SEOW Wiki IT.
Jump to navigation Jump to search

PANORAMICA

Ci sono tre componenti che devono essere installati affinché il sistema SEOW possa funzionare:

1. The Dynamic Campaign System (DCS) - Installato sul PC Utente.

Il DCS è un'eseguibile Win32 (Visual Basic .NET) connesso ad un database SQL. E' installato sul PC dell'Utente.


2. The Mission Planner (MP) - Installato su uno Web Server.

Il MP è un'applicazione web in linguaggio PHP che deve essere installata su di uno Web Server che supporti PHP. Il MP è espressamente sviluppato per MS Internet Explorer 6 o successivo, ma gira molto bene anche in Mozilla Firefox dotato di IETab add-on.

Esso rende disponibile un'interfaccia di programmazione delle missioni per tutti i comandanti attivi nella campagna. Il MP gestisce ogni aspetto della pianificazione, ricognizioni, rinforzi ecc.. Al momento il MP è disponibile solo come applicazione PHP che realizza una connessione con i database Scorched Earth via libreria ADO. Gira sia su Windows che su Unix/Linux o su ogni piattaforma che supporti PHP.


3. The Database (SEDB).

SEOW supporta due tipi di database: MySQL come database server o Microsoft Access in installazione locale.

Il database SEDB memorizza tutti i dati delle campagne SEOW.



Step 1. Download and install the required software libraries.

You must do this before starting the installation of SEOW components. Make sure that you have a web server with PHP installed and working correctly - yes, do this NOW. If you are going to use MySQL, make sure you get this working with the following options set in the my.ini configuration file for MySQL:

# Local extensions for SEOW
lower_case_table_names=2

#Use old password encryption method (needed for 4.0 and older clients).
old-passwords

#extend query chunk size to something sensible
max_allowed_packet=64M 

Also, make sure that your PHP has the MySQL extension loaded. This is enabled by default in some PHP releases, but not the recent PHP v5.2.x releases. You do this in the php.ini file of your PHP installation folder. Simply uncomment the MySQL extension line. That is, change:

;extension=php_mysql.dll

to

extension=php_mysql.dll

That should do it! The next time you web server restarts it should load MySQL support.



Step 2. Download the SEOW files.

Download the Scorched Earth Install files from the SEOW File Releases page at Sourceforge - Latest Scorched Earth files - SEOW Web Site.

You need the latest DB, DCS and MP releases - that is 3 separate files. You want to download the packages - SEDB (The Database), SEDCS (The DCS Dynamic Campaign System) and SEMP (The MP Mission Planner), to your local hard drive.

The latest SEOW release files (4 June 2009) are:

SEDB32C

SEDCS v3.2.3

MP4 v4.555


(Alternatively, you can download B16Enk's wonderful all-in-one installer based on the Uniform Server product. This will install and configure the entire SEOW system for you, including MySQL, Apache and PHP at the click of a button. Note this all-in-one SEOW installer is now well out of date, and is not recommended.)


Step 3. Install the DCS Dynamic Campaign System on your local PC.

You will have downloaded a file similar to SEDCS-v3.1.1_installer.exe. This is an executable installation program. Just run this program and follow the instructions presented on screen.



Step 4. Install the database.

For MSAccess, simply place the .mbd file somewhere convenient on your hard drive, preferably in a folder that has no special restrictions on read/write permissions.

For MySQL you will have downloaded a file similar to SEDB31-MySQL-Unix.zip. This comes in two versions: (1) a Reference version which contains ALL information required to run campaigns in ALL supported sectors, and (2) a set of Lite versions. The Reference database contains well over 500,000 records and is not recommended for production use. The Lite versions are .sql files, which can be used to build sector-specific databases.

All these files are SQL Dump files that contain table and field names and data type information to build the SEOW Database tables. You will need a software package that can read SQL Dump files and create a table from them onto a Web Server, for example DBTools Manager or Navicat.

The latest versions of the database installation contain a Lite version for each supported sector, where you only have to install one .sql file for the campaign sector you want to use. This saves storage space on the Web Server if you do not intend to use all the other maps at this time. We will assume that you are installing from the Lite database files with a view to creating a database for the Kursk map.

- First, you need to create a new database on your MysQL server, using any name you wish, e.g. SEDB31_KurskLite.

- Next, you must run the corresponding SEDB31_KurskLite.sql file on your SEDB31_KurskLite database. The SEDB31_KurskLite.sql file creates all the tables that are required to run SEOW and also adds all the data to these tables.

- For a full SEOW install, e.g. for a high-volume ISP host, you might want to repeat this process for every sector, i.e. build a separate Lite database for each sector. Or, as above you might only want a couple. The main rule is that you cannot run more than one campaign in a single database at the same time.



Step 5. Install the Mission Planner on a Web Server.

You will have downloaded a file similar to MP4-v4.360.zip. This is a compressed zip file containing the PHP files and directories required to load to your Web Server for the installation of the Mission Planner.

- First, unzip the file to a directory in the document root of the your web server, it will create the necessary sub directories and install the PHP files in the correct directories.

NOTE : The default path for Icons used in the MP is "/SEOW/MP4/uniticons/", if you plan on installing the Mission Planner in a directory other than this, you need to change line 15 in the MP-Configuration file that reads : $IconLocation="/SEOW/MP4/uniticons/";, to the location you are using.

If you start the MP and can't see any of the Icons, this is usually the problem. Therefore, the easiest way to install the MP is to use the path "/SEOW/MP4" on your Web Server.




Step 6. Configuring the MP

You now need to add the Host Address, Host Name, Login Name and Password, so that the Mission Planner can automatically access the SEOW database.


This is done by typing in the following URL into your web browser http://localhost/SEOW/MP4/Scripts/MP-Admin.php, assuming that you used the default path and substituting your Web Server address for the localhost. Make sure that your MP4/Scripts/MP-Connections.php file is writeable. You can edit this file directly if you wish (using a text editor), but MP-Admin.php actually manages the database connections details directly. Detailed examples of connection formats for each type of database are written inside MP-Connections.php. Open this file in Notepad and have a read if you are unsure about what information is necessary.

With SEOW, you can run over 30 campaigns in different sectors simultaneously, by having one database per active sector. Using the General HQ tools, you can even transfer reinforcements between sectors, thereby making multi-sector campaigning easy and engrossing.


Installation Complete.


--IV/JG7_4Shades 09:26, 15 November 2008 (CEST)