Usage documentation

Six Updater 2.0 is based on the previous updater and therefore the mechanics currently are much the same.

All features are documented within the program, just hover over an option, button, textbox or any number of other UI elements to get information.

Check Basics below, and the Six Updater+FAQ.

Basics

The updater is designed as a multi-purpose tool. It does not only support client-side mod update, but also running and configuring (dedicated) servers, multiple preferences and configurations.

The updater fetches server information from gamespy (Sync servers), as well as default presets, game profiles, mods, mirrors etc from the Updater Server Portal (Sync).

Additionally, the updater can fetch additional server configuration from servers with Six Updater+CustomRepos setup.

The updater can function as a game launcher and server browser - with the ability to join a server with automatic mod selection, download and update.

Specific community / server guides+requirements are usually listed on the information webpage for that community / server.

Furthermore there is support for Automations, Modfolder conversions and Linux. See the Six Updater+FAQ for more details.

Models

• Presets are a combination of Mods, Game Profile, Server and Action.
  The checkboxes and selection boxes on the Home RibbonTab, Actions and Selections, function as overrides for selected preset.
• Game Profiles determine the game edition, various paths, exe files, startup parameters and if Beta and/or server mode is enabled.
• Servers can contain mods and apps, automatically selected when joining a server. You can also save passwords.
• Actions are the various Updater actions that can be executed with selected preset and overrides. (Run updater button menu)
• Apps are either ServerApps (TeamSpeak/Mumble), ModApps (e.g put Jayarmalib's dsound.dll into correct place) and LocalApps (e.g to start Track-IR, Fraps or other software with the game).
• Mirrors are SU official network servers, serving Mods.
• Custom Repos are SU custom repositories (Community/Clan hosted Mods, Apps, Missions, etc)
• Hosts are SU custom repository mirrors
• Mods are the mods available on the official SU network
• Local Mods are mods found in your game and mod installation folders, which are either not found on the SU networks or are not yet converted.

Game Editions

You can select different game editions in Profiles selection box. There are auto detect profiles and specific profiles.

• Rv3 - Real Virtuality 3 Engine (A2/OA/TOH)
• Arma2 - The whole arma2 series
• Arma2St - Arma2 original standalone
• Arma2Ca - Arma2 original, so either standalone or combined ops
• Arma2Oa - Whole OA series (OA standalone, combined ops..)
• Arma2OaSt - OA Standalone
• Arma2OaCo - OA Combined Ops (original + OA)
• Takeonh - The whole Take on Helicopters series
• TakeonhSt - Take on Helicopters Standalone
• TakeonhRa - Take on Helicopters Rearmed
• TakeonhRaA2 - Take on Helicopters Rearmed (A2)
• TakeonhRaOA - Take on Helicopters Rearmed (OA)
• TakeonhRaCO - Take on Helicopters Rearmed (CO)

Paths

You can configure these from the Options dialog, accessible from the app menu (blue button left up).

• Game Path - Game folder
• Mod Path - Custom mod installation folder. Defaults to Path.
• Server Mods Path - Custom server mods installation folder. Defaults to ModPath.
• Pack Path - Where should the mod archives be stored? Modarchives are used for updating and repairing modfolders. By default they are contained in each modfolder\.rsync\.pack.

Server Owners

Updating your server with SU

Repository Hosting

You can host a custom repository with Mods (+versions) and Missions to your choosing, incl additional configuration like TeamSpeak server (auto-join, incl channel and password), etc.

Custom Repository: Six Updater+CustomRepos Setup

Official Mirror: Six Updater+Mirror Setup

rSync requires specific server setup with rSync daemon, where-as zSync only requires a simple web-server.

Hosting both should provides the best chance of successs even with elaborate firewall/antivirus/router types/configurations.

Tech Info

Configuration database / log files

• Default location: C:\users\{username}\appdata\roaming\Six-Updater.
Fall back: C:\users\{username}\appdata\local\temp\Six-Updater
• XP Users: C:\Documents and Settings\{username}\application data\Six-Updater.
Fall back: C:\Documents and Settings\{username}\local settings\temp\Six-Updater

Firewalls, ports and security/antivirus

Those with funky security systems, please note the following requirements

• Six Updater GUI.exe will make outgoing connections to the updater-server-site, over port 80/TCP, and to various RubyGems sites to fetch the latest updater libraries.
• SixUpdateCheck.exe will make outgoing connections to the updater-server-site, over port 80/TCP to fetch latest program data.
• tools\bin\rsync.exe will make outgoing connections to various rsync servers, over port 873/TCP, and possibly 873/UDP.
• tools\cygwin\bin\zsync.exe will make outgoing connections to various zsync (http web) servers, generally over port 80/TCP, yet any port is possible.
• tools\gslist.exe will make outgoing connections to various arma servers, incl the gamespy master server.

Please make sure the mentioned applications are fully allowed in your firewall software.

Please also check Software not working due to Antivirus.

Commandline parameters

Six Updater GUI.exe (GUI);

• --skip-autoupdate
  • Do not run the auto-self-update program. Especially useful for use in automation tools
• --preset=preset_id
  • Select preset
• --server=192.168.0.1:2302
  • Select or create Server
• --execute
  • Execute whatever preset is selected
• --execute=action1,action2,action3...
  • Execute whatever preset is selected, but perform specified actions. E.g: convert,update,startgame
• --shutdown
  • Shutdown the application after specified tasks have finished

SixUpdateCheck.exe (Auto Self Updater)

SixUpdater.exe (Console);

Usage: [config.yml] [options] -v, --[no-]verbose Run verbosely -i, --install Installs the mods, unless already installed -d, --uninstall Uninstalls the mods, unless not installed -u, --update Updates each mod to latest version -n, --convert Convert each mod available on the updater network to updater -r, --reset Resets the modfolders to latest commit status. All modifications lost -z, --userconfig Processes the userconfigs of each mod. Makes backups of previous files -k, --keys Processes the keys of each mod. Removes old keys automatically -l, --changelog Display Changelog after update -c, --cleanup Cleans up the modfolders git repositories -a, --afteraction Runs user-configurable after-action script -s, --createshortcut Creates shortcut to run the game with the mods, in installation folder -t, --createdesktopshortcut Creates shortcut to run the game with the mods, on the desktop -j, --join Starts the game with -noSplash -noFilePatching -showScriptErrors -mod= -connect= -port= -g, --startgame Starts the game with -noSplash -noFilePatching -showScriptErrors -mod= -w, --wait Waits at the end for user pressing ENTER -f, --force Forces to run tasks even though no changes were detected -q, --kill Kills the open processes --mods S Additional Mods --apppath S Destination folder

SixZsync.exe (Low level zSync, rSync, http/ftp functionality)

TODO

SixRsync.exe (Low level rSync functionality)

Deprecated - superseeded by SixZsync

Usage: six-rsync [folder] [options] -v, --[no-]verbose Run verbosely -i, --init Initializes Repository -s, --status Status of Repository -u, --update Updates Repository -c, --commit Commits changes to Repository -n, --convert Converts into repository --clone S Clones a Repository -o, --info Shows information from repository -l, --log Write logfile

Dev info

See Six Updater+Development.