-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathINSTRUCTIONS.TXT
92 lines (55 loc) · 3.18 KB
/
INSTRUCTIONS.TXT
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
XMLRPC Gateway Installation Instructions
* General:
The xmlrpc gateway is an application to act as a proxy that allows
simulators to register the gateway uri so objects using remote data may be
accessed from a central uri. To use the gateway, you must configure the
simulator to use the XmlRpcGridRouter module and supply your gateway
uri so your simulator will register open channels with the gateway
application. Your external applications using remote data will access the
object in the simulator by sending the gateway an xmlrpc message with the
channel and payload data. The gateway will proxy the call to the correct
simulator wich will process the call then send a response. The response
is returned to the gateway which forwards it back to your external program.
* Web Server:
1) Install the files into your web server document root, or prepare a new
document root to serve the application.
2) Move the config.inc file to a location outside of the document root and
edit gate.php and index.php to adjust the location to the file.
3) Edit config.inc and set the database connection parameters for your
database. See: http://php.net/manual/en/book.pdo.php for information
about the PDO database abstraction library.
4) Create the database...
* Database:
1) Create the database and set permissions for the user that will access
the data using the values in your config.inc file. See the inlcuded
file 'gateway_data.sql' for details. This file will create the table
for MySQL. You can make adjustments to support the databse you are
using. See: http://php.net/manual/en/book.pdo.php for more information
* Operation:
1) Create an object and install the included script. Note the channel
that is reported when the script starts.
2) Check for the channel in the database.
3) Use the included test to send a message into the simulator. You will
see a report in-world and will see the returned message from the test.
* Troubleshooting:
* Simulator<-->Gateway *
1) Check that the channel is registered in the database.
2) Look at your web server access and error logs to see that the simulator
is attemting to register the channel.
3) Check your simulator configuration for the proper module assignment and
port assignemnt.
4) Enable debugging in the gateway and watch the log for information.
* Application<-->Gateway *
1) Check your webserver access and error logs.
2) Enable debugging in the gateway and watch the log.
3) Be sure that the channel is valid and registered in the database.
Copyright (c) 2008-2012 BlueWall Information Technologies, LLC
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.