1 #!perl

     2 # Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).

     3 # All rights reserved.

     4 # This component and the accompanying materials are made available

     5 # under the terms of the License "Eclipse Public License v1.0"

     6 # which accompanies this distribution, and is available

     7 # at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 # 

     9 # Initial Contributors:

    10 # Nokia Corporation - initial contribution.

    11 # 

    12 # Contributors:

    13 # 

    14 # Description:

    15 # 

    16 #

    17 

    18 =head1 Overview

    19 

    20 This document is intended to make suggestions about how the tools can be made to operate quicker.

    21 

    22 =head1 Getting releases and baselines

    23 

    24 =over 4

    25 

    26 =item *

    27 

    28 Use the C<required_binaries> directive in your F<reltools.ini> to limit the selection of binaries that are installed.

    29 

    30 =item *

    31 

    32 Don't use the -s switch on C<GetEnv> to install source code. Use C<GetSource> subsequently to fetch source code for the components you want.

    33 

    34 =item *

    35 

    36 If you are working over a slow network link, create a local archive on your own PC using the C<PullEnv> commands. List this local cache first in your F<reltools.ini> and the tools will automatically search that archive first, to find any releases you need. This is also useful if you need to work offline.

    37 

    38 =back

    39 

    40 =head1 Making baselines

    41 

    42 =over 4

    43 

    44 =item *

    45 

    46 If you are making several baselines (for example, one with strong cryptography and one without) or you make a succession of baselines over a period (for example, fortnightly baselines) try to keep releases common to both. For example, if I<viewsrv> has not changed over the course of a fortnight then the new baseline should contain the same component release of viewsrv. Use the C<ValidateEnv> command to check which components you need to release afresh.

    47 

    48 =item *

    49 

    50 Try to make components as small as possible. Then, on average, fewer parts of the system will need to be transferred/installed for each new baseline. Having said that, small components gives no advantage if they are so interlinked that they always need to be released together.

    51 

    52 =back

    53 

    54 =head1 Transferring Releases

    55 

    56 =over 4

    57 

    58 =item *

    59 

    60 Again, use C<required_binaries> to restrict which binary platforms are transferred.

    61 

    62 =item *

    63 

    64 In the export table (F<exportdata.csv>) don't deliver more source code than you have to.

    65 

    66 =item *

    67 

    68 If you are delivering the same thing to several parties, don't do multiple C<ExportEnv>s. Instead use a single F<exportdata.csv> with everyone's PGP key listed along the top. Then do a single C<ExportEnv>; the files will be encrypted to each PGP key.

    69 

    70 =item *

    71 

    72 If you have to deliver something to several FTP sites, use the above method and export to a local drive (or a network share). Then, transfer things to each of the FTP sites. This saves on the encryption time and ensures you deliver the same stuff to each party.

    73 

    74 =item *

    75 

    76 If you have a secure network connection to a third party, then use C<PushEnv> instead of C<ExportEnv>. This eliminates the encryption/decryption stage. But be aware that it does not do source code filtering, so the recipient will be able to see all the source code.

    77 

    78 =back

    79 

    80 =head1 COPYRIGHT

    81 

    82  Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).

    83  All rights reserved.

    84  This component and the accompanying materials are made available

    85  under the terms of the License "Eclipse Public License v1.0"

    86  which accompanies this distribution, and is available

    87  at the URL "http://www.eclipse.org/legal/epl-v10.html".

    88  

    89  Initial Contributors:

    90  Nokia Corporation - initial contribution.

    91  

    92  Contributors:

    93  

    94  Description:

    95  

    96 

    97 =cut