Licensing and starting Migrator

Configuring Migrator  includes the following steps:

1. Start Migrator .
2. Set up  Migrator .
3. Add  AR System server into server account.
4. Add a licensed AR System server  in Migrator .
5. Add or transfer Migrator  license to a  AR System server .
6. Remove a  AR System server  and its Migrator  license from view.

Starting Migrator

After you have installed Migrator , the Windows Start menu displays the Migrator  icon in the program folder that you selected during the installation process.

To start Migrator

1. If you created a shortcut on your desktop during installation, double-click the BMC Remedy Migrator icon. Or, select BMC Remedy Migrator from the Start menu.
2. Obtain a license from BMC Customer Support.
   You need a license for the AR System server  if you do not already have one. For information about contacting BMC Customer Support, see Support information.

Setting up Migrator

After you start  Migrator , open the Login dialog box. If you need to add a server or a license, the Login dialog box appears for the first session. After the first session, if  Migrator  finds the correct user information, the Select Server dialog box appears instead of the Login dialog box.

During the login process, you have two choices to make:

• Do you need to add a server?
  • If you do, you must add the server from the Accounts dialog box. Select Tools > Accounts to open the Accounts dialog box.
  • If the server is not listed, you must add it to the list. See below.
  • If the server is listed, you can continue the login process.
• Is the AR System server  you want to use licensed?
  • If a listed server is not licensed, you must license it. For more information about licensing AR System server , see Setting license options.

  • If a listed server is already licensed, you can select it and log on.

Adding AR System server  into server account

Using the Accounts dialog box, you can add, modify, or delete server and limit access to users from the available servers.

After you log on to  Migrator  and open the Accounts dialog box, either a check mark or an X appears next to each server name.

• A green check mark indicates you can connect to the server.
• A red X indicates you cannot connect to the server, even if the server has been licensed.

The following steps show how to manage your server accounts as an administrator.

To add AR System server  into server account

1. Select Tools > Accounts to open the Account dialog box, which shows the servers that have been added.
   If the Accounts menu selection is unavailable, you must provide login information before proceeding. 

2. In the Account dialog box, perform any of the tasks outlined in the following table: 

   To	Do this
   Add a new server	Click Add, and enter a server name. If the server you are adding is a preference server, enter the appropriate port numbers in the slide-out dialog box that appears at the right.
   Modify an existing server	Select the server, click Modify, and make the appropriate changes.
   Delete a server	Select the server, and click Delete.
   Add or modify the Users list	Click User Manager. Click Add to add a new user, or select a name in the Users list and click Modify to modify the user account. For each user to have their own server list, you must include a specific home directory for that user in the directory path.
   View port columns for firewall support	Select Advanced Server Properties. Select a server and click a column and type a port number or private server number: AR TCP Port represents the port number of the AR System server . AR RPC # represents the program number of the specified AR System server. This number allows you to connect to a private server behind the firewall.

   Warning

   You can set different TCP ports for each server, but if the ARTCPPORT environment variable is defined, Migrator uses the port defined by the variable for all servers while ignoring the settings in the Accounts dialog box.

3. Click OK.
   The new login information is not applied to your current session. You must log on again before your changes take effect, or proceed to one of the following actions:
   • If the server you added needs a license, or does not yet exist in the Server Licenses dialog box, see Licensing overview for licensing information.
   • If the server you added has already been licensed, and has been added to the Server Licenses dialog box, continue to Removing an AR System server and its Remedy Migrator license from view below.

Adding a licensed AR System server  in Migrator

When you have logged into Remedy Migrator, you can add a licensed AR System server . 

One AR System server  license is issued for each AR System server  you want to work with using Migrator . There is no limit to the number of clients on which you can install Migrator .

To add a licensed AR System server  in  Migrator

1.  In  Migrator , select Tools > Licenses to open the Server Licenses dialog box. 
   
2. Click Add.
3. Select a server from the list, and click OK.
   If the server is properly licensed, it is added to the list in the New Licenses section of the Server Licenses dialog box.
4. Click Done.

Adding or transferring Migrator  license to an  AR System server

To view  Migrator   license details for a server, select Tools > Licenses. 

Each AR System server  must have its own  Migrator   license. Information about server licenses is stored in the AR System Licenses form, which can be accessed from Mid Tier . 

If you transfer an AR System server  license from one server to another, you must remove the  Migrator  license from view in the old server, and add it to the new server. 

Removing an  AR System server   and its  Migrator   license from view

Removing a server and its Migrator  license from the servers list makes the server inaccessible to Migrator , but it does not remove the license from the server (or from the local Migrator  license file if the server is version 4.5.2 or older). It only removes the server from the local machine and it can no longer be viewed.

To remove a server from view

1. In Migrator , select Tools > Licenses.
2. In the Server Licenses dialog box, select a server, and click Remove.
3. In the message box, click Yes to confirm the license removal, or No to keep the license in view.

4. After confirming the server removal, indicate whether you want to remove the server from the local cache.

   By doing this, you can remove servers from the Server Licenses list, but still keep some or all of the servers cached.

   If you add a removed server back to the servers list later, the definitions are retrieved the first time you log on to the server.