Sun Remote System Control (RSC) Användarhandbok

Kapitel 5 Använda verktyget `rscadm`

Med verktyget rscadm och dess delkommandon kan man sköta administrationen av RSC från värddatorn. Du måste logga in som rot på servern för att kunna använda rscadm. Flertalet rscadm-delkommandon kan också användas från RSC:s kommandoskal, men rscadm har fördelar om...

...du vill konfigurera om RSC och inte känner till vilka lösenord kontona har

...starta om RSC när det inte svarar

...säkerhetskopiera konfigurationsdata

...ladda ned inbyggd programvara till RSC

...synkronisera datum och klockslag i RSC med servern i övrigt.

Verktyget rscadm har följande delkommandon.

Tabell 5-1 Delkommandon för rscadm


Delkommando	Beskrivning
`help`	Visar en lista med `rscadm`:s kommandon och korta beskrivningar av vart och ett av dem
`date`	Visar eller ställer in datum och klockslag
`set`	Anger ett värde på en konfigureringsvariabel
`show`	Visar en eller flera konfigureringsvariabler
`resetrsc`	Startar omedelbart om RSC
`download`	Laddar ned inbyggd programvara till RSC:s flash-PROM
`send_event`	Registrerar en händelse; kan även skicka informationsmeddelanden
`modem_setup`	Förändrar konfigureringen av modemet på RSC-serieporten
`useradd`	Skapar ett RSC-användarkonto
`userdel`	Tar bort ett RSC-användarkonto
`usershow`	Visar information om ett RSC-användarkonto
`userpassword`	Anger eller ändrar en RSC-användares lösenord
`userperm`	Anger vilka tillstånd en användare skall ha

`rscadm`:s delkommandon

`help`

Det här delkommandot skriver ut ett grundläggande hjälpmeddelande med en lista över delkommandona i rscadm och en kort beskrivning av vart och ett av dem.

`date [-s] date [[mmdd]HHMM|mmddHHMM[ss]åå]][.SS]`

Använd delkommandot date för att visa aktuellt klockslag och dagens datum. Använd alternativet -s för att synkronisera RSC:s klocka med serverns vanliga. Om man anger ett datum med delkommandot kan man ställa in RSC:s klocka så att dess tidsangivelser skiljer sig från serverns.

I "date [[mmdd]TTMM|mmddTTMM[ss]åå][.SS] " finns en beskrivning av datumformatet.

`set` `variabelvärde`

Använd delkommandot set för att ange ett värde på en RSC-konfigureringsvariabel. I "RSC:s konfigureringsvariabler" finns beskrivningar av variablerna.

Du kan använda en nullsträng ("") för att ange att en variabel skall nollställas. Om värdet på en variabel skall utgöras av en sträng som innehåller mellanslag eller UNIX-skalspecialtecken, måste strängen skrivas inom citationstecken:

# rscadm set page_info2 ""
# rscadm set page_init1 "&F &E0"

`show [variabel]`

Använd delkommandot show för att visa värdet på en eller flera RSC-konfigureringsvariabler. Om du inte anger någon variabel visar RSC alla konfigureringsvariabler. I "RSC:s konfigureringsvariabler" finns beskrivningar av variablerna.

`resetrsc [-s]`

Det här delkommandot startar omedelbart om RSC. För att koppla ned alla anslutningar på ett snyggt sätt före omstarten använder du alternativet -s. Om du inte anger någon parameter utförs en hård omstart utan några förberedande nedkopplingar.

`download [boot]fil`

Med det här delkommandot kan du ladda den version av den inbyggda programvaran som lagras i filen fil på RSC. Om du anger boot kommer innehållet i fil att installeras i startsektionen i den del av RSC:s minne vars innehåll inte förloras när strömmen slås av. Om du inte anger boot kommer innehållet i fil att lagras i huvudprogramdelen i denna del av RSC:s minne.

När överföringen är klar startar RSC om sig själv. Om nyckelbrytaren för värddatorn står i läget för låsning kan det inte ske någon uppdatering av RSC:s inbyggda programvara och ett felmeddelande visas.

`send_event [-c]meddelande`

