|
If you are hosting your store with Volusion or a certified partner, you
may skip
this installation step because a Volusion eCommerce representative will
install
your software for you. If you are hosting Volusion eCommerce on your own
server,
these instructions are for you.
When installing Volusion eCommerce, you should already have your Windows
2003 web
server configured with at least a default website. Once you have your
default website
up and running, you can simply transfer your Volusion eCommerce files
into your website's
directory.
Transferring Files
Use the Volusion
eCommerce Auto-Installation page to install your store using either
of the following two ways:
Send the files directly to your website via FTP.
Generate a customized zip file. Extract the zip
file to a directory on your computer (i.e., "C:\VolusioneCommerce").
Upload the contents of the zip file (i.e., "C:\VolusioneCommerce")
to your website via FTP.
 You may upload
your files to your root directory or any other directory, such
as "yourdomain.com/store". Just make sure you specify
the directory when generating your files on the Volusion eCommerce Auto-Installation
page. |
|
Required Components
In addition to your standard Windows 2000 or Windows 2003 Server
installation, you must install the following add-on components.
| Company |
Component |
Cost |
Description |
| Microsoft |
* XML
4.0 |
$0.00 |
Free upgrade
to Windows Server 2000 / 2003. (NOTE: XML 4.0 SP2 is NOT supported.) |
| Persits |
* AspEmail
5.0 |
$0.00 |
One of the most
popular e-mail components. Required for sending e-mails from
your store. |
| Volusion |
* Licensing
DLL |
$0.00 |
Licensing DLL
required to run Volusion eCommerce software. |
| Dimac |
* W3
Jmail 4.0 |
$0.00 |
One of the most
popular e-mail components. Required only for the ability of
the Newsletter system to handle bounced e-mail. |
| xAuthorize |
* xAuthorize |
$0.00 |
One of the best
payment processing components available, developed by our trusted
partner xAuthorize LLC (www.xAuthorize.com). Required only
for processing payments online directly through Volusion eCommerce. |
| ServerObjects |
* ASPImage |
$69.95 |
The most popular
image component, used to create thumbnails of the photos you
upload via the admin area. Not necessary if you create thumbnails
on your computer prior to uploading them.
http://www.serverobjects.com/products.htm#aspimage |
How to get these components:
Contact support@volusion.com to
request all free components (five of six). They are only "free" to
Volusion eCommerce licensed version owners. You must purchase the ServerObjects AspImage
component directly from ServerObjects via the link
above. |
|
* Required
for basic store functionality.
* Optional,
but HIGHLY recommended. Provides essential features that enhance
the overall ease of use & functionality.
To test for the existence of all required components, visit the
following page of your store:
http://www.yourdomain.com/admin/Server_Tests.asp
After installing all of the components, you may have
to reboot the server before being able to utilize the components.
Setting Permissions
| Once you have your Volusion eCommerce files uploaded to your website, proceed
through the following steps: |
Set the correct permissions on your directories (usually this must
be done by your hosting company). Give the "IUSR_machinename"
account "Read/Write/Modify" permissions to the following
directories and/or files:
| Directory/File |
When R/W/M permissions will
be necessary |
 |
/photos |
For uploading photos via the admin area |
|
/logs |
For storing log files |
|
/dataport |
For storing imported/exported files |
|
/css |
For allowing customization of colors in the
admin area |
|
/jmenu |
For dynamic javascript menu system |
|
/temp |
For temporary files to be written |
|
/downloadables |
For uploading software files via the admin
area |
|
/customer-downloads |
For allowing the customer to download software
files |
|
/templates |
For uploading "branding" images
via the admin area |
 |
/header.asp |
For applying Design Templates to your store |
|
/footer.asp |
For applying Design Templates to your store |
... OR you could
just set the permissions to your entire directory, to
avoid setting individual permission for each folder above. |
An easier, but less secure, option is to give "Read/Write/Modify"
permission to your entire store directory.
Also, if you are using an Access database, give your database directory
"Read/Write" permissions. Most hosting providers already
have a specific directory set up for you to utilize, for
example "/data". |
Troubleshooting Installation
The following scenarios may help you solve installation issues:
| I cannot access the website after
copying all the files into my website directory. |
| 1) |
Make sure you can access any static page in
your website, besides store files. For example, try going to "www.yourcompany.com/test.html" to
verify that you can access files in that directory. NOTE: You
must create a "test.html" or similar file.
|
| 2) |
a) Open up the Microsoft Access database on the server.
b) Open up the "ConfigSetup" table and check the following variables:
| Configuration
Variable |
Example Value |
| |
Config_DomainName |
www.company.com |
| |
Config_FullSecureStoreURL |
http://www.company.com/ |
| |
Config_FullStoreURL |
http://www.company.com/ |
| |
Config_StoreFolderName |
/ |
| |
NOTES:
- The URLs above must all have the same domain name or IP address.
- Be sure to include the forward-slashes where indicated above.
- FullSecureStoreURL should only contain "https://" AFTER
you've installed a SSL certificate for your website. |
|
| I get a "Permission Denied" error. |
| 1) |
Make sure you've setup the permissions as defined
above in the "Setting Permissions" section.
|
| I get a "Disallowed Parent
Path" error. |
| 1) |
You must enable parent paths on your Windows
server. In IIS, right-click your website and choose PROPERTIES.
Then click the HOME DIRECTORY tab. Then click the CONFIGURATION
button. Then click the OPTIONS tab. Then make sure "Enable
parent paths" is selected. While you're here, also make
sure "Enable session state" and "Enable buffering" are
also selected.
|
| I get a "Server.CreateObject
Failed" error |
| 1) |
This means that
you've not completely installed at least one of the required
components. Please contact your server administrator to
ensure that all components have been installed successfully.
|
| I'm getting an error with the XML test on the "/admin/ServerTests.asp" page. |
| 1) |
This means that you've installed MSXML 4.0 SP2, which must be uninstalled and reverted back to SP1. To do this, please follow these steps:
(1) Uninstall all copies of MSXML that you've installed.
(2)Search all hard drives for "msxml4.dll".
(3) Delete this .dll file. NOTE: You'll have to stop IIS first, otherwise windows will not let you delete this file, often found in "C:\WINNT\system32" or "C:\WINDOWS\system32".
(4) Reboot the server.
(5) Go ahead and install MSXML 4.0 SP1, then reboot the server again. NOTE: To verify which version of XML you have installed, you can search all hard drives for "msxml4.dll" and mouseover it, which will cause a popup box to appear that will specify either SP1 or SP2 in the description.
|
| I'm getting an HTTP 405 error... |
| 1) |
See the following article on adding an extension for ".htm" to your IIS:
http://www.somacon.com/docs/iis_http_405_resource_not_allowed_error.html
|
|
