View source for Editing Config Files

You do not have permission to edit this page, for the following reason:

The action you have requested is limited to users in one of the groups: Users, ASL-Corp members.

You can view and copy the source of this page.

[[Category:How to]]
[[Category:Node Configuration]]
To modify your node beyond the basic settings of nodesetup.sh, you'll need to manually edit the config files. Of course, you'll need to know the user ID and password of your AllStarLink server. You also want to understand the [[Structure of Config Files|Structure of Config Files]] before you start.

=Linux CLI Editors=
For quick and simple changes the built-in Linux editors are the way to go. 
* [http://www.lagmonster.org/docs/vi.html vi] is pretty much the default editor on most Linux distros. Learn it, love it.
* [https://www.vim.org/ vim] is an improved version of vi with plugin support and many more features. To install:
<syntaxhighlight lang="text">apt-get -y install vim</syntaxhighlight>
* [https://www.howtogeek.com/howto/42980/the-beginners-guide-to-nano-the-linux-command-line-text-editor/ nano] is easier to learn and preferred by many.

=GUI Editors=
Many folks prefer a GUI editor and file transfer client over the Linux vi and nano editors. If you need to do a lot of copy and paste these are much easier. Here are some of the many clients out there. 

==For Linux==
* Most Linux distributions that have a Desktop (GUI) installed will have a text editor that is fully capable of properly editing files.  

==For Windows==
* [https://winscp.net/ WinSCP] is a popular file transfer and editor client. See [https://community.allstarlink.org/t/help-winscp-permission-denied-error-code-3-error-message-from-server-permission-denied/16267/4?u=wd6awp | Using WinSCP] Topic on Community.
* [http://www.putty.org Putty] is not an editor but you'll need it. It is '''the''' SSH and Telnet client. 

==For Mac==
* [https://panic.com/transmit/ Transmit] or [https://cyberduck.io CyberDuck] file transfer client.
* [https://macromates.com Text Mate] or [https://www.sublimetext.com Sublime] Editor.
* [https://github.com/macvim-dev/macvim MacVim] is a GUI based version of VIM

=Location of Config Files=
Nearly all of the files you'll need to edit are in /etc/asterisk

=Caveats=
There are other FTP/SFTP capable programs with GUIs like FilZilla that do not have built in file editing.  These will require you use/install a separate editor while using your favorite GUI FTP/SFTP client to transfer files.

==Editing on Windows systems==
Text files created on DOS/Windows machines have different line endings than files created on Unix/Linux. DOS uses carriage return and line feed ("\r\n") as a line ending, which Unix uses just line feed ("\n"). You need to be careful about transferring files between Windows machines and Unix machines to make sure the line endings are translated properly.

Several editors exist for Windows systems that can properly handle this LF/CRLF discrepancy:
* [https://notepad-plus-plus.org/ Notepad++]
* [https://www.vim.org/download.php Vim] - Several versions are available including gVim for Windows.

If you choose to use FileZilla or a similar FTP/SFTP client then it is recommended use you use one of the Windows Editors listed.  

'''''Note:  Notepad included with Windows was updated in 2018 to handle LF/CRLF but your mileage may vary.'''''

Return to Editing Config Files.

Retrieved from "http://wiki.pttlink.org/wiki/Editing_Config_Files"

View source for Editing Config Files

Navigation menu

Search