Använd det här delkommandot för att mata in en händelse i RSC:s händelselogg. Använd alternativet -c för att även skicka ett informationsmeddelande om händelsen (på det sätt som anges i konfigurationen). ASCII-strängen meddelande får inte vara längre än 80 tecken. Om värdet på en variabel skall utgöras av en sträng som innehåller mellanslag eller UNIX-skalspecialtecken, måste strängen skrivas inom citationstecken.

I Bilaga C finns ett exempel på ett Perl-skript där delkommandot används för att skicka ett informationsmeddelande.

`modem_setup`

Använd det här delkommandot för att ändra konfigureringen av modemet på RSC:s serieport. Om modemet är korrekt anslutet kan du mata in vanliga AT-kommandon och se hur modemet svarar på dem. I början av raden matar du in avslutningssekvensen (~) följd av en punkt för att gå ur delkommandot:

# rscadm modem_setup
AT <enter>
OK
~.
#

Avslutningssekvensen för rscadm modem_setup är alltid ~. Den sekvens man använder för att gå ur RSC-konsolen kan konfigureras, men avslutningssekvensen för rscadm modem_setup är hårt kodad.

Delkommandon för administration av användarkonton

För att administrera användarkonton med rscadm från värddatorn loggar du in på värddatorn som rot och använder rscadm med följande delkommandon:

useradd (se "useradd användarnamn ")

userdel (se "userdel användarnamn ")

usershow (se "usershow [användarnamn] ")

userpassword (se "userpassword användarnamn ")

userperm (se "userperm användarnamn [c][u][a][r] ")

Felmeddelanden från `rscadm`

Det här avsnittet innehåller ytterligare beskrivningar av felmeddelanden från rscadm. De första 12 meddelandena gäller användningsfel.

ANVÄNDNING: rscadm <kommando> [alternativ]

För att få en lista med delkommandona skriver du rscadm help.

