diff options
Diffstat (limited to 'releng')
| -rw-r--r-- | releng/README | 116 |
1 files changed, 116 insertions, 0 deletions
diff --git a/releng/README b/releng/README new file mode 100644 index 0000000..0d552bf --- /dev/null +++ b/releng/README | |||
| @@ -0,0 +1,116 @@ | |||
| 1 | IMPORTANT NOTES | ||
| 2 | |||
| 3 | * Please note that at the moment, the sandbox login server has temporary changed from 8080 to 9000 - this will (probably) change back. | ||
| 4 | |||
| 5 | --- | ||
| 6 | |||
| 7 | BUILD INSTRUCTIONS | ||
| 8 | |||
| 9 | === Microsoft Visual Studio 2005 Sandbox Build === | ||
| 10 | |||
| 11 | * Check out the trunk code | ||
| 12 | |||
| 13 | * Build the /OpenSim.sln solution | ||
| 14 | |||
| 15 | * open cmd window, go to /bin and launch | ||
| 16 | OpenSim.exe -sandbox -loginserver | ||
| 17 | |||
| 18 | * open another cmd window, locate the secondlife executable | ||
| 19 | (In something like C:\Program Files\SecondLife ) | ||
| 20 | |||
| 21 | * run the viewer with | ||
| 22 | secondlife.exe -loginuri http://localhost:9000/ | ||
| 23 | |||
| 24 | * Have fun with your own sandbox! | ||
| 25 | |||
| 26 | == Linux/mono sandbox build == | ||
| 27 | |||
| 28 | * check out the trunk code | ||
| 29 | |||
| 30 | * ensure you have nant (http://nant.sf.net) installed | ||
| 31 | |||
| 32 | * cd to the trunk root directory and type "nant" | ||
| 33 | |||
| 34 | * cd to bin/ and run "mono OpenSim.exe -sandbox -loginserver" | ||
| 35 | |||
| 36 | |||
| 37 | RUNNING SANDBOX WITH USER ACCOUNTS | ||
| 38 | |||
| 39 | * open cmd window, go to /bin and launch | ||
| 40 | OpenSim.exe -sandbox -loginserver -useraccounts | ||
| 41 | |||
| 42 | * launch web browser, go to | ||
| 43 | http://localhost:9000/Admin | ||
| 44 | enter password 'Admin' | ||
| 45 | |||
| 46 | * Select 'Accounts', enter credentials, press 'Create' | ||
| 47 | |||
| 48 | * Now, log on thru your viewer (see above) with your newly created credentials. | ||
| 49 | |||
| 50 | * Have Fun! | ||
| 51 | |||
| 52 | |||
| 53 | |||
| 54 | PREBUILD | ||
| 55 | |||
| 56 | We use Prebuild to generate vs2005 solutions and nant build scripts. | ||
| 57 | |||
| 58 | === Building Prebuild === | ||
| 59 | |||
| 60 | At the moment, the Prebuild exe is shipped as /bin/Prebuild.exe so you shouldn't really have to build it. | ||
| 61 | |||
| 62 | But here's the instructions anyway : | ||
| 63 | |||
| 64 | The Prebuild master project is /prebuild.xml | ||
| 65 | |||
| 66 | To build it with vs2005 : | ||
| 67 | |||
| 68 | * build the solution /Prebuild/Prebuild.sln | ||
| 69 | |||
| 70 | To build it with nant : | ||
| 71 | |||
| 72 | * cd to /Prebuild/ | ||
| 73 | * type 'nant' | ||
| 74 | |||
| 75 | After you've built it, it will land in the root /bin/ directory, | ||
| 76 | |||
| 77 | === Modyfying the OpenSim solution === | ||
| 78 | |||
| 79 | When adding or changing projects, modify the prebuild.xml and then execute | ||
| 80 | |||
| 81 | bin/Prebuild.exe /target {target} | ||
| 82 | |||
| 83 | where target is either | ||
| 84 | vs2005 - to generate new vs2005 solutions and projects | ||
| 85 | nant - to generate new nant build scripts | ||
| 86 | |||
| 87 | Remember to run prebuild whenever you've added or removed files as well. | ||
| 88 | |||
| 89 | |||
| 90 | LOCAL SET-UP OF OGS CONFIGURATION | ||
| 91 | |||
| 92 | **NOTE: At the moment OGS is non-functionable, so this WON'T WORK **NOTE | ||
| 93 | |||
| 94 | * start up bin/OpenGridServices.GridServer.exe (listens on http://localhost:8001/gridserver) | ||
| 95 | * just press enter to keep the defaults | ||
| 96 | |||
| 97 | * start up bin/OpenGridServices.UserServer.exe (listens on http://localhost:8002/userserver) | ||
| 98 | * just press enter to keep the defaults | ||
| 99 | |||
| 100 | * start up bin/OpenSim.exe ( listens for udp on port 9000 ) | ||
| 101 | * just press enter to keep the defaults | ||
| 102 | |||
| 103 | * start the secondlife viewer with -loginuri http://localhost:8080/ | ||
| 104 | |||
| 105 | === Trying Prototype Scripting Engine out === | ||
| 106 | |||
| 107 | * Update, build and run in sandbox mode. | ||
| 108 | * Use the admin web front localhost:9000/Admin, password Admin | ||
| 109 | * Create an account, then log in with the viewer | ||
| 110 | * Press 'Entities' in the admin view and memorize the guids (well, try to) | ||
| 111 | * Create a new object in the viewer | ||
| 112 | * Refresh the entities view (You might have to empty cache....) | ||
| 113 | * Locate the new guid, that's the primitive you just created | ||
| 114 | * Be sure to see both the object in the viewer and the admin web front. | ||
| 115 | * Press 'add test script'. | ||
| 116 | * Enjoy the blinkenlichten! \ No newline at end of file | ||