Installing Znode

These instructions help with Znode setup from start to finish. The instructions are divided into the following parts:

TABLE OF CONTENTS


It is assumed that Znode's dependencies are already installed. If that's not the case, start by Installing Znode Dependencies first.

Part 1: Getting the Znode Code

It is also assumed that Git is already installed. If that's not the case, see Git's official installation guide and install it.

Run the clone command at a Git Bash window:

git clone https://github.com/amlacommerce/znode.git

If prompted to do so, provide your GitHub credentials.

Part 2: Creating a Znode Database

DB create scripts are kept in the repository to enable easy creation of a new database.

There is a 'create script' within each of the folders that end with the '(for fresh installation)' suffix. Choose the latest available version (or whichever version is desired).

For more detail about how these scripts are organized, see Database Scripts.

Once the desired DB create script is determined, follow these steps to run the create script and create the DB:

  1. Open SQL Server Management Studio (SSMS).

  2. In SSMS, open the DB create script.

  3. Run the script. A new Znode DB will be created.*

*Note that the default DB name is 'Znode_Multifront_X', where X is the version. Search and replace all occurrences of that string in the script to choose a different name if desired.

Part 3: Installing Web Compiler

Znode uses TypeScript and SASS to files for much of the source code. The browser only understands JavaScript and CSS though, so the Visual Studio solution must be configured to transpile *.ts files to *.js files and *.scss files to *.css files.

  1. Install the Visual Studio Web Compiler Plugin if not already done.

  2. In Visual Studio, for both the Admin UI (Znode.Engine.Admin) and WebStore (Znode.Engine.WebStore) projects, right-click on the compilerconfig.json file that is in the root of the project and go to the “Web Compiler” submenu, check the “Enable Compile on Build…” option.

Part 4: Configuring NuGet

To successfully build Znode, it is necessary to configure NuGet to access the private Znode NuGet Registry.

  1. NuGet credentials have most likely already been provided to you, especially if you are attending a schedule Znode training session. If you are unsure whether you have received these credentials, please search for an email with text "NuGet". If you have not yet received such credentials, then please request access to the Znode NuGet Registry by emailing support@znode.com.

  2. Add a custom NuGet package source in Visual Studio. Microsoft's instructions for doing so are here.

    1. The Source that needs to be entered into Visual Studio is http://nuget.znode.com/nuget.

    2. The Username and Password that needs to be entered into Visual Studio is that which the Znode team provided.

Part 5: Configuring, Building and Running Znode

With Znode's dependencies installed and NuGet configured, it is now time to run Znode.

  1. Open the main Znode solution, Znode.Multifront.sln.

  2. Set multiple startup projects. The following projects need to start:

    1. Znode.Engine.Admin

    2. Znode.Engine.API

    3. Znode.Engine.WebStore

  3. Build the solution.

  4. Configure SQL connection strings in the API's Web.config. The ZnodeECommerceDB, Znode_Entities, and ZnodePublish_Entities strings need to be configured. For both settings, set:

    1. Data Source, User Id, and Password to that which is used to connect with SSMS (or as desired).

    2. Initial Catalog to the name of the Znode DB. The default is Znode_Multifront_{VERSION} where {VERSION} is replaced with the version number.

  5. Run the solution. Visual Studio should automatically open the 3 applications in the default browser.

Part 6: Exploring Znode

Before exploring Znode in-depth, the following points should be known.

Logging in to the Admin UI

The Admin UI (running on http://localhost:6766 by default) requires credentials to log in. The default username and password are master-user@znode.com and Z14ode_13E, respectively.

Publishing the WebStore

On a fresh install, the WebStore (running on http://localhost:3288 by default) will present a message saying:

This store has not been published yet.

This is because the store has not been published yet (documentation on publishing available in Knowledge Base). To publish the store:

  1. Visit the “Stores” page on the Admin UI (http://localhost:6766/Store/List).

  2. Click the globe icon on the Demo Store row. This will publish the Demo Store.

  3. Refresh the WebStore (the localhost:3288 tab). The Webstore should now render with the default theme. There will still be no products or content because the default DB has no sample data.

empty default store

Note: Sample data used to be included in the default DB, but starting with Znode v9.3.1, the default DB is empty.

Troubleshooting Common Problems

If you run into problems while trying to get Znode to build and run, see Troubleshooting Common Problems for possible answers.

Next Steps

Congratulations if you have successfully made it this far!

It is important to note that these instructions walk through the process of building and running the Znode SDK repository. There is also a Znode Source Code repository available. Read the SDK vs. Full Source Development documentation to understand the purpose of the two repositories.

Review other parts of this documentation for more in-depth information where desired.

Sample Data Sets

Sample media for a B2B and B2C data set are available in the ZIP files at the following links.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.