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.
- 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.
- Install Node Version Manager, NVM (Google it!)
- 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
- 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
- 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.
- 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!
- I unzipped *.zip.001 and 002 to c:\_SCA_Dev. However, there are missing files required to get your dev environment built.
- Return to file cabinet and download the original source files.
- Extract these using whatever unzipper you like to another directory. I used c:\_SCA.
- 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.
- Open a command prompt as administrator and change directory to the new code’s directory. In my case this was C:\_SCA_Dev.
- Install all the required modules.
- npm install
- Run gulp with no parameters to initialize it.
- gulp
- Start your local developer web server.
- gulp local
- 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
- http://[Your SCA Website URL]/c.[Your Account Number]/my-sca-ssp/shopping-local.ssp
That’s it. Super simple (I’m being totally facetious!).