Installation

If you are upgrading from a pre v0.4 release you need to first run pip3 uninstall sol as the package name has changed!

Requirements

SOL has rather small number of requirements:

Requirement Version Comment
Linux any
Python ≥ 3.7
GCC ≥ 8.3
CUDA ≥ 11.0 if using CUDA
VEOS ≥ 2.7 if using VE
GraphViz any if using debug features

SOL Closed Beta User Account

Before you can install SOL, you need to have a SOL Closed Beta User Account. If you don’t have one, please contact your NEC sales representative or use our application form.

How can I change my password?
Login to portal.neclab.eu and follow the instructions for password change.

My account got disabled/deleted. What can I do?
In this case you need to contact us, and we need to reenable your account manually.

Why does my account not work for the Bug Tracker?
For technical reasons, the login to the Bug Tracker uses _ instead of @ in your username. So something@your-domain.eu needs to be something_your-domain.eu.

Installing SOL installer

First you need to install the SOL installer using:

pip3 install --upgrade nec-sol

The SOL installer allow you to manage your installation. The installer automatically detects which frameworks you have installed, and only installs necessary SOL extensions. This means you need to install all frameworks you want to use prior installing SOL.

Installing SOL

For installing SOL modules, just run:

nec-sol install

The installer will prompt you to enter your login credentials and accept the user license agreement. Since v0.5.1 the installer automatically installs all SOL extensions that are supported on your system and that you have access to.

Uninstalling SOL

Just run:

nec-sol uninstall

Installing SOL on a remote system without direct internet connectivity

To install SOL on a server without internet connectivity run the following commands on a machine with internet access:

pip3 install nec-sol
pip3 download nec-sol
nec-sol download
scp *.whl target_machine:/some/path

Then switch to your target machine and execute:

cd /some/path
pip3 install nec_sol-*.whl
nec-sol install -f .

F.A.Q:

How can I upgrade/change the version of SOL?
For upgrading run: 
nec-sol uninstall
pip3 install nec-sol==YOUR_VERSION
nec-sol install
Be aware that previous versions of SOL used a different installer and might need different steps to be installed.

I totally messed up everything, how can I reset SOL?
  1. Don't Panic!
  2. run pip3 install --upgrade nec-sol. This should upgrade the SOL package manager to the newest version.
  3. run nec-sol uninstall
  4. run nec-sol install
  5. Done!

How can I download specific devices/frameworks?
Just use the --devices x86 ve nvidia and --framework torch numpy onnx tensorflow attributes for nec-sol.

PIP does not trust dav.neclab.eu OR I get following error: SSLError(SSLError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed (_ssl.c:852)'),)
Solution #1 (not recommended) Add --trust when running nec-sol.
Solution #2 On CentOS pip does not trusts not the systems certificates. As user you can fix this problem with: pip3 config set cert /etc/pki/tls/certs/ca-bundle.crt. As root you can fix this for all users using: 
sudo sh -c 'echo [global] > /etc/pip.conf'
sudo sh -c 'echo cert = /etc/pki/tls/certs/ca-bundle.crt >> /etc/pip.conf'
How can I decide to install into user or global site-packages?
By default the installer uses pip's default. Usually this is to install globally if run as root, otherwise to install to user. Using nec-sol install --user you can enforce installation into the user folder.