All technical and functional changes are described in the release notes.
Users need to be aware of (or act on) the following:
- Deactivate or comment out your CUtils commands in the scheduler / Crontab.
- CMX v4 needs to be up and running without errors before installing and activating CUtils. This is necessary because of the newly introduced encryption of the authorisation data (un/pw, keys etc...) by CMX. Cutils uses these data and requires the new file UniqueId.txt. Please run CMX as a service. See CMX4 / NET installation notes.
- If you make a new v4 install of CMX, be sure to transfer the complete distribution into your new utils directory. Also make sure you transfer from the old install CumulusMX directory:
- cumulusutils.ini
- strings.ini
- CUstringsXX.ini where XX stands for the language code you use. You may have more than one file of these. Note that it is the first two letters of the locale definition in cumulusutils.ini (e.g. en_GB). The locale is no longer used for storing data but in the context of CumulusUtils it defines the output formatting of your website. - If you use the CutilsCharts.def and CutilsMenu.def files - charts and menu system (Strongly Advised!!) - then please copy those files from your old install or copy the defaults from the distribution or create them from scratch (disadvised).
- When using the website, run once from the command line to get everything in place.
Code: Select all
dotnet utils/bin/cumulusutils.dll website - When using CUtils manual and/or modular, make sure your css and lib directories on the server have the correct libraries, update them manually when needed. Be aware that the URL parameter feature will probably work as well in modular use (using the compiler). This however has not been tested, please be prepared to communicate.
- Linux: Update your scheduler to reflect the dotnet command i.s.o. mono. This means that all commands to run CUtils must be of the form: Be aware that crontab does not know the PATH so you have to use the explicit path for the dotnet activation.
Code: Select all
/usr/share/dotnet/dotnet utils/bin/cumulusutils.dll <command> - Windows: When running Cutils from Task Scheduler use the full path for dotnet i.e. C:\Program Files\dotnet\dotnet.exe.
- Activate your scheduler tasks again (after you handle the HOWEVER).
HOWEVER...
CustomLogs
- If your locale has a decimal comma make sure you add the rc=y to the webtags!
- If you use CustomLogs and you did not use a comma separator between the webtags, you will most likely get errors for the UserAskedData command and you will need to edit your old logs for the separator between the values: replace <your separator> with comma (the new obligatory webtag field separator), make sure no space is left (remove possible multiple spaces between webtags)
- You will need to adjust your CustomLogs definitions to have the comma seprataor between the webtags. This can easiest be done with CMX shutdown and editing Cumulus.ini: replace "> <" with ">,<" in the section CustomLogs.
- You will need to edit the existing logs to change the spaces separators (see above).
- Don't forget to go into the CMX console and check the CustomLog definitions are OK after editing your inifile.
- When done and satisfied: run It should all be OK now.
Code: Select all
dotnet /utils/bin/cumulusutils.dll customlogs
CUtils V7 is able to detect duplication and order errors of data. For some reason CMX sometimes has duplicate times in the logs in the wrong order, this may create errors in charts and definitely faults your statistics.
This test is activated by default but if you wish to leave the errors (bad, but OK, it may be a lot of work) or when you are done correcting you can switch the test off by setting the parameter CheckDateOrder (section General) to false (default is true). It is a choice to act upon these warnings/errors but if you wish not to act, it is best to switch the feature off as the test takes time.
The errors are indicated in the logfile in the section reading the monthly logs during the creation of the graphs module.
If any corrections necessary: please notify me.