U1 04 00

Code_Aster
Version
default
Titre : Interface daccs Code_Aster : astk Date : 10/10/2013 Page : 1/4
!es"onsa#$e : %at&ie' C()!T(I* C$+ : )1,04,00 !+-ision : 11.1/
Interface access to Code_Aster : astk
Rsum:
This document presents astk (contraction of Aster and Tk, pronounce astek), the application interface making
it possible to organize its Code_Aster co0"'tations.
ne describes the logic of operation of astk, the graphic interface itself, bsf !hich makes it possible to e"plore
the files on the #arious ser#ers, then one e"plains ho! the user can configure astk according to his needs.
$or a rapid access in Code_Aster, one sho!s starting from e"amples ho! to launch a stud%, to produce an
o#erload, to launch a list of benchmark and ho! to make a parametric stud%.
$or the people ha#ing access to the ser#er of Code_Aster co0"'tation of the &'$ net!ork, one e"plains ho!
to emit a file of fault, to reach the files back from e"periment ((&)), and, for the de#elopers, the tools of the
A*+A (!orkshop of Aster soft1are engineering).
+astl%, in one second part, one presents as_run !hich offers man% possibilities since the launching of a Aster
computation until the ad#anced features for the de#elopers.
The functionalities of astk #ersion ,.,- are described here !hich manages all the supported #ersions of
Code_Aster.
2arning : T&e trans$ation "rocess 'sed on t&is 1e#site is a 3%ac&ine Trans$ation3, It 0a4 #e i0"recise and inacc'rate in 1&o$e or in "art and is
"ro-ided as a con-enience,
5icensed 'nder t&e ter0s of t&e 67) 8D5 9&tt"://111,gn',org/co"4$eft/fd$,&t0$:
Code_Aster
Version
default
Table des matires
, .r/sentation and concepts g/n/rales0 .................................................................................................
,., '/marrage0 ....................................................................................................................................
,.1 $onctionnalit/s0 ..............................................................................................................................
,.2 3ode of fonctionnement4 ...............................................................................................................
,.0 5er#ers astk4 ..................................................................................................................................
,.4 .rofil astk6 ......................................................................................................................................
1 'escription of the interface graphi7ue8 .................................................................................................
1., 9ar of menu8 ..................................................................................................................................
1.,., 3enu $ichier: ........................................................................................................................
1.,.1 3enu Configuration; .............................................................................................................
1.,.2 3enu utils,1 .......................................................................................................................
1.,.0 3enu ptions,2 ....................................................................................................................
1.,.4 3enu Aide,0 .........................................................................................................................
1.1 +es onglets,0 ..................................................................................................................................
1.1., nglets &T<'&, T&5T5, 5<(C=A(*&,4 ..........................................................................
1.1.,., +iste of the t%pes for &T<'&,8 .................................................................................
1.1.,.1 +iste of the t%pes for T&5T5,8 .................................................................................
1.1.,.2 +iste of the t%pes for 5<(C=A(*&, part '>>&&5,8 ...........................................
1.1.,.0 +iste of the t%pes for 5<(C=A(*&, part (&5<+TAT5,: ........................................
1.1.1 9outon A*+A,: .....................................................................................................................
1.1.2 9outon (&),; .......................................................................................................................
1.2 .aram?tres of soumission1- ..........................................................................................................
1.0 9ar of /tat11 ...................................................................................................................................
1.4 5ui#i of the @obs11 ..........................................................................................................................
2 9oite of selection of filesA bsf12 ............................................................................................................
2., >a#igation10 ...................................................................................................................................
2.1 $ile menu and small conte"tuel14 ..................................................................................................
2.2 3enu Affichage14 ...........................................................................................................................
0 Configuration16 .....................................................................................................................................
0., 5er#eurs18 .....................................................................................................................................
0.1 Configurations18 .............................................................................................................................
0.1., .r/f/rences */n/rales18 ......................................................................................................
0.1.1 .r/f/rences (/seau18 ..........................................................................................................
0.2 utils1; ...........................................................................................................................................
0.0 Bmpression1; ..................................................................................................................................
4 Comment make a stud%C ................................................................................................................. 2-
4., Creation of the profil2- ...................................................................................................................
4.1 5/lection of the fichiers2- ..............................................................................................................
4.1., '/finition of a path of base2- ................................................................................................
Code_Aster
Version
default
4.1.1 A@out of files e"istants2- ........................................................................................................
4.1.2 A@out of filesD .................................................................................................................. 2,
4.1.2.,D !hile inserting a line #ide2, ..................................................................................
4.1.2.1D !ith Ealeur b% defaults ................................................................................... 2,
4.1.0 5upprimer a fichier21 ............................................................................................................
4.2 +ancement of the calcul21 ..............................................................................................................
4.0 +ook up of the r/sultats22 ...............................................................................................................
4.4 <tilisation of the outils22 .................................................................................................................
4.6 $onctionnalit/s a#anc/es22 ...........................................................................................................
4.6., e"ectool22 .............................................................................................................................
6 Comment to carr% out an o#erloadC ................................................................................................. 24
6., Addition of the sources24 ...............................................................................................................
6.1 '/finir results of the surcharge24 ...................................................................................................
6.2 .rise in account of the surcharge26 ...............................................................................................
8 Comment thro! a list of testsC ......................................................................................................... 26
: =o! to launch a stud% param/tri7ue28 .................................................................................................
:., '/finition of the clearance of param?tres28 ...................................................................................
:.,., &"emple of file distr ....................................................................................................... 2:
:.,.1 .r/Fpostprocessings common to all the calculs2: .................................................................
:.,.2 <tilisation of the parameters in the file of commandes2: .....................................................
:.1 *estion of the r/sultats2; ...............................................................................................................
:.2 +ancement2; ..................................................................................................................................
; +ancement of computations in parall?le2; ............................................................................................
;., 'istribution of calculs0- ..................................................................................................................
;.,., <tilisation of the resources disponibles0- .............................................................................
;.,.1 +ead time of e"piration0- ......................................................................................................
;.1 Acti#ation of the parallelism of Code_Aster0- ................................................................................
,- <tilisation of as_run0, .........................................................................................................................
,-., .our the utilisateur0, ....................................................................................................................
,-.1 .our de#eloper ........................................................................................................................ 0,
,-.2 .our maintain a locale01 instalment .............................................................................................
,-.0 .our application interfaces launching of the calculs02 .................................................................
,-.4 .our tasks of administration02 .....................................................................................................
,-.6 ptions02 ......................................................................................................................................
,-.6., .recise details suppl/mentaires04 ......................................................................................
,, Guestions $r/7uentes04 .....................................................................................................................
Code_Aster
Version
default
1 Prsentation and general concepts
the a#ailabilit% of tools as Code_Aster !hich functions on multiple platforms re7uires a graphic
interface to simplif% the !ork of the user.
Bn addition, the e#olution of the centralized midHsizeds of computation and the diffusion into free of
Code_Aster re7uired the de#elopment of a portable product !hose architecture can adapt to the
#arious computer setHups.
astk is the graphic interface !hich makes it possible to organize its Aster co0"'tations A prepare its
data, organize the files, reach the tools the pre one and postprocessing, launch and follo! the
e#olution of computations. astk also makes it possible to choose the #ersion of Code_Aster to be used
among those a#ailable (5TA, >&ID).
The name astk, pronounce astek, comes from the contraction from Aster and Tk !hich is the
graphic bookshop used.
1.1 Boot
.our thro! the application interface, it is enough to t%pe in a terminalA astk
&n g/n/ral, the command !as placed in the path b% default of the users, the application interface
opens !ith a default configuration (see J; 4< Config'ration).
Bf the command is not found, it is necessar% to launchA [aster_root]/bin/astk !here
[aster_root] is the director% of instalment of Code_Aster (contact possibl% %our administrator).
1.2 Functionalities
STUDY : astk makes it possible to launch a Aster co0"'tation on the local machine (for e"ample in
the frame of a use on personal computer), on a ser#er of departmental computation or of course the
ser#er of Aster co0"'tation of &'$H(K' (access restricted to &'$ and its people recei#ing benefits of
studies).
SURCHARGE : The diffusion of the source code of Code_Aster authorizes each one to test its o!n
de#elopments. astk makes it possible to o#erload the code, i.e. to add or modif% source files, to
create a particular #ersion and to use it on benchmarks or for studies. ne can thus create and use
the ne! e"ecutable ones, catalogues of commands or elements, and moduli p%thon.
TESTS : Bt is often @udicious to test that its o!n de#elopments do not impact the code in additionL astk
makes it possible to easil% launch a list of benchmark !ith a personal #ersion.
AGLA : To the de#elopers of the #ersion of &'$ reference, astk offers the access to the !orkshop of
soft!are engineering Aster, A*+A, !hich makes it possible to organize the commonsHbased peer
de#elopment of the de#elopment model (a#oid the conflicts, ensure the non regression oneD).
REX : To make li#e the code passes b% the taking into account of the remarks, needs, and user
opinions. $iles back from e"periment can be emitted and consulted b% the users since the application
interface, the de#elopers can ans!er it (access to the ser#er necessar% &'$). This functionalit% is
reser#ed at &'$ and to its people recei#ing benefits.
Code_Aster
Version
default
Titre : Interface daccs Code_Aster : astk Date : 10/10/2013 Page : =/4
MULTI-MACHIES : $iles necessar% to these #arious actions (mesh files, source, resultsD) can be
distributed on #arious machines on the net!ork (declared in astk), astk ensuring the rollout and
compressionFdecompression.
The transition of a firebreak is not proposed.
T!!LS : The user can launch #arious predefined tools and configure those !hich it needs (mesh
generator, tool for postprocessing, editorD).
"S# : A bro!ser is pro#ided (called bsf, bo" of file selection), it makes it possible to tra#erse the
files%stems of the definite remote machines and to carr% out current operations on the filesA cop%,
suppression, name change, printing, or to open a command !indo! from these machines.
AS$!" : ne can follo! computations, their state (in particular in the case of launching in batch)
since the !indo! 5ui#i of the @obs, also called asjob.
1. !perating process
architecture clientFser#er authorizes a clear separation bet!een the application interface (customer)
and the tools used to reach the code (ser#ices). The entrance point of the ser#er is as_runA it makes
it possible to use the group of the scripting of the A*+A to manage the #ersion of reference in batch
andFor to reach all the #ersions a#ailable on a net!ork or in room.
The communication protocol bet!een the #arious machines is rsh or =5 for the shell commands and
CC. or 5C. for the cop% of files. 9% default, one uses =5F5C. (rshFCC. is preser#ed such as the%
are and do not allo! to reach all the functionalities).
"#ample: Customer (i.e. the application interface launched b% the command astk or codeaster-
GUI) asks for the launching of a computation on a ser#er of computation.
The application interface e"ecutes a ser#ice as_run !hich is loaded to cop% the data files from the
ser#er (in an intermediate director% defined b% the aforementioned and shared b% all the nodes of this
ser#er), to re7uire of the ser#er to boot computation. The results of computation remain on the ser#er
of e"ecution (in the intermediate director% if the% are supposed being recopied to!ards the customer
or in their final director% if their destination is on the ser#er of computation). The results are repatriated
if necessar% on the client machine !hen state of computation is &>'&' in the follo!Hup of the @obsL
i.e. after a manual or automatic updating.
5o onl% connection in the meaning machine customer to!ards ser#er is re7uested (ke% #alid =5 for a
connection !ithout pass!ord). There are no more the connections opposite initiated b% the ser#er
to!ards the customer (as in the pre#ious #ersions to the ,.;).
3oreo#er, once sub@ected computation, connection net!ork bet!een the customer and the ser#er can
be stopped !ithout risk to lose computation because the data !ere alread% deposited on the ser#er
and the results !ill be repatriated onl% on re7uest of the customer (application interface).
$or the puristsA as_run is not trul% a ser#er in the facts, it does not ha#e there a daemon !ith
listening on a particular port. Bt is booted !ith the re7uest.
1.$ %er&ers astk
.our astk, a ser#er isA
that is to sa% a ser#er of Aster co0"'tation A a machine on !hich one can find as_run, i.e. all
the ser#ices !hich gi#e access the codeL one !ill be able to launch computations #ia this ser#er
and to use files on this ser#er for a computation,
is a file ser#erA one !ill be able simpl% to use files on this ser#er during a computation.
The ser#er called +ocal is in fact a file ser#er (onl% information of connection are necessar% for a file
ser#er, but one easil% kno!s them on the local machine.
Code_Aster
Version
default
Titre : Interface daccs Code_Aster : astk Date : 10/10/2013 Page : /4
Bf one !ishes to launch computations on the local machine (on !hich are installed a #ersion of Aster
and the ser#er part of astk), it is also necessar% to declare this machine like a ser#er of computation
(+ocal and 3achine in the follo!ing e"ample and M1.,.11.,.1).
Bn this document, one !ill call ser#er of reference the machine on !hich the de#elopment model of
inHhouse Code_Aster &'$ is managed. Certain functionalities are accessible onl% if the user has an
access to this machine.
Code_Aster
Version
default
Titre : Interface daccs Code_Aster : astk Date : 10/10/2013 Page : ./4
"#ample of configuration: (see JM 1.,.1N)
astk is used on the machine of name mach00, on !hich Code_Aster is insta$$ed. ne has access
to a departmental file ser#er file01, the files of this ser#er are accessible (assembl% >$5) since
t!o machines from computation comp02, comp03. ne has also access to a cluster !ith > nodes
of computation !hose frontal machine is front0.
ne has thenA
+ocal (reser#ed label)A one has it al!a%s to e"plore the files !hich are on mach00 L
3achine (unspecified label, fi"ed setup process this name !ith the #alue turned o#er b% the
command ! uname - # !)A !hose B. address is that of mach00 !hich is the ser#er of
computation (ser#ices as_run installed) of the local machineL
'eparture (unspecified label)A !hose B. address is that of file01, !hich makes it possible
to e"plore the files hosted b% the file ser#er, configured like a ser#er of computation Aster
(ser#ices as_run installed) ha#ing comp02 and comp03 seen as of the nodes of computation
(comp0i can be the same machine as file01)L
Cluster (unspecified label)A !hose address B. is that of front0 !hich is a ser#er of
computation (ser#ices as_run installed) ha#ing > nodes, the onl% accessible machine being
front0.
The difference bet!een 'epart and Cluster is that in general the stations of computation are
accessible directl% (one could thus sub@ect a computation in interacti#e on one or the other),
!hereas for a cluster, the users see in general onl% the frontal machine, the distribution being
made on the nodes b% a se7uencer of batch processings.
ne can as !ell ha#e se#eral ser#ers of computation 'epart or Cluster that not to ha#e onl%
the post +ocalO3achine.
1.' Profile astk
a profile astk is a file !hich contains all the relati#e informations !ith stud%, o#erload, etcA the site of
the files of the stud%, in data, result, the t%pe associated !ith each file, the parameters of submission
of computation (memor%, time, machine of computation, batchFinteracti#eD), in the e#ent of o#erload,
the site of the source files, e"ecutable, the product catalogsD
The profile also contains parameters on the application interface itself to resume a stud% e"actl% in the
same state !here it had been left.
The profile is recorded on re7uest of the user ($ile menu /!ecord or >nregistrer 'nder?) and !ith
each launching of a computation (it is the file !hose e"tension is, b% con#ention, $astk).
ne !ill speak more far from the file e"port (e"tension $e%port) !hich is a simplified
representation of the profile astkA it contains onl% information on the files and the parameters
necessar% to computation (and no information on the graphic interface).
Code_Aster
Version
default
Titre : Interface daccs Code_Aster : astk Date : 10/10/2013 Page : @/4
2 (escription of t)e grap)ic interface
graphic interface (*<B) breaks up into 0 partsA
,.A menu bar
1.+es mitres
2.+es parameters of submission
0.the bar of Pone
4.state of the arguments Aster

2.1 *enu bar
small the Aide also makes it possible to reach the description of the menus.
Figure 2+1: ,indo- main
. .2 4.1.,.
0
Code_Aster
Version
default
Titre : Interface daccs Code_Aster : astk Date : 10/10/2013 Page : //4
2.1.1 File menu

File menu A Allo!s to create a ne! profile.
!pen A pen a profile created before b% astk.
Record A The profile sa#es running (this is done automaticall% during the launching of a
computation).
Record under A The profile sa#es running !hile gi#ing the choice of the name of the profile and
its site.
.op/ under A Cop% the profile running in another director% and proposes to cop% the files (in data
andFor results) that it reference.
Import A
$e%port astk A A file .e"port of a preceding e"ecution (that can be the file Q.p>>>
director% R=3& reads a&ain/flashor).
$e%port astk 'addition mode( A contrar% to the con#entional importation !hich starts
from a #irgin profile, the files and directories present in the file .e"port are added to the
current profile. The parameters and arguments are ignored. That makes it possible for
e"ample to import a stud% in a profile of o#erload.
$e%port of a file )*+ A Bmport the files attached to a file of the (&) !hich one gi#es
the number.
benchmark A Bmport the files necessar% to the launching of a benchmark. The files are taken
on the selected ob@ect computer.
benchmark 'addition mode( A idem O the files are added to those alread% present in the
profile (including the o#erload).
"#port under A 3akes it possible to produce the file $e%port current profile.
Record in t)e base of studiesA Allo!s to add computation running in the data base of stud% as
an e"ecution of an e"isting stud% (onl% !ith one access to the ser#er of reference).
Figure 2.1.1+1: 0e-
Code_Aster
Version
default

.lose A Close the profile running
1uitter A $inish the application
+es > the last open profiles are directl% accessible starting from small $ichier.
2.1.2 %mall .onfiguration

%er&ers A Allo!s to modif% the configuration of the ser#ersA ser#ers of computation or file ser#ers
(see $igure 1.,.1H1).
$or the ser#ers of computation, one chooses the mode of do!nloading of the Aster config'ration A
the ser#er turns o#er the list of the #ersions a#ailable, the procedure (batch andFor interacti#e)
and the limits associated.
Bt is necessar% to indicate the logHon to use to connect itself to the ser#er, and the director%
!here Code_Aster is insta$$ed.
$or the file ser#ers, choose an% like mode do!nloading the Aster configuration.
Preferences A 'efines the preferences of the userA
*eneral (Eoir $igure 1.,.1H2)
.our astk A
>ame, first name, eHmail !ill be used for the restrain to!ards the management tools of
the e"perience feedback (emission, look up of the files of faults, e#olutionD).
The access to the functions of the !orkshop of Aster soft1are engineering if the user is
recognized as a Aster de#eloper on the ser#er of reference.
The access path to the editor and the terminal (!indo! "term) on the local machine, the
#ersion to select b% default, the number of remanent profiles in the $ile menu, the le#el
of message (debug).
ne can choose to displa% all the kno!n file t%pes, a short list or a personal choice,
sorted or not b% name (see M1.1.,1.1.,).
$or the follo!Hup of the @obsA
The number of lines displa%ed during the look up of a computation in the course of
e"ecution (tail), and the automatic fre7uenc% of updating in minutes.
>et!orks (Eoir $igure 1.,.1H0)
domain name net!ork of the machine and if mode '=C.FE.> (addresses d%namic B.) is
acti#e, possibilities of fi"ing #ariable 'B5.+AS for the displa% of the e"ternal applications, the
communications protocols used for the 5hell commands (rsh or =5) and copies it files (CC.,
5C. or rs%nc).
Bf one !orks onl% locall% or if all the machines are in the same net!ork field, one can lea#e
empt% domain name and be una!are of the !arning !ith the boot.
Caution A use option 'B5.+AS !ith full kno!ledge of the facts and onl% if the default #alue is
not appropriate. +ea#e the empt% field to let astk determine onl% the 'B5.+AS (according to
its #alue !ith the launching of astk, the domain nameD).

.olors A ,on-entional, ./*3 0ook, #ostal&ic, 1ersonali2ed,D
"nregistre
Figure 2.1.2+1: %mall .onfiguration
Code_Aster
Version
default
fonts the position and cuts !indo!s

Figure 2.1.2+2: %mall .onfiguration2%er&ers
Code_Aster
Version
default

Figure 2.1.2+: %mall .onfiguration2Preferences23eneral
Figure 2.1.2+$: %mall .onfiguration2Preferences2Rseau
Code_Aster
Version
default
Remar4ues
Gue one chooses protocol rshFCC. or =5F5C., connections must function !ithout pass!ordA files
.rhosts correctl% filled or pri#ate ke%sFpublic #alid 55=.
According to !hat turns o#er the command uname on the machine, it happens that astk thinks
of being on a remote machine and then makes a rsh or =5 to e"ecute a local commandD Bn this
case, the commonplace connection of the machine to!ards itself must also be configured.
2.1. Tools menu

Parameters A Allo!s to configure the launching of the tools.
Certain tools are en#isaged out of standard (!ithout ine#itabl% being a#ailable on the local
machine)A
1ostprocessin& 3ith ,ode_4ster A Tools of postprocessing, command 5TA>+&S,
1ass-throu&h of mesh A Allo!s to con#ert a mesh of a format to!ards another, the
formats a#ailable areA aster, med, &msh, ideas and &ibi,
,on-ertir 3ith format 0/5 A Allo!s to con#ert a con#entional base Aster !ith the
format ='$,
bsf A $ile e"plorer multiHmachines,
*ficas A &ditor of command file Aster,
Gibi A 3esh generator and tools of postprocessing (usable free !ith Aster),
Gmsh A 3esh generator and tools of postprocessing (free),
&race A *raph plotter 1'.
Ihen one chooses 5tanle% thro!, astk seeks in the profile the bases a#ailable (b% order
preferabl% a base in result, if there is not, a bhdf (='$ bases) in result, if not a data base
and finall%, a bhdf in data), produces a temporar% profile starting from the profile running !ith a
command file Aster !hich starts !ith 16U)7UI8* '( and !hich launches 784#9*: '(.
The user can add his o!n tools, to parameterize the path of access to tools (including modif%ing
the command of standard accesses to tools), to define in !hich file t%pes to associate the tools
and to specif% if one can use the tools on a remote file.
The follo!ing code" can be used in the command lineA
T$A absolute path of the selected file,
T(A director% containing the selected file,
TfA filename (!ithout the director%),
T'A addresses 'B5.+AS (that kno!n at the time of the launching of the interface).
Figure 2.1.+1: Tools menu
Code_Aster
Version
default
The tools are called either starting from the Tools menu, or starting from the conte"t menu on a
file of a list or in the bro!ser (right button).
To select a file, it is enough to click on its name in a list (in the mitre &tude, Tests or 5urcharge).
Ihile doubleHclicking on a file, association bet!een the t%pe of the file and the tools to be used
lean on the e"tension of the file name for the bsf, !hereas the t%pe selected b% the dropHdo!n list
(cf description of the mitres) pre#ails in astk.
2.1.$ %mall !ptions
A
Allo!s to position optional arguments !hich !ill ha#e passed on the command line of the
e"ecution of Code_Aster.
db&je-eu% A acti#ate a mode different from the management of the ob@ects in memor%
to detect crushings and destruction of ob@ects,
rep_outils A the director% defines !here the tools called since Aster 9 onmetis or gibi for
e"ample) are sought,
rep_de% A the director% defines !here are sought the offsite data (gi#en mesh),
rep_mat A the director% defines !here the data of the catalogue material are stored.
6);Init)ef< allo!s to contact acti#e a 5alom/ session (this #alue is automaticall%
positioned !hen astk is launched since 5alom/).
The selected arguments appear in the gra%ed part of the area of the arguments passed !ith
Code_Aster. The left part of this area is free.
.arameters
Figure 2.1.$+1: %mall
!ptions5rguments
Code_Aster
Version
default
Titre : Interface daccs Code_Aster : astk Date : 10/10/2013 Page : 1=/4
Bt is a 7uestion of defining optional parameters !hich !ill be !ritten in the file .e"port. The
three first are used during the launching of tests.
nbma%nook A ma"imum number of in#alid benchmarks (>U, A((&T_A>(3A+D)
before the interruption of the list of the tests,
cpresok A allo!s to choose !hich are the tests !hich one keeps the files result,
(&5UA one keeps the files of tests ok and >U,
(&5>UA one keeps onl% the files of the tests >U,
facmtps A multiplicati#e factor of the time of the tests (compared to the time of reference of
the para). <seful, for e"ample, !hen one sub@ects tests !ith e"ecutable built in mode to
debug, slo!er.
corefilesi2e< cut limiting file core at the time of a ptions
planting of launching
ncpus< the number of processors used b% sol#er 3<+T_$(>T mpi_nbcpu
defines< the number of processors for parallelism 3.B mpi_nbnoeud
defines< the number of nodes for parallelism 3.B defines (V the mpi_nbcpu
processors !ill be distributed)
classifies< allo!s to choose the class batch (or groups it of class) in !hich computation
!ill be sub@ected. Bt should ob#iousl% be checked that the class e"ists and that the parameters
time and memor% are compatible !ith this class.
departure< allo!s to differ the departure from a computation. The time of departure is
pro#ided to the format [[month<] da=<] hour< distribution
minuteA launch a parametric stud% (#alue %esFnot, see M::).
e%ectoolA launching b% using particular tools (see M4.6.,4.6.,)
multipleA the profile e"ecutes on se#eral machines (#alue %esFnot, see M;;).
2.1.' %mall 5id

AidF.arameters of computationF3enusA access to the te"t of .aram?tres
aid of computationsA allo!s to define the size memor%, the #ersion of Code_Aster !hich !ill be
used, the !a% of calculating (9atch or interractif),D
$ile menusFConfigurationFtoolsFoptionsD
=istor% of the amendmentsA &#olution of astk to the !ire of the #ersions, ne! possibilities,
corrections carried out, kno!n faultsD
Technical assistanceD
$re7uent problemsA 5ome 7uestions fre7uentl% put !ith their solutions.
Iindo! of the messagesA The informational messages WB>$X, of W&((&<(X errors are !ritten
in this !indo!. Iith a le#el of message e7ual to or higher than , (see JM 1.,.1N), one obtains
information more or less.
9% the !a%DA the impossible to circum#ent !indo! of information.

Figure 2.1.'+1: %mall Introduction
Code_Aster
Version
default
2.2 T)e mitres
ne finds fi#e buttons in this area. ne speaks about mitre !hen the contents !hich one finds under
the button change according to that !hich is in a hurr%. *raphicall%, the% are not true mitres because
the !idget does not e"ist in standard the Tk bookshop (and one did not !ant to add preHnecessar%
additionalY).
&T<'&, T&5T5 and 5<(C=A(*& are mitres in !hich one informs the list of the files necessar%L
A*+A and (&) are buttons !hich can use the contents of the other mitres.
+astl%, the checkbo" located beside the first four buttons announces that one uses (or not) the
contents of the associated mitre.
&"amplesA To launch a stud%, mitre &T<'& should be notched. To call upon the functions of the
A*+A (on the machine of reference), mitre A*+A should be notchedL it !ill be noted that in this case,
T&5T5 and 5<(C=A(*& are automaticall% notched because their contents are necessaril% taken
into account.
2.2.1 *itres "T6("7 T"%T%7 %6R.85R3"
.our to reach the files more easil%, to tra#erse the tree structures more 7uickl% (files being often
gathered in close directories), or to simplif% the displa% of the file names, one can define a c)emin de
bases.

ne defines it !hile clicking on the button .arcourir and one chooses the director% !hich !ill be
the default director%.
&ach mitre contains a list of files (t!o lists for 5<(C=A(*&).

ne defines a file or director% b% line. ne finds left to!ards the lineA
T%peA t%pe of the file or the director%L
5er#erA hostname on !hich the file isFdirector%L
>ameA access path to the fileA in absolute if it starts !ith Z/[, into relati#e compared to the basic
path in the contrar% caseL
<+A logical number of unit associated !ith this fileL
', (, CA checkbo"es to indicate if the fileFdirector% is respecti#el% in data, result, compressed
(!ith gzip).
Ihen the t%pe of a file is changedFdirector%, of the default #alues are positioned for indicators ', (, C
and the logical number of unit.
0otice on t)e t/pes:
Code_Aster &and$es t&e fi$es -ia t&e "roced'res 8(!T!A7 1&ic& 'se n'0#ers of
$ogica$ 'nit 9fi$e fort.19 for eAa0"$e:B it t&'s affects n'0#ers of $ogica$ 'nit #4 defa'$t
to si0"$if4 t&e $ife of t&e 'ser, T&e Ct4"eD t&'s 0akes it "ossi#$e to easi$4 reac& t&e
Figure 2.2.1+1: Basic pat)
Figure 2.2.1+2: 9ist files and directories
Code_Aster
Version
default
Titre : Interface daccs Code_Aster : astk Date : 10/10/2013 Page : 1./4
n'0#ers 'sed #4 defa'$tB it as 0akes it "ossi#$e astk to c&eck as t&e 'ser "ro-ides
co&erent data 9for eAa0"$e 1&ic& one "ro-ides 1e$$ a director4 for s'c& t4"e,
To handle the list, one has si" buttonsA
A a ne! #irgin input at the end of the list addsL
A a file addsFdirector% at the end of the list b% tra#ersing the tree structure of filesL
A remo#e the line currentl% selected in the list. A clickHright makes it possible to remo#e all
the linesL
A open the fileFdirector% currentl% selected in the list !ith the editor of the ser#er !here the file
(cf JM 0., 0., is). Bf it is about a director%, all the files of the director% are open !ith the editor
(attention !ith the directories containing man% files or binar% files not /ditablesY)L
A mo#e a line up!ardsL
A mo#e a line do!n!ards.
5rguments (mitre &T<'& and T&5T5 onl%)A
This te"t bo" makes it possible to transmit arguments to e"ecutable Aster. 5ee also JM1.,.0N.
.onte#t menu:
Ihile clicking !ith the right button on an input of the list, one reaches a conte"t menuA
penA launch the tools associated !ith this kind of file (determined b% the field 5tandard,
and not the file e"tension), if no tools are associated !ith this t%pe, one edits the fileL
&ditA edits the file (or all files of the director%) in the same !a% as the button L
pen !ithDA one can choose to open the file selected !ith one of the tools a#ailable (the
result can be astonishing if the tools do not kno! this kind of fileY)L
Ealues b% defaultA the interface determines a file name per defect according to the T%pe
chosen starting from the name of the profile (file $astk), no #alue is not proposed if the
profile !ere not recorded %et (is used in general on a #irgin line !hich one has @ust inserted,
indicators 'F(FC are not affected b% this operation)L
TerminalA a final !indo! "term .ropri/t/s makes it possible
to openA displa%s the permissions, the size, the date and the hour of the file (command ls
it).
*itre %6R.85R3"
5es gi-en 9so'rce fi$es: are "ro-ided in t&e &ig&er $istE 1&ereas t&e res'$ts
9eAec'ta#$eE co0"i$ed cata$og'es: are "ro-ided in t&e $o1er $ist,
Code_Aster
Version
default
Titre : Interface daccs Code_Aster : astk Date : 10/10/2013 Page : 1@/4
2.2.1.1 9ist t/pes for "T6("
C3A command files Aster (including the files of continuation)
eHmailA file mesh !ith the Aster for0at
!andersA file of error (fort.; of Aster)
messA file of the messages of the e"ecution
resuA results file (printing of the tests, printing to the Aster for0at)
basesA director% containing the base of computation
bhdf director% containing the base of computation to format ='$
castA file result !ith format CA5T&3
mastA kept for reason of compatibilit%
mgibA mesh !ith the format *ibi
mmedA mesh !ith format 3&'
mshA mesh !ith the format *msh
msupA mesh !ith format B'&A5
datgA command file *ibi
posA file result !ith the format *msh
ensiA director% result !ith the format &nsight
datA file result containing of the cur#es to format )3*(AC&
.5A file !ith the format postscript
agrafA file result containing the data for Agraf (the old #ersions of Aster !rote the directi#es
and the data in the same file that it !as necessar% to cut out !ith the command
post_a&raf on the machine of reference)
digrA file result containing the directi#es for Agraf
rmedA file result !ith format 3&'
un#A file result !ith the format <>iEersel (B'&A5)
distrA file of the #alues used for a parametric stud%
hostfileA file describing the resources machines to use (parametric stud%)
nameA to reco#er starting from its name, a file present in the temporar% director% Ftmp
paraA file of parameters (retranscription of the parameters of computation for the tests)
repeA result andFor data director% (makes it possible to transmitFreco#er the complete
contents of a director%L as one does not affect numbers of logical unit Aster must
reach the files b% their names).
director% of the results at the time of a parametric stud%
librA file or director% !ith the choice of the user
btcA scripting of launching generated b% the ser#ice (one can thus reco#er it, to modif%
itD).
At the time of a astout on the machine of reference, resu_test must be on the aforementioned.
At the time of a parametric stud%, the director% of the results (standard repe) must be on the ob@ect
computer.
2.2.1.2 9ist t/pes for T"%T%
listsA file containing the list of the tests to e"ecute (a name of test per line !ithout $comm)
rep_testA director% containing the data files of the tests (commands, meshD)
resu_testA director% !here the files btc results
are recopiedA idem &T<'&
hostfileA file describing the resources machines to use
2.2.1. 9iste of t)e t/pes for %6R.85R3"7 part (!00""%
$A sources $(T(A>
f;- sources $(T(A> ;-
CA sources C
p%A sources .%thon
cap%A sources of the catalogues of commands
cataA sources of the catalogues of elements, options, 7uantitiesD
histA file histor (historical of the amendments)
Code_Aster
Version
default
Titre : Interface daccs Code_Aster : astk Date : 10/10/2013 Page : 1//4
confA setup file (choice of the options of compilation, the bookshopsD)
unigA file uni&est containing the moduli to remo#e
datgA geometrical data
cmatA catalogues of &n g/n/ral
material characteristics, one pro#ides a director% for the first fi#e t%pes (sources)L all the files !hose
e"tension corresponds to the t%pe indicated are taken into account. >e#ertheless, it is disad#ised
mi"ing the file t%pes in the same director%.
hist, unig, datg and cmat are e"clusi#el% related to the management of the #ersion of reference.
2.2.1.$ 9ist t/pes for %6R.85R3"7 part R"%69T5T%
e"ecA file of e"ecutable Aster
cmdeA director% of the catalogue of command compiled
itA file of the catalogue of elements
btcA idem &T<'&
2.2.2 Bouton 5395
This button gi#es access the functions of the !orkshop of soft!are engineering !hich coordinates the
actions of the de#elopers of the #ersion of coherence. $or that, the bo" on the right of button must be
notched, !hich causes automaticall% to take into account the contents of mitres T&5T5 and
5<(C=A(*&, it is then enough to click on the button +ancer.
ne !ill refer to the manual of the A*+A (J',.-1.-,N) for more details on the #arious actions.
5%0! A allo!s to note moduli (to announce that one en#isages to restore an
amendment), applies to the source files and the files of test.
5%("0! A allo!s to indicate moduli. This action does not use an% the data of T&5T5
or 5<(C=A(*&. Ihen one clicks on +ancer, a !indo! re7uires to choose the t%pe of
modulus to indicate ($(T(A>FC, p%thon, catalogues or test), and to indicate the name
of the moduli separated b% a space, a tabulation or a return to the line (-it)out t)e
e#tension A op01>1 to indicate the file op01>1$f). $or the .%thon files, it is necessar%
to specif% the name of the director% (package in the .%thon denomination) in !hich the%
are (because contrar% to sources $(T(A> and C, the same name can be used in
different directories), e"ampleA macr_recal_ops?@acro (indicates the modulus
macr_recal_ops 3acro packa&e).
Code_Aster
Version
default

5%16IT A pro#ides in the file output the list of all the noted moduli.
5%:"RIF A check that a set of sources can be integrated in the #ersion of reference
(compliance !ith the rules of programming, file histor presentD).
PR";"(5 A it must be carried out before the meeting of the de#elopment team, the
de#eloper thus announces its intention to restore sources, .(&_&'A raises the points
!hich !ill ha#e to be regulated in meeting of de#elopment (.(&_&'A carries out a
A5E&(B$ and a transition of the tests pro#ided in the profile).
5%R"%T A it is the ultimate phase of the restitution !hich consists of a A5E&(B$, a
transition of the tests of the list of non regression, the return code must be lo!er or e7ual
to 1 so that the restitution is taken into account.
Remar4ue
5es f'nctiona$ities A65A are a-ai$a#$e on$4 on t&e ser-er of reference,
2.2. Bouton R"<
This button allo!sA
'[ "mettre a file -it)out =oining t)e profile A This function makes it possible to the user
to emit a file back from e"periment to report a fault in Code_Aster (AlA fault soft!are), ask
for an e#olution of Code_Aster (&+A soft!are e#olution), in one of the associated tools
(3etis, =omard, &ficas, astk, bsfD) (AA fault toolsF&A e#olution tools), an amendment
of documentation (&'A documentation e#olution), or a re7uest for e"pert testimon% in
modelization (A3A helps !ith the t!eaking of the modelization). The relati#e
informations !ith the transmitter of the file are accessible b% small
Config'ration/Interface. The files contained in the profile running are not @oined to the file,
!hich can make #er% difficult the processing of the file. Bt is ad#ised to use to emit a file
and to associate the files !ith it. The #ersion of Code_Aster indicated is that selected in
the application interface (Para0tres of co0"'tation).
'[ "mettre a file and associate t)e files -it) it A This function makes it possible to emit
the same t%pe of file as the preceding one, this time the data included in the profile are
united !ith the file. $or a fault, the files to reproduce the error should al!a%s be pro#ided.
Figure 2.2.2+1: -indo- 5%("0!
Code_Aster
Version
default
Ihat does not pre#ent the user from tr%ing to insulate as much as possible the
encountered problem, in particular to tr% to @oin a stud% on a model !hich re7uires little
memor% and C.< timeY
'e .onsulter files A gi#es access the management tools back from e"periment (on the
machine of reference).
Remar4ue
5es f'nctiona$ities !>F are a-ai$a#$e on$4 on t&e ser-er of reference,
Code_Aster
Version
default

2. fault of submission
+es parameters of computation are pro#ided in the right part of the main !indo!.
Figure 2.2.+1: "mission of a file of Paramtres
Code_Aster
Version
default

ne defines the 7uantit% ofA
8otal memor= used for the @ob (in megab%tes).
6f 3hich 4ster A limit memor% used b% Aster (and thus memor% for other products lea#es). 9%
default the memor% aster is e7ual to ;-\ of the total memor%.
the ma"imum time of computation (in seconds, minutesA seconds or hourA minutesA seconds).
ne chooses on !hich machine computation is e"ecuted, the #ersion of Code_Aster used, if
computation is sub@ected in batch or interacti#e. The option follo!ed interacti#e makes it possible to
e"ecute computation !hile follo!ing its e"ecution in a !indo! of the final t%pe. Bf computation is
launched on a remote ser#er, this terminal is e"ecuted remotel%. Therefore the application interface is
then locked as much as the e"ecution of computation is not finished to preser#e open connection =5.
debugFnodebugA for a stud% !ithout o#erload, one specifies !hich e"ecutable one !ishes to use
(pro#ided both are a#ailable)L at the time of an o#erload, one chooses to compile !ith or !ithout
information to debug.
The button +ancer e"ecutes the actions according to the notched mitres.
The button 5ui#i of the @obs opens the !indo! described after!ards.
!perating process (for a &T<'&)A
'uring the launching of a stud% (!ith or !ithout o#erload), a button of option is a#ailable beside the
button +ancer. Three modes of launching are a#ailableA
runA e"ecutes the stud% (con#entional operation),
dbgA launch the stud% !hile using to debug it,
preA prepare the !ork director% !ithout e"ecuting the stud%.
Ihen one selects dbg or pre, the mode to debug is selected b% default.
Figure 2.+1: 5reas of t)e
parameters of computation
Code_Aster
Version
default
2.$ Bar state
the te"t bo" located all in bottom of the main !indo! pro#ides of aid !hen one na#igate in the menus,
or !hen the pointer passes to the top of the buttons of the application interface.
'uring the launching of a computation, the operations in progress are displa%ed here.

2.' state of t)e =obs
Cette !indo! pro#ides information on the state of launched computations, !hich appear in the form of
a list. Ihile clicking !ith the right button on a computation, there are the follo!ing choicesA
To edit breaks up into $ichier output, $ichier error and $ichiers e"port !hich gi#es access to
the messages sent b% the @ob on the standard output (stdout) and the output of error (stderr).
ne can also reach the file .e"port used during the e"ecution. A doubleHclick on a @ob of the list
also displa%s the file output. These files are initiall% recopied locall% in a temporar% director% then
open !ith the local editor.
To do-nload t)e files results forces the recop% of the files results. This action is made
automaticall% !hen computation passes in state &>'&'. Bf this stage failed (problem net!ork),
that !ould make it possible to e"ecute it again.
To bring up to date 7uestions the ser#ers on !hom computations are in progress. The checkbo"
makes it possible to reactualize automaticall% !ith a fre7uenc% defined in Config'ration/Interface.
To bring up to date all refreshes the state of all not finished computations.
To remo&e erases the selected @obs of the list, the files related to this @ob in the flashor and stops
computation if the aforementioned is not finished (b% sending signal 5B*UB++).
To stop properl/ sends signal 5B*<5(, to computation. Code_Aster intercepts this signal to
stop computation, then the firm properl% base !hich !ill be repatriated (if a base is in result in the
profile).
To purge flas)or tra#erses all the ser#ers and remo#es there the files of the director% flashor
nonaccessible since the follo!Hup from the @obs.
To seek makes it possible to consult the last lines of the file message of a @ob in t&e co'rse of
eAec'tion (it does not do an%thing on a finished @ob). ne can use the te"t bo" $iltre to displa%
onl% the lines containing the character string indicated (in the form of rege").
The te"t bo" makes it possible to follo! the ad#ance of the re7uests e"ecuted on the remote ser#ers.
&ach line corresponds to a @ob, one finds ,2 columnsA
The number of the @ob (in batch), number of the process in interacti#e
the name of the @ob (name of the profile for a stud%, an o#erload, or name of function A*+A)
'ate of =eure
submission of &tat
submission of @ob (.&>', (<>, 5<5.&>'&', &>'&')
'iagnostic of @ob (ok, >U, WAX_A+A(3, W$X_&(((, W$X_A9>(3A+D)
>ame of the tail in batch or interacti#e
Temps C.< of the e"ecution Aster
+ogHon on the ser#er of computation used
5er#er address of computation used
3achine of computation (name of the node for a cluster)
Eersion of astk
Bndicateur batchF9oite
Figure 2.$+1: Bar %ui&i
Code_Aster
Version
default
interacti&e of file selection: bsf
bsf is tools deli#ered !ith astk !hich can be launched onl%. Bt is about a file e"plorer !ho allo!s to
na#igate on the local machine, like a con#entional file e"plorer, and also on the #arious configured
remote ser#ers.
bsf uses the configuration of the ser#ers of astk, in particular the fields necessar% to connection (B.
address, logHon) and the commands to open a terminal or an editor.
The reading of the configuration is made onl% !ith the boot of bsf, if one modifies the configuration in
astk, it is thus necessar% to close the bsf then to open it again.

Remar4ue:
#sf does not treat t&e director4 and fi$e na0es containing s"aces 9it res'$ts fro0 it an offset in t&e
na0es and t&e t4"es fro0 t&e fo$$o1ing o#Gects:,
Figure +1: bsf
Code_Aster
Version
default
.1 Bro-sing
ne finds t!o dropHdo!n lists in the !indo! of the bsf.
The first makes it possible to pass from a ser#er to another, the second memorizes the list of the last
t!el#e directories !here the user carried out an action (edition, cop%D). The first input of this list is
ZHHHHH 'irect HHHHH[, !hich makes it possible to go directl% in a director% !hich one seizes the name.
*enerall%, !hen the re7uired director% does not e"ist, one turns o#er in the =3& defined for the
current ser#er.
ne can configure this list and fi" certain directories (so that the% remain present in the list) !hile
clicking !ith the right button on the aforementioned (cf $igure 2.,).
A refresh the current director% contentsL
A go back to the parent director%L
A propose to create a ne! director% in the current director% (and places itself in this ne!
director%)L
A open a terminal on the current ser#er.
The bar of state gi#es indications on the meaning of these buttons !hen the mouse pointer passes to
the top.

Figure .1+1: ,indo- of configuration of t)e remanent
directories
Code_Aster
Version
default
.2 File menu and conte#t menu
ne finds certain inputs similar to the conte"t menu of the files in the mitres (see JM1.1.,N)A pen, &dit,
u#rir !ithD, .roperties.
.op/A allo!s to cop% one or more filesFdirectories (shortened b% CT(+OC).
.rossA idem Copier, e"cept that the original files !ill be remo#ed (shortened b% CT(+H)).
PasteA carr% out indeed the cop% or the displacement of the files (shortened b% CT(+OE).
Remo&eA erase the filesFselected directories.
RenameA gi#e a ne! name to a file
0ou&eau file20e- director/A respecti#el% allo! to create a file or a director% in the current
director%.
"#ecute a command A gi#e the possibilit% of e"ecuting a command in the current director%, the
current selection is proposed on the command line, it is necessar% to choose one of the shells
a#ailable on the ser#er.
TerminalA open a terminal on the current ser#er.
. :ie- menu
ne can choose to displa% or not the files kno!n as hidden (starting !ith Z$ [) b% notching the bo"
en#isaged.
bsf displa%s the directories then the files, one alphabeticall% can Trier or according to the date in the
normal order or re#erse b% modif%ing the menu options.
The preferences of displa% are preser#ed if one selects "nregistrer t)e preferences.
Code_Aster
Version
default
$ .onfiguration
the first time that the user launches the application interface, it has a default configuration !hich !as
defined at the time of the instalment. The configuration is then stored in the director%
A06@*/$astkrc.
Bf the user !ants to return to the configuration of origin, it must erase this director% and start again
astk.
0otice n>1
A eac& ti0e one defines a co00and to #e carried o't 9fina$E editor?:E it is ad-ised to
s&o1 t&e a#so$'te 1a4 9since t&e root: to "re-ent t&at t&e co00and is not fo'nd if t&e
-aria#$e $PATH is incorrect,
0otice n>2
5orsH'e astk eAec'tes a co00and 1&ic& tries to dis"$a4 1indo1s: if t&e co00and is
eAec'ted $oca$$4E not "ro#$e0, If it is carried o't on a distant 0ac&ineE it is it #4 'sing HS
- X E t&erefore t&e dis"$a4 0'st occ'r 1e$$ if ser-er I* a't&oriJes it,
The as_run part contains tools simplif%ing certain tasks of the de#elopers like the look up of the source
code or upgraded of a local #ersion of de#elopment.
The file A06@*/$astkrc/prefs thus contains t!o necessar% information to contact the ser#er of
referenceA the full name of this ser#er and the logHon of the user. This last must be defined in this file
to a#oid follo!ing alarmA
B4C_494)@ remote connection ma= fail<
de-el_ser-er_user not defined in /home/%%%%%%/$astkrc/prefs
Code_Aster
Version
default
$.1 %er&ers
ne reaches the !indo! of configuration b% small Config'ration/*er-ers (see $igure 1.,.1H1).
The first button makes it possible to pass from a ser#er to another and to add a >ou#eau ser#er.
The fields areA
$ull name or B. addressA it is the hostname on the net!orkL one can indicate his full name !ith
domain name (for e"ampleA linu".labo.uni#.fr) or its B. address (for e"ampleA ,46.;:.140.26).
The bo" indicates that astk should not use rsh or =5 to contact this machine.
5tate of the ser#erA one can put on off a temporaril% inaccessible ser#er.
+ogHonA identif%ing !ith !hich one connects oneself to the ser#er.
=ome director%A default director% !hen one na#igate on this machine.
'irector% of the ser#icesA director% !here are installed the ser#ices on this ser#er (to sho! the
!a% of instalment, for e"ampleA /opt/aster), lea#e empt% for a file ser#er.
3ode of do!nloading of the configurationA no (for a file ser#er), manual (it is necessar% to click on
the button T/l/charger maintaining to reco#er the Aster configuration of the ser#er), automatic
(astk 7uestions the ser#er !ith the boot e#er% 2- da%s).
+ast do!nloadingA date from the last upgrade of the setup informations.
TerminalA order to open a terminal on the ser#er. This makes it possible to open a command
!indo! on the ser#er !hen the bsf is used.
&ditorA editor te"t (for e"ample, nedit). The setup process chooses an editor among (and in this
order)A nedit, &edit, %emacs, emacs, %edit, DI.
The follo!ing #alues are turned o#er b% as_run --information (nothing for a file ser#er) and thus
depend on the configuration of the as_run partA
T%pe of platform.
Eersions a#ailable.
Accessible machinesA list accessible nodes of computation since this ser#er.
9atchFinteracti#eA specif% if the ser#er accepts launching in batch, interacti#e and pro#ides the
limits in memor%, time C.<, man% builtHin processors on the ser#er.
T&e s'""orted 0anage0ent soft1are of #atc& is 5*8E *'n 6rid >ngine and PK*,
$.2 .onfigurations
$.2.1 Prfrences 3nrales
ne reaches the !indo! of configuration of the general preferences b% small Config'ration/
Preferences/genera$ (see $igure 1.,.1H2).
This !indo! makes it possible to inform the pri#ate information of the user, to choose the language
used b% the application interface.
$or those !hich ha#e access to the machine of reference, authorit% A*+A is displa%ed (&'A for
de#eloper, <T+ for userD). $or the de#elopers, the organization and the name of the agent are
automaticall% filled. The users must do it themsel#es.
Then, one finds the #ersion !hich !ill be selected b% default, the commands to reach a terminal and
to an editor (as for the ser#ers).
*an/ profiles in small Fic)ier make it possible to preser#e the name of the > the last open profiles
so as to point out them 7uickl%.
9e&el of message indicates the le#el of details of the messages !ritten in the !indo! of the
messages of small Aide. >i#eau]-A onl% the messages BI#56C and B*))*U)C are !rittenL the higher
le#els make it possible to debug the beha#ior of the application interface. +e#el , is ad#ised, it makes
it possible to see the error messages being able to appear at the time of the problems of
communication !ith the remote ser#ers.
$or the follo!Hup of the @obs, one can choose the number of displa%ed lines !hen one #isualizes the
file output in the course of @ob ((echercher button), and the fre7uenc% of updating of the list.

Code_Aster
Version
default
$.2.2 Prfrences Rseau

ne reaches the !indo! of configuration of the preferences concerning the net!ork b% small
Config'ration/ Preferences/7et1ork (see $igure 1.,.1H0).
This !indo! makes it possible to inform net!ork settings. ne must then specif% domain name
net!ork of the machine. $or e"ample, domain$or& if the full name of the machine is
mach00$domain$or&. Bf domain name is left empt%, an alarm message is displa%ed !ith the boot
because the !ell informed names of unnamed machine of field !ill not be supplemented. That can
pose problems, but it is also sometimes necessar% to lea#e domain name to #acuum in certain
configurations.
Bf mode '=C.FE.> is acti#e, it is in this field that one can indicate the local B. address of the
machine. Ihile clicking on ok, the application interface proposes the B. address of the application
interfaces net!orks detected on the machine.
$. Tools
5ee $igure 1.,.2H,.
ne selects the tools to be configured !ith the dropHdo!n list, or ne! tools is added.
5tandard tools are predefined (the tin% onesFuppercases are taken into account in the names of tools).
T&e too$s are necessari$4 eAec'ted on t&e 0ac&ine C5oca$D (!here the application interface is
launched).
Bn general, the tools are launched either on a file of a mitre (&T<'&, T&5T5 or 5<(C=A(*&), or on
a file !hen one tra#erses the filing s%stem !ith the bsf.
ne defines simpl% the command line necessar% to the launching of tools (ad#ised absolute path), one
can place the code" T$, T(, Tf, T' in the command line (see JM 1.,.2N) to correctl% pass a file to
the tools. ne can put this code" bet!een brackets to be able to launch the tools alone, !ithout file in
argument.
$ile t%pes can be associated !ith the tools. The t%pe taken into account to launch the tools is the
e"tension !hen one tra#erses the files !ith the bsf, the t%pe of the dropHdo!n list !hen it is about a
mitre.
ne can choose if the tools are usable on a remote file. Bn this case, astk is loaded to bring back the
file in 7uestion on the local machine in a temporar% director%, of launching the tools, then to redeposit
the file on the remote ser#er (e#en if it !ere not modified b% the tools).
Code_Aster
Version
default
' 8o- to make a stud/?
Bn this paragraph, one describes stage b% stage ho! to use astk to make a stud%.
The stud% consists !ith compute the response of tension of a plate perforated of adapting the mesh.
ne has the follo!ing elementsA
The command file Aster A demo001a$comm
the description of the geometr% carried out !ith *mshA demo001$dat&
the coarse mesh of the plate builds b% *mshA demo001a$msh
fine mesh of the contour of the plateA demo001a$1E
ne produces the follo!ing resultsA
A Aster 0es& fi$e A demo001a$mail
a file result !ith the format *msh (fields of displacements, errorD)A demo001a$pos
cur#ed <ne !ith format png (produced b% "mgrace)A demo001a$pn&
+es con#entional files of message and Aster resultA demo001a$mess and demo001a$resu
'ans the e"ample, one places all the files in the director% /home/tutorial.
The files of this e"ample are a#ailable in the director% astest of %our #ersion of Code_Aster, for
e"ample in /opt/aster/78410$1/astest.
0ote:
In t&e case of a st'd4 1it& se-era$ co00and fi$esE a$$ t&e fi$es 0'st #e of t4"e CC(%DE
associated 1it& t&e $ogica$ 'nit 1 and it is t&e order of a""earance in t&e "rofi$e 1&ic&
deter0ines t&e order of eAec'tion,
'.1 .reation of t)e profile
ne launches the application interface !hich opens on a #irgin profile, or if astk is alread% launched,
one chooses 8ic&ier/7e1 in the menu to create a ne! empt% profile.
ne places oneself in mitre &T<'&.
'.2 %election of t)e (finition
'.2.1 files of a basic pat)
'ans mitre &T<'&, one chooses a basic path to simplif% the access to the files.
ne clicks on the icon , one chooses the director% /home/tutorial.
'.2.2 5ddition of e#isting files
ne adds the command file !hile clicking on , the file selection opens directl% in the basic path
!hich one has @ust defined. Bt onl% remains to select the file demo001a$comm (doubleHclick or single
click O ok), and the file appears in the list. +et us note that astk identifies the t%pe of this file starting
from its e"tension C3, the logical number of unit is positioned to ,, bo" ' (gi#en) is notched.
ne makes in the same !a% for the mesh file !ith the format *msh (demo001a$msh). astk
recognizes the e"tension msh, the logical number of unit is positioned !ith ,;, bo" ' is notched.
Bn the same !a% for the mesh of contour demo001a$1E, astk identifies the t%pe libr and positions the
logical number of unit to ,:. 9o" ' should be notched because it is about a data file.
Code_Aster
Version
default
ne can also add the file demo001a$dat&. ne strips bo" ', it !ill not be used in the stud% but one
can #isualize this mesh b% opening it !ith *msh (see M4.44.4).

'.2. 5ddition of files@
&"cept if an e"ecution alread% took place, the files results do not e"ist %et, one cannot thus add them
b% tra#ersing the tree structure.
'.2..1 @ -)ile inserting a blank line
the mesh into the *msh format !ill be read again and con#erted in the command file Aster b%
command 1)*_G@70 into mesh !ith the Aster for0at. ne can reco#er this mesh b% adding a file of
t%pe eHmail on the logical unit 1-.
ne clicks on , a line is added in the list. ne chooses standard the eHmail in the list (!hat causes
to position the logical number of unit to 1-). The name is indicated
/home/tutorial/demo001a$mail or demo001a$mail or $/demo001a$mail (since one can
indicate the filename into relati#e compared to the basic path). The file is produced b% the e"ecution,
one thus notches bo" ( (result) and one strips '.
0otice
co00and PRE_GMSH 'ses #4 defa'$t n'0#ers 1/ and 20 1it& t&e in"'ts/o't"'tsE if one
0odifies t&e co00and fi$e to read again or 1rite t&e 0es& fi$es on ot&er 'nitsE it is
necessar4 to #e co&erent 1it& t&e n'0#ers indicated in astk,
'.2..2 @ -it) A:aleur b/ defaultB
ne could continue thus to add the other files, but one !ill use the function Ealeur b% default for the
follo!ing files. This function uses the name of the profile astk to build the #alues b% default (see J;
2,2,1</ConteAt 0en'), one thus !ill record the profile.
ne chooses >nregistrer 'nder? in the $ile menu , one goes !ith the bro!ser in the director%
/home/tutorial, and in the 5/lection $ine, one t%pes demo001a (the e"tension $astk is
automaticall% added).
+et us note that the !indo! title main of astk gi#es the name of the current profile. The title is no!A
478. -ersion 1$E$0 - demo001a$astk - /home/tutorial
ne inserts a blank line !hile clicking on , one chooses the file t%pe pos, then one clicks !ith the
right button in the bo" of the file name and one chooses Ealeur b% defaultA astk builds a file name
starting from the basic path (see JM4.1.,4.1.,N), name of profile (b% !ithdra!ing the e"tension) and of
the t%pe pos, that is to sa% /home/tutorial/demo001a$pos. ne sees as follo!sA
$/demo001a$pos (name relating to the basic path).
9o" ( !as notched, and the logical number of unit fi"ed at 28. Bn the command file, one indicatedA
I@1)_)*7U 'U#I8*FG1HI(
one thus modifies the logical number of unit conse7uentl%, it is enough to click on the old #alue, to
erase it and t%pe 4,. nl% t!o digits are displa%ed in this bo", to a#oid the errors, astk checks that the
numbers of logical unit lie bet!een , and ;;.
ne proceeds in the same manner to add demo001a$pn&A select the t%pe libr, modif% the logical
unit into 42 and the filename.
Bn the same !a%, one adds a file of t%pe mess and one of t%pe resu in this manner (lea#e the
numbers of logical unit b% default).
Code_Aster
Version
default

'.2.$ %upprimer a Pour
file to remo#e a line of the list of files, it is enough to select it !hile clicking in the area !here the
filename is indicated and to click on the icon .
0ote:
(n$4 t&e reference to t&is fi$e in t&e "rofi$e astk is forgottenE t&e fi$e itse$f is not 'no#tr'si-eL
'. 9aunc)ing of computation
+es files gi#en and results are selected, one ad@usts the parameters of computation (see JM 1.2N), and
one clicks on the button +ancer.
ne takes care to notch the bo" !hich is @ust beside &T<'& to announce that one !ishes to use the
contents of this mitreD if not ans!ers us (ien interfaces it launchingY.
Bf the profile !ere not recorded %et, the application interface re7uires to choose a place and a name
for this profile (see JM 4.1.2.1N).
astk calls as_run to e"ecute computation, and transmits to 5ui#i of the @obs (as@ob) the number of the
@ob (number of the process in interacti#e) and other information !hich !ill make it possible to follo!
the ad#ance of computation. The initial state of computation is 1*#/ (7ueued), !hen computation
starts, it becomes )U#, then *#/*/ !hen he is finished (other states are possible in batch). The button
Actualiser calls the ser#ice !hich refreshes the state of computations in progress.
Ihen computation is finished, one can consult the output of the @ob !hile doubleHclicking on the @ob,
or b% >diter/8i$e o't"'t.
5ppear '.2..2+1: ,indo- of t)e profile of stud/
Code_Aster
Version
default

'.$ =obs of t)e results
ne can consult the files results simpl% !hile doubleHclicking on their name, !hich opens a te"t editor
for the files mess and resuL on the results file !ith the *msh format, pos, that cause to open this
file in *msh directl%. ne thus #isualizes the deformed shape and the iso#aleurs (pro#ided *msh
!ere installed, and that pos is in the file t%pes associated !ith *msh, see J; 4,3<).
>9A
The director% ha#ing to accommodate a file result does not e"ist, there is automaticall% created if the
permissions are sufficient.
Bf the cop% of files results fails (problem of permissions, 7uota, remote connectionD), the% are copied in a
temporar% director% from the ob@ect computer. An alarm B4C_,61:_)*7U987 sho!s the !a% !here it is
necessar% to go to seek the results.
'.' 6se of t)e tools
ne can also use astk and the fact that one can freel% define tools in it to gather in a profile all the
files necessar% to a stud% e#en if those are not directl% used b% Code_Aster.
Bn this e"ample, demo001a$dat& is a file that Code_Aster cannot read againL it contains the
description of the geometr%, *msh uses it to create the mesh ($msh).
ne can ne#ertheless insert it in the profile (button ), to affect an unspecified t%pe to him (libr for
e"ample) since it !ill not be used during the e"ecution (bo"es ', ( not notched).
ne can open the geometr% directl% b% making ('-rir 1it&?/60s& (rightHclick on the filename),
modif% the geometr% or the parameters of the mesh, reHmesh and record the mesh.
ne can then start again computation on the ne! file demo001a$msh.
b#iousl%, this is not restricted in *mshL one can use different tools (mesh generators, tools of post H
processing, graph plotterD) directl% since astk and reach thus all the files of a stud% since a profile
!ith the ade7uate tools.

Figure '.+1: ,indo- of follo-+up of t)e .onsultation
Code_Aster
Version
default
'.C 5d&anced features

'.C.1 e#ectool
ne chooses in astk the #ersion of Code_Aster, the mode to debug or nodebug, a possible o#erload
and this !ill result in using such or such e"ecutable of Code_Aster.
ne can be e#en further specif%ing the manner e"act to launch this e"ecutableA it is the role of the
option of launching e#ectool (finel% ptions).

Bn ordinar% time, Code_Aster is launched !ith a ordering of the t%peA
$/aster$e%e ar&ument1 ar&ument2I
<tiliser the option e"ectool comes do!n to launchingA
cmde_e%ec $/aster$e%e ar&ument1 ar&ument2I
'ans small ptions, one can directl% specif% cmde_e%ec or a name of tools defined in the setup file
of as_runA [478*)_)668]/etc/codeaster/asrun
"#emple 1:
Bn small ptions, one seizes in the bo" e"ectoolA time
the ordering of launching !ill be thus time aster$e%e ar&umentsI
The command time accepts e"actl% this kind of argument (e"ecutable and its arguments), one !ill
thus ha#e the e"ecution time of computation. That does not ha#e great interest, Code_Aster gi#es
alread% this kind of information.
"#ample 2:
Bn setup file [478*)_)668]/etc/codeaster/asrun, one defines (on onl% one line)A
memcheck< -al&rind --toolFmemcheck --error-limitFno --leak-checkFfull
--suppressionsF/opt/aster/-al&rind-p=thon$supp
Bt is then enough to indicate in small ptions, e"ectoolA memcheck
memcheck is defined on the left in the setup file (A ), therefore it is the complete command
-al&rindI !hich !ill be used during launching.
ne can define tools as man% as one !ishes on condition that not entering in conflict !ith the other
parameters preset this file. $or this reason, the definition of the e"ectools !ould ha#e ad#anced in
the future.
Code_Aster
Version
default
C 8o- to carr/ out an o&erload?
ne considers in this paragraph that the user is familiar !ith handling of the lists of files in mitre
&T<'&.
An o#erload consists to add or modif% part of the sources of Code_Aster and to use it to make a stud%.
The ob@ecti#e of an o#erload is to produce e"ecutable, a compiled catalogue of commands andFor a
catalogue of elements. ne can also o#erload moduli p%thonL , in this case, the source files are
recopied in the director% of e"ecution (there is no receptacle ob@ect of the o#erloaded files p%thon).
ne places oneself in mitre 5<(C=A(*&.

C.1 o&erload of t)e sources
ne proceeds like adding files for a &T<'&. ne can select either a file, or a director%. Bt is often
clearer and more practical to place its source files in directories.
Bf one adds a director% in the list of the sources (left higher mitre 5<(C=A(*&) of t%pe $ (files
$(T(A>), all the files !hose e"tension is $f !ill be compiled and used to make ne! e"ecutable.
C.2 To define t)e results of t)e o&erload
+es files C (standard C), $(T(A> (standard $) and fortran;- (standard f;-) allo! to build
e"ecutableA t%pe e"ec.
The catalogues of commands cap% make it possible to build a catalogue of commands compiledA
t%pe cmde (director% containing the files cata$p= and cata$p=c).
The catalogues of elements, options and 7uantities cata are used to produce a catalogue of
compiled elementsA it.
Figure C+1: ,indo- of 5=out
Code_Aster
Version
default

C. Taken into account of t)e Pour 4ue
o#erload the data !ell informed in mitre 5<(C=A(*& are taken into account, it is necessar% to notch
the bo" located @ust on the right of button 5<(C=A(*& (mitre 5<(C=A(*& is al!a%s notched in this
paragraph).
ne needs a receptacle in result absolutel% corresponding to the data sources (' notched).
If t&ere are directories CCD and/or C8/f/0D in CDD onn+eE one needs a CeAecD in C!D +s'$tatB in t&e
sa0e 1a4 for Cca"4D 1it& Cc0deD and CcataD 1it& CitD,
astk aid nor0a$$4 in t&is task 1&i$e notc&ing/a'to0atica$$4 stri""ing t&e so'rces necessar4 to t&e
creation of eAec'ta#$e or cata$og'es 1&en one notc&es/stri" #oA C!D +s'$tat of t&ose, (t&er side
of t&e coinE one 0'st stri" certain $ines 1&en one G'gg$es 1it& se-era$ directories of so'rces 1&ic&
s&o'$d not #e co0"i$ed toget&er?
ne can prepare the o#erload independentl% of the stud% (ad#ised) or make the o#erload and launch
the stud% in the tread.
To prepare the o#erloadA
strip mitre &T<'&
to put the corresponding receptacles in ( /sultat onl%
to put the sources in ' onn/e (astk did it automaticall%)
+ancer.
The o#erload builds the results (e"ecutable, cataloguesD) starting from the data (sources).
+aunching of the stud% b% using this o#erloadA
notch mitre &T<'&
to put the r/ceptables in ' onn/e onl%
to strip indicator ' for the sources (made automaticall% b% astk)
+ancer.
The products of the first stage are then used as data to launch the stud%.
.aution: 'o not strip 5<(C=A(*&, if not the stud% !ill be launched !ith the not o#erloaded
standard #ersion.
D 8o- to launc) a list of tests?
Bt is necessar% to approach this point after the t!o precedents. Bndeed, thro! a list of tests does not
ha#e interest that to #alidate an o#erload either !ith respect to non regression original functionalities
of the code, or on a set of cases testing a ne! functionalit%.
To use this possibilit%, it is necessar% to notch the bo" located @ust on the right of button T&5T5 (!hat
strips &T<'& automaticall%). Bn most case, one uses an o#erloaded #ersion, therefore in this case
mitre 5<(C=A(*& is also notched.
The tests are launched in parallel according to the a#ailable resources (see M;.,;.,).
0otice n>1
It is a#so$'te$4 necessar4 to "re"are t&e o-er$oad initia$$4E t&en to $a'nc& t&e tests
1it& t&e res'$ts of t&is o-er$oad,
0otice n>2
*'r t&e ser-er of referenceE t&e $a'nc&ing of a $ist of tests 0'st #e on$4 0ade in
#atc&,

The data are #er% simpleA
listA a file gi#ing the list of the tests to launching (compulsor%).
Code_Aster
Version
default
rep_testA a director% containing the files necessar% to the launching of the tests (optional). The%
is the data of the benchmarks !hose names must correspond to those of the list. This director%
al!a%s comes in o#erload from the director% astest from the #ersion used.
resu_testA the director% !here the results of the tests !ill be !ritten. The cop% of the results is
made according to the optional parameters defined in small ptions (see M1.,.01.,.0).
The traces of e"ecution of each test are preser#ed in the subHdirector% flash of resu_test or in the
director% indicated if necessar% b% an input of t%pe flash in this mitre.

E .omment t)ro- a parametric stud/
ne understands b% parametric stud% a standard stud% (defined in mitre &T<'&) in !hich one !ishes
to #ar% one or more parameters.
The stud% is as general as an% stud% defined in astkA one can thus call upon an o#erload if need be.
Attention in this case, !ith producing this o#erload before launching !ell parametric stud% and it to
put (e"ecutable, catalogues, p%thon sources) on the ob@ect computer not to transfer the files since a
remote machine for each computation.
0otice
t&e st'd4 0'st #e -a$id #efore #eing dec$ined on t&e set of "ara0eters, It 0'st t&'s t'rn
1it&o't error, It is a$so i0"ortant to o"ti0iJe t&e st'd4 #efore dec$ining it on a $arge
n'0#er of -a$'es of t&e "ara0eters,
The definition and the launching of a parametric stud% are described in J<1.-:.-8N.
Figure D+1: Transition of a list of benc)mark
Code_Aster
Version
default
+aunching is strictl% identical to the launching of the nominal stud% onl%. nl% the option distribution
must be setting !ith /es in small ptions.
Computations are launched in parallelA see M;.,;., concerning the specific options.
F 9aunc)ing of computations in (istribution
F.1 parallel of computations
the management of distributed computations is acti#ated during launching of a parametric stud% or
benchmark. Bndeed, in both cases, each computation is independent of the different one. ne can
thus sub@ect them in parallel to reduce the time of return.
F.1.1 6se of t)e a&ailable resources
ne can insert in the profile (mitre &T<'& or T&5T5), a file of the t%pe hostfile. ne defines the list
of the machines a#ailable in it and for each one the number of processors and the 7uantit% of memor%
(out of 3o) usable.
&"ampleA
[compute01]
cpuF
memFE1>2
[compute02]
cpuF1
memF102
Cela means that up to 0 computations could be sub@ected on compute01 (insofar as the% do not ask
more than :,;1 3o them 0) and , computation on compute02 using less than ,-10 3o.
Bn batch, one can sub@ect much more computations than of processors a#ailable and lea#e the dri#er
batch distribute computations on a cluster for e"ample. Bn this case, one can fi" cpuFG0 to lea#e to
the ma"imum 4- computations in the dri#er of batch.
Bf there is no file hostfile in the profile, one takes that !hose name is fi"ed in setup file
[478*)_)668]/etc/codeaster/asrun under the label interactif_distrib_hostfile or
batch_distrib_hostfile according to the mode of launching.
Bf no file hostfile is specified, the number of processors (cores in fact) and the total memor% are
automaticall% gi#en.
Remarks
(ne can easi$4 co$$a"se a 0ac&ine 1&i$e $a'nc&ing too 0an4 co0"'tations 1it& res"ect
to t&e a-ai$a#$e reso'rces, It is ad-ised to get infor0ation a#o't t&e 'se "otentia$ of 0idM
siJeds of s&ared co0"'tations 9c$ass #atc& dedicated for eAa0"$e:,
Para$$e$ co0"'tations co'nt 1e$$ for t&e n'0#er of "rocessors 1&ic& t&e4 'se and not
for 1,
Kefore t&e $a'nc&ing of co0"'tationsE connection 1it& t&e nodes of co0"'tation is
tested, T&e $ist 1i$$ #e restricted 1it& t&e 0ac&ines &a-ing #een contacted s'ccessf'$$4,
F.1.2 9ead time of e#pir/
+ors7ue the number of computations to launching is much higher than the number of processors
o#erall a#ailable (and it is often the case), of computations are 7ueued of submission.
Bf a computation re7uires more memor% than no machine can offer some, there !ould remain
indefinitel% 7ueued.
To a#oid that, a lead time of e"pir% (timeHout) is definite e7ual at the time of main computation, i.e. the
time chosen in astk during the total submission.
Code_Aster
Version
default
Bf no computation !ere sub@ected during this lead time, computation is re@ected.

F.2 5cti&ation of t)e parallelism of Code_Aster
internal parallelism !ith Code_Aster is present in t!o formsA
pen3. parallelism functions in shared memor% and is a#ailable onl% in sol#er @U98_5)6#8. Bt
is necessar% of course that the #ersion of Code_Aster !as compiled !ith the ade7uate options.
.arallelism 3.B (b% sending of message, 3essage .assing Bnterface) is a#ailable in sol#er @U@17
and elementar% computations. Compilation is much more intricate and is not automatic at the
time of the installation of Code_Aster (it is necessar% to choose an implementation 3.B, to
compile them preHnecessar% and in particular @U@17 in 3.B, then Code_Aster).
ne chooses the number of processors used in pen3. and the number of processors used in 3.B
(distributed on a certain number of nodes of computations) in small ptions (see M1.,.01.,.0).
F. *ultiple e#ecutions
Bt is about a mode of 7uite particular launching bound for the de#elopers.
The ob@ecti#e is simultaneousl% to e"ecute a profile (a stud% or a list of benchmark) on se#eral
machines.
ne acti#ates it !hile notching multiple F =es in small 6ptions. Then, at the ob@ect time a
!indo! opens in order to select (!hile notching) the machines on !hich the stud% or the tests !ill be
launched.
The results, including the output files o't"'t and error usuall% copied in the director% flashor, are
copied in the director% A06@*/@U98I (A06@* being in general e7ual to /home/username). ne can
choose to lea#e the results on each machine, !hich is ad#ised if the files are o#erall bulk%, or to
repatriate all the files on the local machine.
b#iousl%, there are some precautions to take so that functionsA the selected #ersion must be
a#ailable on all the machines, the parameters of computation compatible !ith the resources of each
machine, etc
Code_Aster
Version
default
1G 6tilisation of as;run
+ors7ue one uses the application interface astk for launching computations, the aforementioned as a
customer calls upon proposed ser#ices b% a ser#er !ho can be on the same machine or a remote
machine (if the ser#er is remote, there are file s!apping and a shell command through the net!ork
(protocol rsh or =5) that !e do not detail here).
The functionalities of as_run can be classified in se#eral categoriesA
for t)e user A functionalities !hich can be used b% t)e users, such as for e"ample launching
Code_Aster to the hand,
for t)e de&eloper A functionalities used b% the de#elopers to #isualize a file, to cop% a file, to
build a list of tests, to check the catalogue of messagesD
to maintain a de&elopment modelA built a #ersion, upgrade itD
reser&ed to t)e customers A functionalities !ithout direct interest out of astk (or another
customer),
for t)e tasks of administrationA restrain to!ards the tools of follo!Hup of the faults, the data
base of studiesD
The #arious functionalities of as_run are gi#en !hile t%pingA as_run --help.
Bn the setup files of as_run and the files .e"port, one can use en#ironment #ariables (478*)_)668,
478*)_*8, and 06@*).
$or e"ample, in etc/codeaster/asrun A
mpirun_cmd< A478*)_)668/public/mpi/bin/mpirunI
or in a file $e%port A
) repe A06@*/results_repe ) 0
1G.1 Pour t)e user
H +ance e"ecution described b% the profile (action b% defect)A
as_run --run [options] user?mach< /nom_profil$e%port
the file e"port can be in room or on a remote machine.
&ach line of the file starts !ithA
.A definition of a parameter,
aA definition of an argument of the line of commands of Code_AsterE
$A definition of a file,
(A definition of a director%,
>A used onl% for the !orkshop of soft!are engineering (A*+A).
The format for the parameters and arguments isA 1 nom_parametre -alue or 4 nom_ar&ument
-alue.
$or the files and directories, the format isA
5/) standard unite_lo&ic path /),
!here /), specifies if the file or director% is in /onnJe, )Jsultat (both are possible group), and if
the contents are ,ompressJ.
H A computation starting from the files in arguments &"ecutes 7uickl%A
as_run --Kuick [options] file1 [file2 [$$$]]
+es de#elopers can indicate an o#erload of sources $(T(A> (resp. p%thon) !ith the options
--surch_fort (resp. --surch_p=t).
H .roduct a named d%namic librar% 5I9* b% compiling the source files src1D src#. <sed t%picall% to
build a librar% <3AT. A
Code_Aster
Version
default
as_run --make_shared --outputF5I9* [src1 [$$$]] src#
Bt is the compiler and the options of compilations defined in the config.t"t file, of the #ersion b%
default or chosen !ith the option --to3ards, !hich is used to build the librar%. 5I9* is the name of
the produced librar% !hich !ill be indicated in the ke% !ords of Code_Aster.
1G.2 For t)e de&eloper
H .oster a source fileA $(T(A>, C, p%thon, cap%, cata, histor or testA
as_run --sho3 [options] obj1 [obj2I]
H Cop% a source file in the current director%A
as_run --&et [options] obj1 [obj2I]
H .oster the diff of a source fileA $(T(A>, C, p%thon, cap%, cata, histor or testA
as_run --diff [options] obj1 [obj2I]
H .oster the main subroutine of a Code_Aster co00and A
as_run --sho3op [options] command [$cap=]
H (etourne numbers a#ailable for the routines S<, Cp, +CD Turn o#er the first : results e"cept if
--4l is present. A
as_run --free_sub [--4l]
H Construit a file e"port to launch a benchmark and prints it on stdoutA
as_run --&et_e%port testcase_name
H Construit a list of benchmark starting from commandsFke% !ords andFor checking criteria of time
C.< or memor%A
as_run --list [--4l] [--test_listeF5I9*] [--filterFI]
[--commandFI] [--user_filterFI] [test1 [test2$]]
H Construit the diagnosis of the Code_Aster #enc&0arks (since 'B(i or the director% astest b% default)
and !rites a file pickled resultA
as_run --dia& [--astest_dirF/I)1H [/I)2]] [--test_listeF9I78*]
[--onl=_nook] [dia&_result$pick]
H p/ration on the catalogues of messages of Code_Aster. subroutine ] turns o#er the messages
called b% subroutine. message_number ] turns o#er the routines using this message. check ]
checks the catalogues and displa%s some statistics. mo#e ] mo#es a message of a catalogue !ith
another and produces the modified catalogues and source files. A
as_run --messa&es subroutine L messa&e_number
as_run --messa&es check [--fortFI] [--p=thonFI] [--uni&estFI]
as_run --messa&es mo-e old_ms&id ne3_ms&id
H (etourne information on the processors and the memor% of the machines gi#enA
as_run --&et_informations [--outputF5I9*] host1 [host2 [$$$]]
Remar4ues
t&e scri"ting of insta$0ent creates restrains s40#o$ic s4ste0s showE getE showop to1ards
as_r'n in [ASTER_ROOT]/!"E 1&ic& 0akes it "ossi#$e to t4"e on$4 show instead of
#s_r$" - show,
N'st as #st% can #e ca$$ed '"on #4 &o'e#ster-G()E #s_r$" can #e ca$$ed #4
&o'e#ster,
1G. To maintain an instalment local
Code_Aster
Version
default
H (etourne the number of the de#elopment modelA
as_run --&et-ersion [options]
H (etourne the path of instalment of the de#elopment modelA
as_run --&et-ersion_path [options]
H Construit a #ersion of Code_Aster (e"ecutable, libraries, catalogues). Z target Z can be Al or cleanA
as_run --make [---ersFD*)7] [tar&et]
as_run --make [---ersFD*)7] clean
&"empleA as_run --make clean bibc/hdf remo#es the files ob@ects associated !ith the
source files !ith the director% bibc/hdf.
H Carries out one or more upgraded of a de#elopment model (to prefer --auto_update !hich is
loaded to do!nload all the upgraded ones and to appl% them in the good order)A
as_run --update [options] fich1$tar$&2 [fich2$tar$&2I]
H 'o!nloads the upgraded a#ailable ones since a ser#er and the bracket to a de#elopment modelA
as_run --auto_update [---ersFI] [--force_up&rade]
[--keep_increment] [--report_toFI]
The option keep_increment announces that all the intermediate #ersions are preser#ed
(e"ecutable, catalogues, moduli p%thon).
The option force_up&rade makes it possible to pass for e"ample from #ersion ,-.-.2- to
#ersion ,-.,., (!hat is licit because the ,-.-.2- !as stabilized under number ,-.,.-).
The option report_to sends an eHmail summarizing the upgraded one (success or failure).
H 'o!nloads the upgraded a#ailable ones since a ser#er and upgrades astkFasrun itselfA
as_run --astk_update [--report_toFI] [-ersion]
-ersion makes it possible to install a particular #ersion of astk (#alue of t%pe ,.:.-).
>9A astk_update is called before each upgraded b% auto_update.
H Construction of the ctagsA
as_run --cta&s [---ersFD*)7]
1G.$ launc)ing Pour application interfaces of computations
H +ance an e"ecution (b% calling as_run in a separate process)A
as_run --ser- user?mach< /nom_profil$e%port
H &n#oie contents of filename (possibl% on a remote machine) to the addresses email,, email1,DA
as_run --sendmail [--report_toF*@4I91H *@4I92] filename
H (etourne information on the configuration of a ser#erA batch, interacti#e (%esFnot, limits), nodes of
computation, #ersionsA
as_run --information
H (etourne the state, the diagnosis, the node of computation, time C.< and the !ork director% of a
computationA
as_run --topicalit= job_number job_name mode
H u#re the file output or error on the pro#ided screenA
as_run --edict job_number job_name output modeLerror /I7194:
H Affiche end of the file fort.6 or lines corresponding to the filterA
as_run --tail job_number job_name mode fdest nb_lines [re&e%p]
Code_Aster
Version
default
H Arr^te a computation and destro%ed the associated filesA
as_run --9*/ job_number job_name mode [node] [--si&nalFI]

H (emo#es the files of computations !hich are not in the listA
as_run --pur&e_flash job_number1 [job_number2 [$$$]]]
H Con#ertit a file (possibl% remote) !ith format =T3+ and !rites the result in $B+&A
in #eta re$ease
as_run --con-ert_to_html [user?machine<] file --outputF5I9*
1G.' Pour tasks of administration
H Bns?re a ne! input in the s%stem of follo!Hup of faults and cop% attached files if a file e"port is
pro#idedA
as_run --create_issue issue_file [e%port_file]
H (emplit fields corr#de# or corr#e"pl (according to !orms) in the files found in Z histor Z and
possibl% the farmA
as_run --close_issue ---ersFD*)7 histor
H &"trait contents of the files listed in Z input_file Z in Z histor ZA
as_run --e%tract_histor [--statusF7848] [--formatF56)@*]
[--all_ms&] input_file histor
H .r/pare profile to insert an e"ecution in data baseA
as_run --insert_in_db [e%port_file]
1G.C !ptions
---ersion sho3 pro&ramM7 -ersion number and e%it
- 0H --help sho3 this help messa&e and e%it
- -H ---erbose makes the pro&ram more -erbose
--functions as silentl= as possible -
G silentH --debu& poster information to debu&
--stdoutF5I9* makes it possible to redirect the messa&es usuall= 3ritten
on s=s$stdout
--stderrF5I9* makes it possible to redirect the messa&es usuall= 3ritten
on s=s$stderr 'onl= messa&es of asrun(
--lo&_pro&ressF5I9* redirects information of ad-ance to3ards a file
instead of s=s$stderr
--nodebu&_stderr remo-es the printin& of information of debu&&in& on
stderr
- 5H --force force the operations 3hich can use a co-er
'do3nloadin&H compilationI(
--displa=F/I7194: -alue of -ariable /I7194: '#;< certain
functions read this -alue in a file(
--rcdirF/I) uses the director= of resources A06@*/N/I)O '
the defect is $astkrc($ It is necessar= to a-oid sho3in&
the absolute 3a= because it 3ill ha-e passed to the remote
ser-ers$
--remote_shell_protocolF)*@68*_70*99_1)686,69
protocol used for the launchin& of commands
--remote_cop=_protocolF)*@68*_,61:_1)686,69
protocol used for the cop= of files
--cop=_all_results ,op= 4l results in the current director= 'for --Kuick
Code_Aster
Version
default
action(
--pro%= reKuest 3ith a ser-er to launch the specified action 'for
e%ample
H b= callin& as_run --ser- on the ser-er(
--schemaF7,0*@4 makes it possible to modif= the beha-ior of as_run b=
usin& an alternati-e dia&ram
6ptions for the maintenance actions<
--filterF5I98*) filters applied to the parameters of the tests< NB
-alue 3ill nom_paraO 'supported comparisons BH CH F($
---ersFD*)7 Dersion de ,ode_4ster to be used 'for &etH sho3H
sho3op(
--force_up&rade 5orce up&raded to3ards the ne%t -ersion 'for e%ample
of 10$1$%% to3ards 10$2$0(
- 6 5I9*H --outputF5I9*
redirects the result in 5I9* instead of stdout
--surch_p=tF)*1 one or more directories 'separated b= a comma(
containin& the added files p=thon
--confi&urationF5I9* uses another file Nconfi&uration$t%tO 'onl= for
makeH update and auto_update($
--onl=_nook brin&s back onl= the errors 'the time spent in
tests ok is counted(
--surch_fortF)*1 one or more directories 'separated b= a comma(
containin& added files 56)8)4#
- hasH --4l copies of all the files of the benchmark
--destdirF/I) root director= 'fake-root( 3here the files
3ill be copied
--keep_increment a -ersion increment b= increment b= preser-in&
the e%ecutable files intermediar= up&rades
--searchF)*G*+1 preser-es the tests checkin& the re&e%
&i-en 'or a simple character strin&($
--uni&estF5I9* a file uni&est 'for the suppression(
--commandF,6@@4#/* [/@68,9*54,8 [/@68,9* [FD49*U)]]]
preser-es the tests usin& the command and the ke= 3ords
&i-en
--test_listeF5I9* list of the benchmarks
--report_toF*@4I9 addresses mailer 3here send the report of
an e%ecution 'onl= for --auto_update(
--user_filterF5I9* file containin& the classes testlist$5I98)*$ 7ee
[$$$]/share/codeaster/asrun/e%amples/user_filter$p=
like e%ample$
--astest_dirF/I) director= of the benchmarks to be anal=2ed
- 9H --room the files are not sou&ht on the remote ser-er
but on the local machine
--nolocal force the search of the files on the remote ser-er
'opposite of --room(
6ptions for operations one jobs<
--si&nalF7IG#49 sends a si&nal to computation '.I99LU7)1(
--result_to_output )ediri&e the result in 5I9* instead of stdout
6ptions for the application interface 3ith the )*+<
--statusF7848 an error occurs if the files are not in
this state
--all_ms& reco-ers all the messa&es of the files
--formatF56)@* format of the histor &enerated 'te%t or 08@9(
1G.C.1 additional Precise details
Code_Aster
Version
default
Guand one reco#ers a source file !ith &et, sho3 or sho3op, the aforementioned is put in /tmp/
astk_! lo&-on !/hide. Bf for the same file again is asked, the aforementioned is taken
directl% in this director% e"cept if the option --force is acti#atedL the files !hich ha#e more than
one da% are automaticall% remo#ed co#er.
--roomF--nolocal A these options are used !hen the default beha#ior is not appropriate. Bn the
use of sho3/&et, it is preferable to reach the sources buildings, it is thus the defect. Bn this case,
one !ill use --nolocal to reach a #ersion on the ser#er of reference. 'uring the maintenance of
a local instalment, the defect is to do!nload the upgraded ones on a remote ser#er. >e#ertheless,
if one to reco#er the packages locall%, one can use --room to install them.
The main setup file is [478*)_)668]/etc/codeaster/asrun, the user can define certain
#alues in A06@*/$astkrc/prefs (!here A06@* is the default director% of the user), in
particular the username to use on the remote ser#er (de-el_ser-er_user) to a#oid an alarm
!ith each launching of as_run.
Complements on the inner !orking of as_run (clientFser#er mode, diagramsFplugins) or on
certain options are a#ailable in the documentation de#eloper embarked !ith as_run in
[478*)_)668]/share/codeaster/asrun//oc$ /.
11 1uestions Fr4uentes
%Rien does not o&&ur '(en one tries to laun&( a &o)*utation+ to edit a file or to o*en a
ter)inal on a re)ote ser,er- or %Return &ode . /+ 0rofile Co*1 failed in t(e 'indo' of t(e
)essa2es to t(e laun&(in2 of a &o)*utation-
Bt is probable that the local machine cannot communicate correctl% !ith the remote ser#er.
Communications using protocol CC.Frsh, the files $rhosts on the local machine and the remote
ser#ers must be correctl% indicated. Bf protocol 5C. is usedF=5, it is necessar% that the pri#ate and
public ke%s are coherent.
ne can check it b% lea#ing astk, and b% starting again it in this mannerA
astk --debu& 0 - - check (--to debu& 0 is used to limit the printings)
+ire attenti#el% information !hich is printed. astk pro#ides information on the en#ironment #ariable
'B5.+AS (check that it is correctl% defined), and tests connection bet!een the machine !here astk is
launched and ser#ers distant. Bn the e#ent of connection problems !ith a ser#er, astk suggests an
amendment of the file $rhosts of the target machine.
%3(en a &o)*utation in 4at&( is su45e&ted+ t(ere is t(e )essa2e6 T(e nu)4er of t(e 5o4 and
t(e &lass &ould not 4e re&o,ered-
time or the memor% re7uired is probabl% be%ond the limits of the classes of !orks. 5ee in the !indo!
of the messages, there is probabl% a message of the dri#er of batch of the st%le Cannot e"ceed tail[5
hard!are limit (5).
'ecrease time or the memor%, or e"plicitl% choose a class batch !hich agrees in the additional
options.

%3(ile &li&7in2 on Valeur 41 default t(e file na)e re)ains e)*t1-
Cette function uses the name of the profile to determine a #alue b% default, it is necessar% to record
the profile before being able to use this function.

U1 04 00

Caricato da

Informazioni sul documento

Descrizione originale:

Titolo originale

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

U1 04 00

Caricato da

Copyright:

Formati disponibili

Code_Aster

Potrebbero piacerti anche