ANVÄNDNING: rscadm date [-s] | [[mmdd]TTMM | mmddTTMM[ss][åå][.SS]

Följande värdeområden gäller för datumparametrar:

01 <= mm <= 12
01 <= dd <= 31
01 <= HH <= 23
00 <= MM <= 59
19 <= cc <= 22
00 <= yy <= 99
00<= SS <= 59

ANVÄNDNING: rscadm download [boot] <fil>

ANVÄNDNING: rscadm resetrsc [-s]

ANVÄNDNING: rscadm send_event [-c] "meddelande"

ANVÄNDNING: rscadm set <variabel> <värde>

ANVÄNDNING: rscadm show [variabel]

ANVÄNDNING: rscadm useradd <användarnamn>

ANVÄNDNING: rscadm userdel <användarnamn>

ANVÄNDNING: rscadm userpassword <användarnamn>

Du försöker skapa ett användarkonto för en användare som redan har ett konto på den här servern.

ANVÄNDNING: rscadm userperm <användarnamn> [cuar]

ANVÄNDNING: rscadm usershow [användarnamn]

Detta program MÅSTE köras som rot

Inget att tillägga.

Du skrev inte in samma lösenord, försök igen

När man kör delkommandot userpassword matar man in lösenordet två gånger. Om lösenorden inte stämmer överens ber datorn att man skall göra en ny inmatning.

rscadm: antingen upptäcktes ingen RSC-maskinvara eller så hittades en låsfil. rscadm kan endast köras i en instans åt gången

Inget att tillägga.

rscadm: användaren finns redan

Du försöker skapa ett användarkonto för en användare som redan har ett konto på den här servern.

rscadm: användarnamnet började inte med någon bokstav eller innehöll inte någon liten bokstav

Det användarnamn du angav när du försökte skapa kontot följer inte reglerna.

rscadm: användarnamnet finns inte

Du angav ett användarnamn som inte tillhör något användarkonto på servern.

rscadm: den maximala längden för användarnamn är - 8

Du matade in ett användarnamn som var längre än åtta tecken (den maximala längden för användarnamn).

rscadm: det finns inte plats för fler användare

Det här felmeddelandet får du om du försöker skapa ytterligare ett användarkonto, när RSC redan har fyra användarkonton konfigurerade. RSC stöder endast fyra användarkonton; innan du kan skapa ytterligare ett måste du ta bort ett befintligt.

rscadm: FEL, initiering av callback misslyckades

Ett internt fel inträffade när delkommandot download utfördes.

rscadm: FEL, kunde inte skapa meddelandekö

Ett internt fel inträffade när delkommandot download utfördes.

rscadm: FEL, lösenorden stämde inte överens

När man kör delkommandot userpassword matar man in lösenordet två gånger. Om lösenorden inte stämmer överens ber datorn att man skall göra en ny inmatning. Om de inte stämmer denna gång heller misslyckas delkommandot.

rscadm: Fel vid nedladdning av fil

Ett internt fel inträffade när delkommandot download utfördes.

rscadm: felaktigt användarnamn

Du använde otillåtna tecken i ett användarnamn.

rscadm: felaktig variabel

När du använde delkommandot set matade du in en felaktig variabel. I "RSC:s konfigureringsvariabler" finns information om korrekta värden.

rscadm: felaktig variabel eller felaktigt värde

När du använde delkommandot set matade du in en felaktig variabel eller ett felaktigt värde. I "RSC:s konfigureringsvariabler" finns information om korrekta värden.

rscadm: filen är ingen giltig s-post

När delkommandot download utfördes upptäcktes det att filen inte var någon giltig s-postfil.

rscadm: filen kunde inte öppnas

När delkommandot download utfördes kunde inte den fil du angav på kommandoraden öppnas.

rscadm: händelsemeddelanden får inte vara längre än 80 tecken

Meddelandet i delkommandot send_event får inte vara längre än 80 tecken.

rscadm: INTERNT FEL, spill i callback

Ett internt fel inträffade när delkommandot download utfördes.

rscadm: INTERNT FEL i ställ in datum

Det här är ett internt fel i rscadm.

rscadm: Kan inte starta om RSC-maskinvaran

När delkommandot resetrsc utfördes misslyckades ett försök att utföra en hård omstart av RSC.

rscadm: kommandoraden för lång

Se efter om det finns någon extremt lång kommandorad.

rscadm: kunde inte ändra lösenord

RSC påträffade ett internt fel när lösenordet för en användare skulle ändras. RSC:s SEEPROM kan vara trasig.

rscadm: kunde inte ändra tillstånd

RSC påträffade ett internt fel när de tillstånd en användare har skulle ändras. RSC:s SEEPROM kan vara trasig.

rscadm: kunde inte ansluta till modem

När delkommandot modem_setup skulle utföras kunde RSC inte ansluta till RSC-modemet. Är modemet korrekt anslutet? Det kan hända att modemet används av delsystemet för personsökning eller att RSC är anslutet till ett annat modem.

rscadm: kunde inte få fram information om användaren

RSC påträffade ett internt fel när användarinformation skulle tas fram med delkommandot usershow. RSC:s SEEPROM kan vara skadad.

rscadm: kunde inte koppla ned från modem

När delkommandot modem_setup utfördes vägrade RSC att koppla ned från modemet.

rscadm: kunde inte lägga till användare

RSC påträffade ett internt fel när ett användarkonto skulle skapas. RSC:s SEEPROM kan vara trasig.

rscadm: kunde inte läsa datum från RSC

Ett odefinierat fel inträffade i RSC:s inbyggda programvara när RSC-datum skulle läsas.

rscadm: kunde inte skapa tråd

När delkommandot modem_setup utfördes gick det inte att skapa en tråd.

rscadm: kunde inte skicka data till RSC

RSC bekräftar inte att data har tagits emot. Fungerar RSC?

rscadm: kunde inte skicka informationsmeddelande

När delkommandot send_event utfördes kunde RSC:s inbyggda programvara inte skicka händelsen.

rscadm: Kunde inte skicka modemdata till RSC

RSC bekräftade inte mottagandet av sända data. Fungerar RSC?

rscadm: kunde inte ställa in datum på RSC

RSC upptäckte ett internt fel när datum skulle ställas in.

rscadm: kunde inte ta bort användare

RSC påträffade ett internt fel när ett användarkonto skulle tas bort. RSC:s SEEPROM kan vara trasig.

rscadm: ogiltigt lösenord

Du matade in ett ogiltigt lösenord. Ett giltigt lösenord är 6-8 tecken långt, innehåller minst två bokstäver och minst en siffra eller specialtecken.

rscadm: okänt kommando

Du använde ett delkommando till rscadm som inte finns.

rscadm: nedladdning misslyckades, RSC rapporterade borttagningsfel