The XigmaNAS development document shows that it has been updated, but apparently not actually reviewed by the author(s) before committing.
The document also covers the installation of
devel/git, which suggests the autor(s) are aware of the portsnap removal, but does not provide any application examples. In my view, the author(s) have left the updating of the document incomplete.
Those incidents suggest that not much care was taken to ensure accurate documentation. That's not good publicity for the project.
As for portsnap:
FreeBSD 14.0-RELEASE Release Notes
Just stick to the handbook and manuals of FreeBSD for documentation. To update the ports tree, see handbook chapter
4.5. Using the Ports Collection
If you have problems of any kind regarding FreeBSD, you find many users and FreeBSD developers willing to help in forums and mailing lists (Developers tend to use mailing lists more frequently).
Good luck.
I am currently encountering some issues. I am following the
official compilation manual to compile XigmaNAS. (Prior to this, I had already followed the Development Manual to prepare the development environment and download the XigmaNAS source code.) It instructs me to enter the relevant XigmaNAS directory and execute the ./make.sh script. After executing the script, select the “Select Compile Menu” option in the first menu that appears, then sequentially execute all options in the second menu that appears. My issue arises with options 3, “Build/Install the kernel,” and 6, “Build ports,” in the second menu.
The manual provides additional notes for this part of the second menu:
"
Select each menu item in order. (Hint: When given multiple choices, do one at a time. This way, many errors can be corrected or prevented before proceeding.) When you compile the ports in option 6-1 “build ports,” you need to compile the ports a second time with only the ports “CA_ROOT_NSS, ICU, and python2” selected before performing 6-2 install the ports. "【This paragragh is at the bottom of page 5 of the official PDF】
I have some questions about this prompt. I'm not sure exactly what it refers to. Does it mean that all interfaces that support multiple selections require multiple selections? However, the official PDF mentioned does not explicitly state which options should be selected at each step, and interfaces that support multiple selections do not have multiple options selected by default. Specifically, in option 3 “Build/Install Kernel” of the second menu, there are three options: “Pre-built,” “Build,” and “Install.” When the script reaches this point, only the “Install” option is selected by default.
However, when I checked the older compilation manual “How to Compile XigmaNAS from Scratch” (this manual is more detailed and is the one mentioned earlier that guides us to select FreeBSD 11.2 as the development platform, detailing which options to select at each step), I found that it selects all three options (prebuild, build, install) in this interface... yet it states at the bottom, “If you are unsure, keep the default.”
Clearly, the default options in the old version of the document differ from those in the new version. Which one should I stick with? If I follow the default settings in the new documentation and only select the installation option, what does the official prompt “
When given multiple choices, do one at a time. This way, many errors can be corrected or prevented before proceeding” mean? Because there are no other multiple-selection steps besides this one. Or does it mean that when building the port in the second menu (6-1), I should select only one port at a time from the multiple port options that appear, i.e., build only one port at a time? Does downloading ports one by one reduce the likelihood of errors?
Another thing: the manual instructs me to build the CA_ROOT_NSS, ICU, and python2 ports separately after building all the required ports, but the menu doesn't even have a python2 option. There's only python311... Should I manually build python2?
P.S. Although my task is to compile the XigmaNAS system, the forum and their chat channels are not very active, so I came here to ask the question. This seems inappropriate, but time is tight, my knowledge is limited, and I don't have any programmer friends. I'm truly sorry for bothering you. Perhaps you're not very familiar with compiling XigmaNAS either, but I optimistically believe that with your extensive experience and knowledge, you might be able to offer some guidance.If you can't help, that's okay. I'm already very grateful. ：）
Update: I also sent an email to the founder of the XigmaNAS project and posted on the XigmaNAS forum. XD However, people may be out enjoying their weekend. I hope someone will respond to me on Monday. XD
---------------------------------Update--------------------------------------------------------------------
I read the Development Manual again. I found a clue on page 6 that said:
“3 - Build/Install the Kernel. (The second screen has all options set by default!), do not change those options
if you don’t know what you are doing! It can cause errors during kernel building/installation!) ”
1)So should I select all three options—build, prebuild, and install? Should I select one at a time and execute it, or select all three at once?
2)When building ports in 6-1build, do I only select one port to build at a time until all the required ports are built, and then manually build CA_ROOT_NSS, ICU, and python2 (because python2 is not included in the build menu) all at once?
