README_WINDOWS.md

   1 # whitengold/SWG#
   2
   3 ### Dependencies ###
   4 ##### Windows #####
   5 1. Cygwin installed to c:\cygwin (DO NOT add c:\cygwin or c:\cygwin\bin to your Environment Settings/path)
   6 2. Add C:\whitengold\tools to your Environment Settings/path
   7 3. Make sure you are using Java 6 Update 1 and that all paths are lowercase
   8 4. During the install change the JDK install location to c:\jdk During the install you will be prompted where to install the JRE (which installs from the JDK installer and does not need another downloaded installer) Change this JRE location to c:\jdk\jre6
   9 5. Install Python 2.7.6 64 bit to c:\Python27 <--- again install location case sensitive
  10 6. Install Perl 5.18.4 64 bit to c:\Perl64 (This is the ActiveState Perl NOT Strawberry or the others) <--- again install location case sensitive
  11 7. Install OracleDB 12c 64 bit
  12 8. Install CMake 3.2.2 if you have not done so already.
  13 9. Additional "Environment Settings --- Path" settings after all the above are installed...
  14 Make sure there is a semi-colon at the end of your PATH line and then add the following:
  15 C:\Python27;c:\jdk\jre\bin;c:\jdk\jre\bin\client;C:\Perl64\site\bin;C:\Perl64\bin;C:\whitengold\tools
  16
  17
  18 ### Building ###
  19
  20 1. Open CMake 3.2.2
  21 2. Point it to the C:\whitengold\src folder
  22 3. Tell it to use C:\whitengold\build as the output location
  23 4. Click Generate
  24 5. Select Visual Studio 11 2012 (from the drop down list in CMake)
  25 6. Click finish
  26 7. If all went well and your dependencies are found properly, there will be no Red window inside CMake
  27
  28 Change the following names in exe/win32/*.cfg
  29
  30
  31 * CHANGE_IP                             <--- Replace with your LAN IP here
  32 * CHANGE_CLUSTER_NAME           <--- Replace with your Cluster name here, except on DSN which should be your oracle endpoint name
  33 * CHANGE_HOST                           <--- Replace with your LAN "host name" (this must be in c:\windows\system32\drivers\etc\hosts)
  34 * CHANGE_PASSWORD                       <--- Replace with your database password in exe/win32/*.cfg
  35
  36 Go to the c:\whitengold\build folder and open swgnge.sln with Visual Studio 2013. Change to Release in the Build Configuration type and compile.
  37
  38 ###### Configuration ######
  39
  40 If you are using Windows Firewall, add a firewall rule on Public & Private Network for Port 1521 so that you'll be able to communicate with the OracleDB listener.
  41
  42
  43 Once you've got OracleDB up and running (I'm hoping you have this already, since its such a pain in the buttocks to setup) Go to the c:\whitengold folder and give the OracleDB 3 or 4 minutes of being up and running (should be 5 services)
  44
  45
  46 * Start the c:\whitengold\Login.bat file
  47 * Wait 10 seconds minimum
  48 * Start the c:\whitengold\TaskManager.bat file
  49
  50 ***Note: Keep the TaskManager open and on the Process tab.***
  51
  52
  53 If after a few minutes, the PlanetServer.exe processes (all of them) crash (this happens sometimes, first time starting up), close out both console windows from Login.bat and TaskManager.bat. Wait 5 minutes (Minimum) and start it up again (the most crashes I've seen by rushing is twice in a row at any given startup)
  54