===== Configuring server to server connection =====

=== Introduction ===

If you have multiples TSM server, each TSM server can be register with all others, to allow server to server communication. That can be used for exporting definition, datas... from one server to the others\\ 
On the first TSM server set all following characteristics: 
  Set servername tsm1
  Set crossdefine on
  Set serverhladdress 10.10.10.9
  Set serverlladdress 1550
  Set serverpassword ?**?

On the next,
  Set servername tsm2
  Set crossdefine on
  Set serverhladdress 10.10.10.10
  Set serverlladdress 1650
  Set serverpassword ?**?
  define server TSM1 serverpassword=?***? Hladdress=10.10.10.9 lladdress=1550 crossdefine=yes

//lladdress is TCPAdminPort if specified, else it's the TCPPort//

=== Steps to follow before using export commands ===

<color red>**Be careful:**</color> if you want to use export commands, you have to use the same TSM user and password on both server to connect using command line, this user must have system authority. A user **admin** is not automatically into the system class on TSM v6.

When you use an export from windows to unix, check the connected user (q session) to be sure that the user has also the rights on the target server. Don't connect directly to a Windows server, use instead command line (dsmadmc).

Example of command to register a new admin on a TSM server:
<cli prompt='>'>
tsm: SERVER1> reg admin admin password passe=0
tsm: SERVER1> grant authority admin  classes=system
tsm: SERVER1>q admin f=d

        Administrator Name: ADMIN
     Last Access Date/Time: 06/27/12   14:33:51
    Days Since Last Access: <1
    Password Set Date/Time: 06/18/12   11:08:34
   Days Since Password Set: 9
     Invalid Sign-on Count: 0
                   Locked?: No
                   Contact:
          System Privilege: Yes
          Policy Privilege: ** Included with system privilege **
         Storage Privilege: ** Included with system privilege **
        Operator Privilege: ** Included with system privilege **
   Client Access Privilege: ** Included with system privilege **
    Client Owner Privilege: ** Included with system privilege **
    Registration Date/Time: 06/18/12   11:08:34
 Registering Administrator: SERVER_CONSOLE
          Managing profile:
Password Expiration Period: 0 Day(s)
             Email Address:
tsm: SERVER1>q status
Storage Management Server for AIX - Version 6, Release 3, Level 1.0

                                  Server Name: SERVER1
               Server host name or IP address:
                    Server TCP/IP port number: 1550
                                  Crossdefine: Off
                          Server Password Set: No
...

</cli>

<cli prompt='>'>
tsm: SERVER1>set servername tsm1
ANR2586W Setting the server name to TSM1 can adversely affect or stop operations that depend on
communcations such as for the following purposes: administration from the Administration Center, client
operations from backup-archive clients, library sharing with the library manager or library clients, or
other server to server operations such as virtual volumes, event logging, or enterprise configuration.
See the administrator's guide for more information about these components and the impact of changing the
server name.

Do you wish to proceed? (Yes (Y)/No (N)) y
ANR2094I Server name set to TSM1.
ANR4865W The server name has been changed. Windows clients that use "passwordaccess generate" may be
unable to authenticate with the server.

tsm: SERVER1>  Set crossdefine on
ANR2135I Crossdefine set to ON.

tsm: SERVER1>  Set serverhladdress tsmaix
ANR2132I Server hladdress set to tsmaix.

tsm: SERVER1>  Set serverpassword server_pass
ANR2131I Server password set.

tsm: SERVER1>q status
Storage Management Server for AIX - Version 6, Release 3, Level 1.0



                                  Server Name: TSM1
               Server host name or IP address: tsmaix
                    Server TCP/IP port number: 1550
                                  Crossdefine: On
                          Server Password Set: Yes
</cli>

If you disconnect and reconnect with dsmadmc, then the prompt is updated with the right servername.

<cli prompt='>'>
tsm: TSM1>q server
ANR2034E QUERY SERVER: No match found using this criteria.
ANS8001I Return code 11.

tsm: TSM1>define server TSM2 serverpassword=server_pass hladdress=tsmaix2 lladdress=1650 crossdefine=yes
ANR1660I Server TSM2 defined successfully.

tsm: TSM1>q server

