Setup¶
This is a short tutorial describing the steps to install Polyfemos. SUDO privileges are needed. User ‘sysop’ will refer to the user (not sudo) hosting the polyfemos. User ‘admin’ will refer to the user with sudo privileges.
I General¶
Install ‘Anaconda’ (e.g. Anaconda3) and PIP if you haven’t already.
Extract the compressed file in which everything is contained. Suggested location is your home folder, so that the end result is as follows: ‘/home/sysop/polyfemos’
If wanted, move ‘data_out’ and ‘logs’ folders their preferred locations, or create additional folders (named for example ‘polyfemos_logs’ and ‘polyfemos_data_out’) somewhere in your computer.
Go to folder ‘/home/sysop/polyfemos’
Run ‘setup1.sh’ script to install all necessary packages. The user you are currently logged in as, will became the host of polyfemos. The script assumes you have anaconda installed. No need for sudo privileges.
II Backend¶
Check all ‘*.conf’ files and wrapper scripts in ‘conf/back’ folder
All settings of the backend are defined in ‘*.conf’ files. By default there are three ‘*.conf’ files: ‘driving_instructions.conf’, ‘folders.conf’ and ‘stations.conf’. For more about ‘*.conf’ files in chapter Configuration Files.
The program is advised to be called using bash wrapper file. The default file is ‘wrapper.sh’
Setup crontab. An example line running the backend script every minute:
* * * * * /home/sysop/polyfemos/conf/back/FN/wrapper.sh >/dev/null 2>&1
III Fontend¶
If your user does not have sudo privileges, change your user to user with sudo privileges. Make sure you are in folder ‘/home/sysop/polyfemos’. (Note that the home folder is the home of the host of polyfemos, not admin’s, if the users differ that is.
Check that filepaths in file ‘conf/front/global_config.yml’ exists. Most importantly fields ‘nginx_dir’, ‘env_dir’, and ‘service_dir’ should have correct file paths at this point. The field ‘passwd_file’ will be the used password file and if it doesn’t exist it will be created during the setup.
Run script ‘setup2.sh’, some commands in the script ask for sudo privileges.
Uninstall¶
Polyfemos comes with additional uninstall script ‘uninstall.sh’, which may be used to uninstall nginx, apache2-utils and to remove polyfemos_env conda environment and it’s unused dependencies. Additionally, the uninstall script removes files created during setup, but leaves the folder ‘/home/sysop/polyfemos’ otherwise untouched. In addition, the script doesn’t remove output data files or log files.
If you used setup scripts ‘setup1.sh’ and ‘setup2.sh’ for installing polyfemos, additional information about the setup is found in files: ‘polyfemos_installed_files.txt’ and ‘polyfemos_setup_log.txt’.