Local Sync Client

Översikt

Sync Client är ett skrivbordsprogram för att hålla SDA Console-projekt tillgängliga på en lokal dator eller en nätverksresurs. Programmet körs med en bakgrundstjänst och tillhandahåller ett fönster för att välja projekt, synkronisera versioner, checka ut projekt för redigering och checka in ändringar igen.

Arbetsflödet i programmet är detsamma på Windows och Linux. Plattformsspecifika anvisningar ges för installation och avinstallation; övriga skärmbilder visar det gemensamma gränssnittet.

Nedladdning

Ladda ned det senaste paketet för ditt operativsystem:

• Windows-installationsprogram
• Linux AMD64-paket

Installera Sync Client

Windows

1. Leta upp sync-client-windows-setup.exe i Downloads, högerklicka på filen och välj Kör som administratör. Administratörsbehörighet krävs.

   

   

2. Fortsätt från välkomstskärmen.

   

3. Välj installationsmapp. Standardplatsen rekommenderas.

   

4. Välj de tillgängliga komponenterna, inklusive skrivbordsgenvägen och automatisk start.

   

5. Behåll Run Sync Client markerat och välj Finish.

   

Linux

1. Ladda ned sync-client-linux.tar.bz2 och packa upp filen:

   tar -xjvf sync-client-linux.tar.bz2

2. Öppna en terminal i den uppackade katalogen:

   cd sync-client-linux

3. Kör installationsprogrammet med administratörsbehörighet:

   sudo ./install.sh

   

4. Kontrollera att terminalen rapporterar Installed Sync Client och listar det installerade paketet, CLI:t, skrivbordsposten, tjänsten och tjänsteanvändaren. Sync Client öppnas automatiskt när installationen är klar.

5. Logga ut från Linux-skrivbordet och logga in igen innan du använder Sync Client. Installationsprogrammet lägger till din skrivbordsanvändare i gruppen sync-client, och det nya gruppmedlemskapet aktiveras i den nya inloggningssessionen.

6. Efter att du har loggat in igen kan Sync Client öppnas från programstartaren eller från ikonen i systemfältet om programmet inte redan körs.

   

Konfiguration vid första användningen

Den inledande konfigurationen går automatiskt igenom:

Login → Storage → Filters / Policy

Skärmbilderna nedan visar Windows-versionen, men samma inställningar och kontroller finns tillgängliga på Linux.

Logga in

Ange din e-postadress och ditt lösenord för SDA Console, bekräfta API-URL:en och välj Connect.

Ikonerna bredvid fälten visar om de enskilda värdena verifierades. Efter en lyckad anslutning öppnar Sync Client automatiskt steget Storage.

Flerfaktorsautentisering

Om flerfaktorsautentisering är aktiverad för kontot anger du den sexsiffriga koden från autentiseringsappen och väljer Confirm.

Välj lagring

Sync Client kan lagra synkroniserade projekt i en lokal mapp eller på en SMB-nätverksresurs.

Lokalt filsystem

Välj Local Filesystem, välj Browse, välj projektmappen, ange synkroniseringsintervallet och välj Save.

SMB-nätverkslagring

Välj Network Location och ange:

• UNC Path: nätverksresursen och en valfri undermapp, till exempel \\fileserver\engineering
• Domain: Windows-domänen eller arbetsgruppen, när detta krävs
• SMB Username och SMB Password: ett konto med läs- och skrivbehörighet
• Sync Interval: hur ofta Sync Client söker efter projektuppdateringar

Välj Save för att verifiera och tillämpa inställningarna. När lagringskonfigurationen har sparats öppnar Sync Client automatiskt Filters / Policy.

Välj projekt och versioner

Använd Filters / Policy för att välja vilka projekt som ska synkroniseras och hur många versioner som ska förbli tillgängliga lokalt.

• Använd IDE, Vendor, Groups och Time Range för att begränsa projektlistan.
• Sök i projektträdet efter namn.
• Expandera grupper och välj hela grupper eller enskilda projekt.
• Ta bort ett aktivt filter genom att välja dess etikett.