Server       Comm.      High-level        Low-level       Days     Server       Virtual      Allow
Name         Method     Address           Address        Since     Password     Volume       Replacement
                                                          Last     Set          Password
                                                        Access                  Set
--------     ------     -------------     ---------     ------     --------     --------     -----------
TSM2         TCPIP      tsmaix2            1650              <1     Yes          No           No

</cli>

Test the server to server connection:
On TSM1 take a command on the remote server TSM2: (<remote server>:<command>)
<cli prompt='>'>
tsm: TSM1> TSM2: q act
</cli>

Now you can check on the TSM2, you'll see TSM1 server which is also register. You have create a cross definition, that allow to export data bidirectionally. If you want a single way connection, you can use the parameter crossdefine to off.

=== Export node sample ===

Test of export node from the source TSM1
<cli prompt='>'>
tsm: TSM1>export node WIN2003 FILEData=backup toserver=tsm2 mergefilespaces=yes
ANR0654I Restartable export command with export identifier EXPORT_NODE_34 started as process 34.
ANS8003I Process number 34 started.

tsm: TSM1>q pr

 Process     Process Description      Process Status
  Number
--------     --------------------     -------------------------------------------------
      34     EXPORT NODE              ANR1358I Export Identifier: EXPORT_NODE_34
                                       ANR0648I Have copied the following: 1 Nodes  1
                                       Filespaces  272 Bytes  (0 errors have been
                                       detected).
</cli>

On the target node:
<cli prompt='>'>
tsm: TSM2>q pr

 Process     Process Description      Process Status
  Number
--------     --------------------     -------------------------------------------------
       2     IMPORT (from Server      ANR0648I Have copied the following: (0 errors
              TSM1)                    have been detected).
tsm: TSM2>q node

Node Name                     Platform     Policy Domain      Days Since     Days Since     Locked?
                                           Name               Last Acce-       Password
                                                                      ss            Set
-------------------------     --------     --------------     ----------     ----------     -------
WIN2003                       (?)          STANDARD                   <1             <1       No

tsm: TSM2>q files

Node Name          Filespace      FSID    Platform    Filespace    Is Files-       Capacity      Pct
                   Name                               Type           pace                       Util
                                                                   Unicode?
---------------    -----------    ----    --------    ---------    ---------    -----------    -----
WIN2003            \\windows--       1    (?)         NTFS            Yes         16,370 MB     49.5
                    tsm\c$
</cli>


== Export commands and syntax ==

Import commands must always be used with a physical media, while most export commands can use media and communication server to server.

<color red>EXPort Admin</color>
<code>
                 .-*--------------.
>>-EXPort Admin--+----------------+----------------------------->
                 | .-,----------. |
                 | V            | |
                 '---admin_name-+-'

                                .-PREVIEWImport--=--No------.
>--+-------------------------+--+---------------------------+--->

   '-TOServer--=--servername-'  '-PREVIEWImport--=--+-No--+-'
                                                    '-Yes-'

   .-Replacedefs--=--No------.
>--+-------------------------+---------------------------------->
   '-Replacedefs--=--+-No--+-'
                     '-Yes-'

   .-ENCryptionstrength--=--AES-----.
>--+--------------------------------+--------------------------><
   '-ENCryptionstrength--=--+-AES-+-'
                            '-DES-'
</code>

<color red>EXPort Node</color>  
<code>
                .-*---------.
>>-EXPort Node--+-----------+----------------------------------->
                '-node_name-'

>--+-------------------------------+---------------------------->
   '-FILESpace--=--file_space_name-'

>--+------------------------+----------------------------------->
   '-FSID--=--file_space_ID-'

>--+----------------------------------+------------------------->
   '-UNIFILESpace--=--file_space_name-'

>--+-------------------------+---------------------------------->
   '-DOmains--=--domain_name-'

   .-FILEData--=--None-------------.
>--+-------------------------------+---------------------------->
   '-FILEData--=--+-ALl----------+-'
                  +-None---------+
                  +-ARchive------+
                  +-Backup-------+
                  +-BACKUPActive-+
                  +-ALLActive----+
                  '-SPacemanaged-'

