... | ... | @@ -28,4 +28,34 @@ Information on how to use DAX.scan can be found in the [DAX.scan overview wiki p |
|
|
## ARTIQ knowledge base
|
|
|
|
|
|
This wiki also functions as a knowledge base for ARTIQ where common issues and usage tips are enlisted.
|
|
|
Please navigate to the [view all pages](pages) section to find all topics in the knowledge base. |
|
|
\ No newline at end of file |
|
|
Please navigate to the [view all pages](pages) section to find all topics in the knowledge base.
|
|
|
|
|
|
## DAX Installation
|
|
|
|
|
|
1. Follow the instructions in the [ARTIQ Documentation](https://m-labs.hk/artiq/manual/installing.html) to install ARTIQ.
|
|
|
|
|
|
**Note: the following instructions assume that you are connected to the Duke network either directly or via VPN.**
|
|
|
|
|
|
2. Add the server name (`build-mblab`) and IP address to your computer's hosts file. Contact a system administrator (Brad or Leon) to get the IP address.
|
|
|
- **Windows:** the hosts file is located at `C:\Windows\System32\drivers\etc\hosts`. The easiest way to edit it is to run Notepad as administrator, and then open the file from there.
|
|
|
- **Linux and OSX:** the hosts file is located at `/etc/hosts` (or maybe `/private/etc/hosts` depending on your version of OSX?). To edit it, open your terminal and run `$ sudo nano /etc/hosts` (or whatever your preferred editor is).\
|
|
|
\
|
|
|
For all systems, add the following line to the hosts file:\
|
|
|
```<server-ip-address> build-mblab```
|
|
|
|
|
|
|
|
|
3. Follow the Nix/Conda instructions below, based on how you installed ARTIQ.
|
|
|
|
|
|
### Nix
|
|
|
|
|
|
Add the `dax-full` channel from our local Hydra server:
|
|
|
```
|
|
|
$ nix-channel --add http://build-mblab/channel/custom/dax/full/dax-full
|
|
|
$ nix-channel --update
|
|
|
```
|
|
|
Then add the server to your `nix.conf`, resulting in something like the following:
|
|
|
```
|
|
|
substituters = https://cache.nixos.org https://nixbld.m-labs.hk http://build-mblab
|
|
|
trusted-public-keys = cache.nixos.org-1:6NCHdD59X431o0gWypbMrAURkbJ16ZPMQFGspcDShjY= nixbld.m-labs.hk-1:5aSRVA5b320xbNvu30tqxVPXpld73bhtOeH6uAjRyHc= build-mblab-1:gmwoAeEGb58k2gDPGuy7Q0rzE8rTgkHiVcMBHyN1YKI=
|
|
|
```
|
|
|
Then in your `shell.nix`, import `dax-full` and add any packages to your shell that you want. |
|
|
\ No newline at end of file |