To automate the data import from Active Directory into Octopus, you must create a Windows scheduled task. To do it:
- Identify a computer from where you will launch the AD import on a daily basis. It is recommended to use a server - or at minimum a PC that is always running.
- Create a scheduled task to run the import application daily
- Go to the Control Panel, in the Task Scheduler
- "Control Panel -> System and Maintenance -> Administrative Tools (might be under "System and Maintenance")-> Task Scheduler" for Windows Vista and Windows 7
- Create a new task named "Octopus ADSI"
- Configure the task to be executed daily at 9:00 (or at any other hour, depending on your needs).
- Enter the application: "C:\program files\octopus\esi.octopus.adsireaderapp.exe"
- Configure the parameters: /login:OctopusSystem /password:OctopusPassword /protocol:LDAP /domain:MyDomain
- Replace OctopusPassword by the password of the Octopus account
- Replace MyDomain by the name of your domain
- Specify the Windows account that will be executing the task.
- Test the scheduled task by executing it immediately. The application generates a .log file in which you will fin the manual execution results; you will find it at "C:\program files\octopus\adsireader.log". You can also verify if the task has worked by looking at the users list directly in Octopus.
Note: After launching the import task, you will not only have imported the users, but also the computers and printer queues. You must disable the user accounts that do not represent real life users (generic accounts, for example) and identify the workstations that are either laptops or servers. See
Importat users/computers from Active Directory, sections 5 and 6)
If you do not want to import printer queues, add the criteria /NoPrintersDetection.