>--+----------------------------------------------+------------->
   |                    .-FROMTime--=--00:00:00-. |
   '-FROMDate--=--date--+-----------------------+-'
                        '-FROMTime--=--time-----'

>--+------------------------------------------+----------------->
   |                  .-TOTime--=--23:59:59-. |
   '-TODate--=--date--+---------------------+-'
                      '-TOTime--=--time-----'

>--+----------------------------------------+------------------->
   '-EXPORTIDentifier--=--export_identifier-'

                                .-PREVIEWImport--=--No------.
>--+-------------------------+--+---------------------------+--->
   '-TOServer--=--servername-'  '-PREVIEWImport--=--+-No--+-'
                                                    '-Yes-'

   .-MERGEfilespaces--=--No------.
>--+-----------------------------+------------------------------>
   '-MERGEfilespaces--=--+-No--+-'
                         '-Yes-'

   .-Replacedefs--=--No------.
>--+-------------------------+---------------------------------->
   '-Replacedefs--=--+-No--+-'
                     '-Yes-'

   .-PROXynodeassoc--=--No------.
>--+----------------------------+------------------------------->
   '-PROXynodeassoc--=--+-No--+-'
                        '-Yes-'

   .-ENCryptionstrength--=--AES-----.
>--+--------------------------------+--------------------------->
   '-ENCryptionstrength--=--+-AES-+-'
                            '-DES-'

   .-ALLOWSHREDdable--=--No------.
>--+-----------------------------+-----------------------------><
   '-ALLOWSHREDdable--=--+-No--+-'
                         '-Yes-'
</code>

<color red>EXPort Policy</color>
<code>
                  .-*---------------.
>>-EXPort Policy--+-----------------+--------------------------->
                  | .-,-----------. |
                  | V             | |
                  '---domain_name-+-'

                                .-PREVIEWImport--=--No------.
>--+-------------------------+--+---------------------------+--->
   '-TOServer--=--servername-'  '-PREVIEWImport--=--+-No--+-'
                                                    '-Yes-'

   .-Replacedefs--=--No------.
>--+-------------------------+---------------------------------><
   '-Replacedefs--=--+-No--+-'
                     '-Yes-'
</code>

<color red>EXPort Server</color>
<code>
                  .-FILEData--=--None-------------.
>>-EXPort Server--+-------------------------------+------------->
                  '-FILEData--=--+-ALl----------+-'
                                 +-None---------+
                                 +-ARchive------+
                                 +-Backup-------+
                                 +-BACKUPActive-+
                                 +-ALLActive----+
                                 '-SPacemanaged-'

>--+----------------------------------------------+------------->
   |                    .-FROMTime--=--00:00:00-. |

   '-FROMDate--=--date--+-----------------------+-'
                        '-FROMTime--=--time-----'

>--+------------------------------------------+----------------->
   |                  .-TOTime--=--23:59:59-. |
   '-TODate--=--date--+---------------------+-'
                      '-TOTime--=--time-----'

>--+----------------------------------------+------------------->
   '-EXPORTIDentifier--=--export_identifier-'

                                .-PREVIEWImport--=--No------.
>--+-------------------------+--+---------------------------+--->
   '-TOServer--=--servername-'  '-PREVIEWImport--=--+-No--+-'
                                                    '-Yes-'

   .-MERGEfilespaces--=--No------.
>--+-----------------------------+------------------------------>
   '-MERGEfilespaces--=--+-No--+-'
                         '-Yes-'

   .-Replacedefs--=--No------.
>--+-------------------------+---------------------------------->
   '-Replacedefs--=--+-No--+-'
                     '-Yes-'

   .-PROXynodeassoc--=--No------.
>--+----------------------------+------------------------------->
   '-PROXynodeassoc--=--+-No--+-'
                        '-Yes-'

   .-ENCryptionstrength--=--AES-----.
>--+--------------------------------+--------------------------->
   '-ENCryptionstrength--=--+-AES-+-'
                            '-DES-'

   .-ALLOWSHREDdable--=--No------.
>--+-----------------------------+-----------------------------><
   '-ALLOWSHREDdable--=--+-No--+-'
                         '-Yes-'
</code>

Have also a look on [[tsm:tsm_replication|REPLicate Node]]