SuiteCommerce Advanced – QuickStart

I’m researching a project that touches both NetSuite and SuiteCommerce Advanced. Part of my research meant getting a development environment in place to review code in SCA version Kilimanjaro. We’ve hired consultants to modify SCA, so I needed to get the latest source tree up and running locally. Here’s my quick-start guide. Warning: It’s not that quick!

This is mostly outlined in the SuiteCommerce Advanced Developer’s Guide.

  1. In Windows, I went to Add-Remove Programs and uninstalled node.js. It’s too new and you can’t get rid of it if you install NVM after node.js is already installed.
  2. Install Node Version Manager, NVM (Google it!)
  3. Using nvm install the latest version of node.js. You’ll want that for everything except running SCA locally. Then use nvm to install node.js version 6.11.5.
    • nvm install latest
    • nvm install 6.11.5 (required for Kilimanjaro)
    • nvm list
    • nvm on
    • nvm use 6.11.5
    • node -v
  4. Install version 3.9.1 of gulp. I installed it both globally and locally. I’d bumped into problems where it said it needed to be installed locally. The documentation says it only needs to be installed globally. Don’t know!
    • npm install –global gulp@3.9.1
    • npm install gulp@3.9.1
  5. Download the latest current version of SCA source code. Each time you publish SCA, a backup of the code is placed in the file cabinet.
    download source
  6. Unzip the files using an unzipper other than Windows built-in unzipper. I downloaded WinRAR. When you open the *.zip.001, it unzips both files. Crazy!
  7. I unzipped *.zip.001 and 002 to c:\_SCA_Dev. However, there are missing files required to get your dev environment built.
  8. Return to file cabinet and download the original source files.
    Original Source Files
  9. Extract these using whatever unzipper you like to another directory. I used c:\_SCA.
  10. Copy the original source over the top of the most current source (C:\_SCA over C:\_SCA_Dev). When prompted to replace files, say NO, do not overwrite.
  11. Open a command prompt as administrator and change directory to the new code’s directory. In my case this was C:\_SCA_Dev.
  12. Install all the required modules.
    • npm install
  13. Run gulp with no parameters to initialize it.
    • gulp
  14. Start your local developer web server.
    • gulp local
  15. Open a browser and navigate to the testing URL for your SCA website.
    • http://[Your SCA Website URL]/c.[Your Account Number]/my-sca-ssp/shopping-local.ssp
      Testing URL

That’s it. Super simple (I’m being totally facetious!).



Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s