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.0.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 launch the Pumas using the Desktop Icon again. Choose "enter license key".
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.
