aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/bin/AssetServer.ini.example
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--bin/AssetServer.ini.example153
1 files changed, 153 insertions, 0 deletions
diff --git a/bin/AssetServer.ini.example b/bin/AssetServer.ini.example
new file mode 100644
index 0000000..f346624
--- /dev/null
+++ b/bin/AssetServer.ini.example
@@ -0,0 +1,153 @@
1[Config]
2
3; The port number for the asset server to listen on. If a valid SSL certificate
4; file is given for SSLCertFile, the HTTPS protocol will be used. Otherwise, the
5; HTTP protocol is used.
6ListenPort = 8003
7
8; An SSL certificate file for the server. If a valid raw certificate or PKCS#12
9; file is given the server will run in HTTPS mode.
10;SSLCertFile = server.p12
11
12[Extensions]
13
14;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
15; Storage Providers
16;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
17
18; Simple storage is a very basic storage system for the purposes of illustrating
19; a storage backend example. The assets are stored in SimpleAssets/ and
20; TempAssets/ (which is deleted when the server shuts down). Metadata is
21; generated for all of the files at startup and when new assets are uploaded.
22;SimpleStorage
23
24; OpenSimMySQL storage connects to a MySQL server that has an assets table created
25; by OpenSim. Open the AssetServer_Config.xml file from OpenSim and use the
26; database connection string for the database_connect option in the MySQL section
27; below. This backend combined with the OpenSimFrontend will allow the asset
28; server to be used as a drop-in replacement for OpenSim.Grid.AssetServer.exe,
29; while also allowing other frontends to run.
30OpenSimMySQLStorage
31
32; Uses Amazon.com's Simple Storage Service (http://aws.amazon.com/s3/) to store
33; asset data and metadata. This backend does not handle any data requests, as the
34; data is stored remotely and metadata replies will contain the amazon.com URL
35; holding the actual asset data. Your Access Key ID and Secret Access Key must be
36; set in the [Amazon] section below for this backend to function. If
37; UseCloudFront is true and your Amazon account has CloudFront enabled,
38; CloudFront URLs will be returned in metadata instead of normal S3 URLs.
39;AmazonS3Storage
40
41; Uses memcached (http://www.danga.com/memcached/) as a caching layer on top of
42; another storage backend. If you use this, make sure you enable another storage
43; provider as the actual backend, and that the MemcacheStorage line appears in
44; this config file after the other storage provider.
45;MemcachedStorage
46
47;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
48; Inventory Providers
49;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
50
51; Simple inventory is a very basic inventory storage system for the purposes of
52; illustrating an inventory backend example. The inventory is stored in
53; SimpleInventory/ by creating a folder for each agent that contains all of the
54; inventory items and folders serialized as XML files.
55;SimpleInventory
56
57; OpenSimMySQL inventory connects to a MySQL server that has an inventory table
58; created by OpenSim. If the OpenSimMySQLStorage backend is also being used, the
59; inventory and asset tables must be stored in the same database. The
60; database_connect string in the MySQL section below is used to connect to the
61; database. This backend combined with the OpenSimInventoryFrontend will allow
62; the server to be used as a drop-in replacement for
63; OpenSim.Grid.InventoryServer.exe, while also allowing other frontends to run.
64OpenSimMySQLInventory
65
66;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
67; Authentication Providers
68;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
69
70; OpenID provides a direct method of authenticating with the asset server. Users
71; can provide credentials and receive a session token directly from the asset
72; server. The OpenIdAuth module provides a browser-based form login and an
73; XML-based API, both accessible through the URL /authenticate.
74;OpenIdAuth
75NullAuthentication
76
77;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
78; Authorization Providers
79;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
80
81; Authorize all is a dummy authorization module that allows all requests for
82; metadata, data, and asset creation. Use this extension if your primary
83; storage provider or front-end interface does not support authentication.
84AuthorizeAll
85
86;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
87; Metrics Providers
88;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
89
90; NullMetrics contains empty logging functions. Use this metrics provider if
91; you want to disable metrics collection and reporting.
92NullMetrics
93
94;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
95; Frontends
96;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
97
98; A simple frontend that provides three basic REST methods. /assetid/metadata
99; will return the metadata for an asset (currently in LLSD format, that will
100; change soon). /assetid/data will return the raw asset data with proper
101; Content-Type and Content-Disposition headers to make downloading assets in a
102; web browser easy.
103ReferenceFrontend
104
105; A frontend that matches the existing OpenSim XML for transferring grid
106; assets. This will allow the asset server to function as a drop-in replacement
107; for OpenSim.Grid.AssetServer.exe, and can be combined with OpenSimMySQLStorage
108; to provide an identical replacement or any other storage backend.
109OpenSimFrontend
110
111; A frontend that matches the existing OpenSim XML for handling inventory
112; transactions. This will allow the asset server to function as a drop-in
113; replacement for OpenSim.Grid.InventoryServer.exe, and can be combined with
114; OpenSimMySQLInventory to provide an identical replacement or any other
115; inventory backend.
116OpenSimInventoryFrontend
117
118; An HTML interface for browsing through the asset store
119BrowseFrontend
120
121[MySQL]
122
123; Database connection string used by the OpenSim MySQL backend. If this line is
124; commented out or missing, the server will look for an AssetServer_Config.xml
125; in the current working directory. This file is generated by
126; OpenSim.Grid.AssetServer.exe and can be used without modification.
127database_connect = "Server=localhost; Database=opensim; User=changeme; Password=changeme;"
128
129[Amazon]
130
131; Get these values by logging in to your Amazon S3 account and going to
132; https://aws-portal.amazon.com/gp/aws/developer/account/index.html?ie=UTF8&action=access-key
133AccessKeyID = xxxxxxxxxxxxxxxxxxxx
134SecretAccessKey = xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
135
136; The bucket, or namespace, in your Amazon S3 account for storing assets in.
137; Bucket names on S3 are global identifiers, and must be unique. Think up
138; something clever or random.
139BucketName = changeme
140
141; Amazon CloudFront is a Content Distribution Network for S3 stores. If this is
142; set to true, AmazonS3Storage will try to locate the first available CloudFront
143; distribution tied to the active S3 bucket. If no usable distribution is found,
144; a new one will be created.
145UseCloudFront = true
146
147[Memcached]
148
149; A comma-separated list of the memcached servers that make up your caching
150; pool. Each server is a hostname or IP address, optionally followed by a
151; colon and port number if the server is not listening on the default 11211
152; port.
153Servers = localhost