Under Version policy väljer du Last N versions för att behålla ett fast antal senaste versioner.

Alternativt väljer du Since date för att behålla versioner som skapats efter ett valt datum.

Välj Apply och granska bekräftelsen, som sammanfattar aktiva filter, valda projekt, lagringsregeln och om äldre lokala versioner kommer att tas bort.

Arbeta med projekt

Hitta och synkronisera ett projekt

Öppna Projects och använd sökfunktionen, All eller Groups för att hitta ett projekt. När du väljer ett projekt visas dess tillgängliga versioner, tidsstämplar, IDE-information, lokala sökvägar, incheckningsmeddelanden och synkroniseringsstatus.

Använd Sync now för att begära en omedelbar synkronisering i stället för att vänta på det konfigurerade intervallet.

Checka ut och öppna ett projekt

Välj en projektversion och välj Checkout. Du kan lägga till ett valfritt låsmeddelande innan du bekräftar.

När utcheckningen är klar är projektet låst för ditt arbete. Projektvyn visar vilken version som är utcheckad och aktiverar Open project, Checkin och Discard checkout.

Välj Open project för att öppna den lokala utcheckningen med det utvecklingsprogram som är registrerat för den projekttypen. Motsvarande IDE måste vara installerat på datorn.

Sync Client startar först det registrerade utvecklingsprogrammet och öppnar sedan det utcheckade projektet.

Checka in eller förkasta ändringar

Återgå till Sync Client efter redigeringen och välj Checkin. Ange ett meddelande som beskriver ändringarna och bekräfta.

Stäng det externa utvecklings-IDE:t innan du checkar in. Ett öppet IDE kan lämna kvar låsfiler för projektet i utcheckningen och hindra Sync Client från att förbereda incheckningen.

Sync Client laddar upp det ändrade projektet, lägger till den nya versionen i versionshistoriken och släpper projektlåset.

För att i stället förkasta de lokala ändringarna väljer du Discard checkout och bekräftar.

Favoritprojekt

Använd stjärnan bredvid ett projekt för att lägga till eller ta bort det från Favorites. Ifyllda stjärnor markerar favoritprojekt och ger snabbare åtkomst från projektlistan.

Favoritmarkeringar visas även i det grupperade projektträdet.

Hjälp och diagnostik

Använd Export logs för att skapa ett diagnostikpaket för supporten. Exporten innehåller program- och tjänstloggar men exponerar inte sparade lösenord.

Öppna About för att se den installerade programversionen, licensinformation och tredjepartsmeddelanden.

Sync Client kan fortsätta köras i systemfältet. Använd systemfältsmenyn för att öppna programmet, visa dess status eller avsluta.

Kommandoradsgränssnitt

Installationen tillhandahåller även sync-cli, som kommunicerar med samma bakgrundstjänst som skrivbordsprogrammet.

Kontrollera tjänstens och synkroniseringens status:

sync-cli --status

Visa de aktuella icke-hemliga inställningarna:

sync-cli --show-settings

Begär en omedelbar synkronisering:

sync-cli --sync-now

Lista aktiva projektutcheckningar:

sync-cli --show-checkouts

Kör sync-cli --help för att se alla projekt- och utdataalternativ som stöds. Lägg till --json när kommandots utdata ska användas från ett skript.

Avinstallera Sync Client

Windows

Stäng först Sync Client från systemfältet. Öppna sedan Appar eller Program i Windows, välj Sync Client och slutför avinstallationsdialogerna.

Linux

1. Stäng Sync Client från systemfältsmenyn innan du kör avinstallationsprogrammet.

2. Öppna en terminal i den uppackade katalogen sync-client-linux.

3. Kör avinstallationsprogrammet med administratörsbehörighet:

   sudo ./uninstall.sh

   

Avinstallationsprogrammet tar bort programpaketet från /opt/sync-client. Konfiguration, synkroniserade data och loggar finns kvar i /etc/sync-client, /var/lib/sync-client och /var/log/sync-client så att de kan återanvändas eller granskas senare.