Installation

Nickel is meant for folks who know at least a little bit about code. It is highly recommended that you use Visual Web Developer 2010 Express or Visual Studio 2010 to update settings.

Step 1 - Copy Files

After downloading the source, copy the contents of the ZIP file to your site's location.

Step 2 - Create Web Application

You can skip this step if you are running on a shared server. Just make sure your server is running ASP.NET Framework 4. If you are running on a dedicated or home server, you'll want to create a web application.

1. From the Start button, go to Control Panel > Administrative Tools > Internet Information Services (IIS) Manager (be sure to open IIS 7, not 6, if you have both).
2. Expand your server on the left, click on "Sites" and choose "Add Web Site" from the "Actions" panel on the right.
3. Set your site's name, location on your hard drive where you copied the files in step 1, and binding info. Read this article if you're having trouble adding your web site.
4. Under your server name in IIS, click on "Application Pools", select the application pool for your site, and choose "Basic Settings" from the "Actions" panel on the right.
5. Choose .NET framework v4.x.xxxxx where the x's are the highest version number available. Use "integrated" for managed pipeline mode.
6. You may need to start or restart your site, application pool, or IIS.

Step 3 - Set Permissions

If you are on a shared server, your hosting company should have provided you with a control panel which will allow you to set permissions for web users. If you're configuring the site directly from IIS, it should now be listed under "Sites". To edit permissions, click on the site or folder and choose "Edit Permissions" from the "Actions" panel on the right. You'll be assigning permissions to the "IIS_IUSRS" group and/or the "IUSR_machinename account, depending on your operating system.

In addition to the standard "read" permission required for the entire site, please add "write" permissions for the following folders:
  • App_Data
  • uploads
Also make sure the "Bin" folder has "execute" permission, not not "write".

Step 4 [Optional] - Connect with Visual Web Developer 2010 Express

If you plan on making any advanced updates to the code, or simply want an easy way to change settings, it is recommended that you use Visual Web Developer 2010 Express. Follow these steps to connect to your web site:
  1. Go to File > Open Web Site.
  2. Choose the appropriate protocol for accessing for site (File System, Local IIS, or FTP). For FTP, enter your login information.
  3. Once the project is loaded, choose Website > Add Reference.
  4. In the "Add Reference" window, click the "Browse" tab, browse to your site root's "Bin" folder, select "Newtonsoft.Json.dll" and click "OK".

You're now ready to work on your site in VWD.

Step 5 - Choose a Pass Phrase

Nickel uses some nice, strong encryption for numerous fundamental operations. You cannot create accounts, articles, etc until you've set your pass phrase to use as an encryption key. This pass phrase is stored in code and is not visible to the outside world. You do not need to remember it, so it is recommended that you use something long and very complicated. Set it like so:
  1. Open "App_Code/Settings.cs" in a text or code editor (preferably Visual Web Developer 2010 Express).
  2. Find the PASS_PHRASE constant and set the value to whichever pass phrase you'd like to use for encryption. The value must be wrapped in double quotes.

Change this:
/// <summary>
/// Pass phrase for hash
/// </summary>
public static string PASS_PHRASE = "";
To something like this:
/// <summary>
/// Pass phrase for hash
/// </summary>
public static string PASS_PHRASE = "WRziKgTAJKkkEukx2zAH";

Step 6 - Create the Administrator Account

At this point, you are now ready to visit your web site. Open the URL in a browser and click on the "Register" link. Sign up! The first account created automatically becomes the administrator account. You may sign in immediately and update your profile.

Step 7 - Configure Mail

Nickel uses e-mail a lot to send activation keys, password reminder, subscription notices and more, so it's very important to get your mail server working. Follow these steps:
  1. Open "web.config".
  2. Change the value of the "from" attribute in the "smtp" node on line 15 to the reply e-mail address (this could be a real address or a noreply address).
  3. On the next line in the "network" node, change the value of the "host" attribute to your mail server. You can use Google mail if you don't have a mail server.
  4. The mail port is usually 25, but change it if you're using a secure connection or are required to by your mail server.

This is usually all you need to send a message. If your server requires you to login, you must do the following:
  1. Change the "defaultCredentials" attribute of the "network" node on line 16 in "web.config" to "false".
  2. Set the "userName" attribute's value to your login username (usually your e-mail address).
  3. The "password" attribute requires an encrypted password for security reasons.
    1. Visit your Nickel web site and sign in.
    2. Click on the "Encrypt tool" link under your account/admin options.
    3. Enter your password (case-sensitive) into the field in the "String encryptor" form and click the "Encrypt" button.
    4. Select the resulting, encrypted string and copy it to the clip board. Be sure not to including any leading or trailing whitespace.
  4. If your server requires a secure login, set "enableSsl" to "true".
    1. Paste the value into the "password" attribute back in the "web.config" file.

Installation Complete

Now it's time to configure your web site.

Last edited Dec 14, 2010 at 8:19 PM by BanTheRewind, version 7

Comments

No comments yet.