Admin Installation Instructions
Step 1a: Install Visual Studio Code (3 scenarios)
Never Installed
- Download the VS-Code System installer for Windows from here
- Install in admin mode (Right-click the exe file and install as admin)
"User Installer" Installed
- Make sure you uninstall the existing installation from the Add/Remove programs in the Control Panel
"System Installer" Installed
- Make sure you check for updates and install
Step 1b: Close Visual Studio Code if it has been opened after installation
Step 2: Install Pumas Windows binary
- Click here to download the Pumas Installer binary and save the binary file (Pumas_v2.6.1.exe) to a location on your local machine. This file replaces the previous one.
- Start the Pumas binary as admin and install Pumas in admin mode, make sure you don’t disable Desktop and Start Menu Icon creation during installation.
Step 3: Launch Pumas using the Desktop Icon. Choose "enter license key" and enter your license key.
(Note: If you are upgrading your Pumas version, the license should already be registered and you don’t need to perform step3 again)
Step 4: Launch Pumas using the Desktop Icon, wait until the license information is printed and subsequently the REPL starts.
Step 5: Ensure that the license information is printed with the correct term of your license validity, once the verification is done, you can close the REPL window.
Step 6: Launch VS-Code and install “Julia for VSCode” extension from VS-Code marketplace
- Instruction details can be found here
Step 7: Open VSCode and Start the Command Palette by using either of these methods
- Keyboard shortcut:
Ctrl + Shift + P
- Select the gear icon on the bottom left panel of VSCode and select Command Palette
Step 8: In the Command Palette, type Julia: Start REPL and hit Enter when the selection is highlighted.
Step 9: A julia REPL (console) will open up in the bottom pane where the license information should be printed first along with the Pumas startup message.
Step 10: Type “using Pumas” beside the julia> prompt and hit the return key. If no errors show up, installation is successful, and you are ready to use Pumas!
If IT does a system-wide installation, first-time usage by a non-admin user will need to execute steps 3, 4, 5, 6, 7, 8, 9, and 10 from above.
Updating an active license
If you have received a new license key and would like to use that instead of an existing license key then call run the following command from the julia prompt
julia> PumasLicenseManager.activateLicenseFromTerminal()
You will then be asked to enter your new license key (including -
symbol). After hitting enter, you should receive confirmation that the new license has been activated.
Installation and Operation Qualification
To qualify your installation, follow the steps below:
- Download the PumasQualification.jl-2.6.0-1.zip file that was sent as an attachment in the email along with this document
- Extract the zip file and place it in a location that will document installation qualification.
- Open VSCode
- Add the PumasQualification.jl-2.6.0-1 folder into the workspace. There are many ways to do this:
- Drag and drop the extracted folder into the workspace
- Open Command Palette
(Ctrl + Shift + P)
and type “Open Folder”
- Select “Open Folder” and return. Then you navigate to the PumasQualification.jl-2.6.0-1 folder on your laptop and it should get added to your workspace.
- Start REPL from the command palette to start Pumas
- Right-click on PumasQualification.jl-2.6.0-1 folder in your VSCode workspace and select “Julia: Change to this Directory”
- Click on the Readme.md file and read the instructions
- IMPORTANT: Open the tests/Pumas-Automated-001.jl file and click on the Right facing triangle tab navigation which should read “Run Active File in REPL”. This will perform a suite of tests that will take about 10 minutes to run. Once completed and if successful, you should get a qualification report.